طلبات البيانات من واجهة برمجة التطبيقات

بعد إعداد مشروعك، للإعلان عن التبعيات مكتبة برامج 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());
  }
}