طلبات البيانات من واجهة برمجة التطبيقات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بعد إعداد مشروعك، للإعلان عن التبعيات
مكتبة برامج Google APIs للغة Java، يُرجى اتّباع الخطوات التالية لتقديم طلب.
تستخدم المقتطفات في هذه الصفحة الإصدار الثالث من Cloud Resource Manager API.
الخطوة 1: المصادقة
إنشاء مثيل
com.google.auth.oauth2.GoogleCredentials
مثال. بالنسبة إلى مستخدمي Google Cloud، يمكنك استخدام
GoogleCredentials.getApplicationDefault()
للحصول على
بيانات الاعتماد التلقائية للتطبيق.
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
لمزيد من المعلومات حول المصادقة، يُرجى الرجوع إلى
مكتبة مصادقة Google في Java
الخطوة 2: إنشاء مثيل فئة الخدمة
تمتلك إحدى خدمات Google إصدارًا واحدًا أو أكثر. تمثّل فئة الخدمة إصدارًا
للخدمة، وهي فئة فرعية من
AbstractGoogleJsonClient:
على سبيل المثال:
com.google.api.services.cloudresourcemanager.v3.CloudResourceManager
تأخذ فئة أداة الإنشاء لفئة الخدمة 3 معلمات:
يمكنك أيضًا استدعاء طريقة setApplicationName() لأداة الإنشاء مع تطبيقك.
الاسم. يؤدي ذلك إلى ضبط عنوان UserAgent (وكيل المستخدم) مع اسم التطبيق، ويكون مفيدًا
لاستكشاف الأخطاء وإصلاحها باستخدام السجلات.
يبدو الرمز كما يلي:
HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
JsonFactory jsonFactory = GsonFactory.getDefaultInstance();
CloudResourceManager.Builder resourceManagerBuilder =
new CloudResourceManager.Builder(
transport, jsonFactory, new HttpCredentialsAdapter(credentials))
.setApplicationName("Example Java App");
CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();
الخطوة 3: إنشاء كائن مورد
تمثل فئة الموارد نوعًا من المورد
وتديره خدمة ما.
وتُعرّف الفئة بأنها فئة داخلية لفئة الخدمة. يمكنك الوصول إلى هذه الميزات
باستخدام الطرق الموجودة في فئة الخدمة.
على سبيل المثال، يمكنك الحصول على زر "المشروعات" مرجع CloudResourceManager
الفئة:
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;
...
Projects projects = cloudResourceManager.projects();
الخطوة 4: إنشاء كائن طلب
يتم تمثيل العمليات التي تجري على كائن المورد كفئات طلبات.
تعتمد العمليات المتاحة على فئة الموارد. على سبيل المثال، قد يستخدم مورد
فئة توفّر "إنشاء" و"الحصول على" و"حذف" طرق تحتوي على
"إنشاء" و"الحصول" و"حذف" طلب الفئات على التوالي.
على سبيل المثال، Cloud Resource Manager، يمكنك إنشاء كائن "الحصول على الطلب" من خلال
طريقة استدعاء projects.get:
Get get = projects.get("projects/your-project-id");
الخطوة 5: تنفيذ الطلب
يستخدم كائن الطلب الطريقة execute() التي تشغِّل الطلب. هذه المكالمة
ينفذ طلب HTTP إلى خدمة Google ويلغي تسلسل JSON
الاستجابة لفئة نموذج. على سبيل المثال، تُستخدم طريقة execute() في
يعرض كائن الطلب كائن المشروع:
Project project = get.execute();
System.out.println("Project name: " + project.getDisplayName());
ملخّص
باستخدام هذه الخطوات، يمكنك تقديم طلبات باستخدام مكتبة برامج Google APIs للموقع الإلكتروني
جافا. في ما يلي مقتطف الرمز الذي يجمع كل الخطوات باستخدام المرجع
خدمة المدير.
package com.example;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects.Get;
import com.google.api.services.cloudresourcemanager.v3.model.Project;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
public class ResourceManagerSample {
public static void main(String[] arguments) throws Exception {
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
JsonFactory jsonFactory = GsonFactory.getDefaultInstance();
CloudResourceManager.Builder resourceManagerBuilder =
new CloudResourceManager.Builder(
transport, jsonFactory, new HttpCredentialsAdapter(credentials))
.setApplicationName("Example Java App");
CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();
Projects projects = cloudResourceManager.projects();
Get get = projects.get("projects/your-project-id");
Project project = get.execute();
System.out.println("Project display name: " + project.getDisplayName());
}
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide provides a step-by-step approach to making requests to Google APIs using the Google APIs Client Library for Java, covering authentication, service instantiation, resource object creation, request object creation, and request execution.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers will learn how to authenticate using GoogleCredentials, instantiate service classes to interact with specific Google APIs, and create resource objects to access specific API resources.\u003c/p\u003e\n"],["\u003cp\u003eYou'll be able to utilize request objects to perform operations on resources, with a working example demonstrating the process using the Cloud Resource Manager service to retrieve project details.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code examples allow developers to easily adapt the steps for their own applications and make API requests efficiently.\u003c/p\u003e\n"]]],[],null,["# API Requests\n\nOnce you set up your project to [declare the dependencies](/api-client-library/java/google-api-java-client/setup) for your\nGoogle APIs Client Library for Java, follow these steps to make a request.\nThe snippets in this page uses v3 of the Cloud Resource Manager API.\n\nStep 1: Authentication\n----------------------\n\nInstantiate\n[`com.google.auth.oauth2.GoogleCredentials`](https://cloud.google.com/java/docs/reference/google-auth-library/latest/com.google.auth.oauth2.GoogleCredentials)\ninstance. For Google Cloud users, you may use\n[`GoogleCredentials.getApplicationDefault()`](https://cloud.google.com/java/docs/reference/google-auth-library/latest/com.google.auth.oauth2.GoogleCredentials#com_google_auth_oauth2_GoogleCredentials_getApplicationDefault__)\nto get the\n[Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc). \n\n GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();\n\nFor more information on authentication, refer to\n[Google Auth Library Java](https://github.com/googleapis/google-auth-library-java?tab=readme-ov-file#using-credentials-with-google-http-client).\n\nStep 2: Instantiate Service Class\n---------------------------------\n\nA Google service has one or more versions. A service class represents a version\nof a service and is a child class of\n[AbstractGoogleJsonClient](https://cloud.google.com/java/docs/reference/google-api-client/latest/com.google.api.client.googleapis.services.json.AbstractGoogleJsonClient).\nFor example\n`com.google.api.services.cloudresourcemanager.v3.CloudResourceManager`.\n\nThe builder class of the service class takes 3 parameters:\n\n- [`com.google.api.client.http.HttpTransport`](https://cloud.google.com/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpTransport). [`GoogleNetHttpTransport.newTrustedTransport()`](https://cloud.google.com/java/docs/reference/google-api-client/latest/com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#com_google_api_client_googleapis_javanet_GoogleNetHttpTransport_newTrustedTransport__) creates an instance of it.\n- [`com.google.api.client.json.JsonFactory`](https://cloud.google.com/java/docs/reference/google-http-client/latest/com.google.api.client.json.JsonFactory). [`GsonFactory.getDefaultInstance()`](https://cloud.google.com/java/docs/reference/google-http-client/latest/com.google.api.client.json.gson.GsonFactory#com_google_api_client_json_gson_GsonFactory_getDefaultInstance__) creates an instance of it.\n- [`com.google.api.client.http.HttpRequestInitializer`](https://cloud.google.com/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpRequestInitializer). [`new HttpCredentialsAdapter(credentials)`](https://cloud.google.com/java/docs/reference/google-auth-library/latest/com.google.auth.http.HttpCredentialsAdapter) gives an instance of it.\n\nAlso call `setApplicationName()` method of the builder with your application\nname. This sets the UserAgent header with the application name and is helpful\nfor troubleshooting with logs.\n\nThe code looks like: \n\n HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();\n JsonFactory jsonFactory = GsonFactory.getDefaultInstance();\n CloudResourceManager.Builder resourceManagerBuilder =\n new CloudResourceManager.Builder(\n transport, jsonFactory, new HttpCredentialsAdapter(credentials))\n .setApplicationName(\"Example Java App\");\n CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();\n\nStep 3: Create a Resource Object\n--------------------------------\n\nA resource class represents a type of [the resource](https://cloud.google.com/apis/design/resources)\nmanaged by a service.\nThe class is defined as an inner class of the service class. You can access them\nusing the methods in the service class.\n\nFor example, you can get the \"Projects\" resource of the CloudResourceManager\nclass: \n\n import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;\n\n ...\n\n Projects projects = cloudResourceManager.projects();\n\nStep 4: Make a Request Object\n-----------------------------\n\nThe operations against the resource object are represented as request classes.\nThe available operations depend on the resource class. For example, a resource\nclass that provides \"create\", \"get\", and \"delete\" methods contain\n\"Create\", \"Get\", and \"Delete\" request classes respectively.\n\nFor Cloud Resource Manager's example, you can make the Get request object by\ncalling `projects.get` method: \n\n Get get = projects.get(\"projects/your-project-id\");\n\nStep 5: Execute the Request\n---------------------------\n\nA request object has the `execute()` method that runs the request. This call\nexecutes an HTTP request to the Google service and deserializes the JSON\nresponse to a model class. For example, the `execute()` method of the Get\nrequest object returns a Project object: \n\n Project project = get.execute();\n System.out.println(\"Project name: \" + project.getDisplayName());\n\nSummary\n-------\n\nWith these steps, you can make requests using Google APIs Client Library for\nJava. Here is the code snippet that combines all the steps using the Resource\nManager service. \n\n package com.example;\n\n import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;\n import com.google.api.client.http.HttpTransport;\n import com.google.api.client.json.JsonFactory;\n import com.google.api.client.json.gson.GsonFactory;\n import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager;\n import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;\n import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects.Get;\n import com.google.api.services.cloudresourcemanager.v3.model.Project;\n import com.google.auth.http.HttpCredentialsAdapter;\n import com.google.auth.oauth2.GoogleCredentials;\n\n public class ResourceManagerSample {\n public static void main(String[] arguments) throws Exception {\n GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();\n\n HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();\n JsonFactory jsonFactory = GsonFactory.getDefaultInstance();\n CloudResourceManager.Builder resourceManagerBuilder =\n new CloudResourceManager.Builder(\n transport, jsonFactory, new HttpCredentialsAdapter(credentials))\n .setApplicationName(\"Example Java App\");\n CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();\n\n Projects projects = cloudResourceManager.projects();\n\n Get get = projects.get(\"projects/your-project-id\");\n\n Project project = get.execute();\n System.out.println(\"Project display name: \" + project.getDisplayName());\n }\n }"]]
