API İstekleri

Projenizde bağımlılıkları açıklayacak şekilde Java için Google API'leri İstemci Kitaplığı'nı kullanıyorsanız istekte bulunmak için aşağıdaki adımları uygulayın. Bu sayfadaki snippet'ler Cloud Resource Manager API'nin v3 sürümünü kullanır.

1. adım: Kimlik doğrulama

Örneklendirme com.google.auth.oauth2.GoogleCredentials örneğidir. Google Cloud kullanıcıları şunları kullanabilir: GoogleCredentials.getApplicationDefault() almak için Application Default Credentials (Uygulama Varsayılan Kimlik Bilgileri).

GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();

Kimlik doğrulama hakkında daha fazla bilgi için Google Auth Kitaplığı Java.

2. Adım: Hizmet Sınıfını Örneklendirme

Bir Google hizmetinin bir veya daha fazla sürümü vardır. Hizmet sınıfı, bir sürümü temsil eder ve şunun alt sınıfıdır: AbstractGoogleJsonClient. Örneğin: com.google.api.services.cloudresourcemanager.v3.CloudResourceManager

Hizmet sınıfının oluşturucu sınıfı 3 parametre alır:

Ayrıca uygulamanızla oluşturucunun setApplicationName() yöntemini çağırın dokunun. Bu işlem, UserAgent üstbilgisini uygulama adıyla ayarlar ve yararlıdır. bakın.

Bu kod aşağıdaki gibi görünür:

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. Adım: Kaynak Nesnesi oluşturun

Kaynak sınıfı, kaynak türünün bir türünü temsil eder. bir hizmet tarafından yönetiliyor. Sınıf, hizmet sınıfının iç sınıfı olarak tanımlanır. Bunlara erişebilirsiniz. yöntemleri kullanabilirsiniz.

Örneğin, "Projeler" raporunu CloudResourceManager kaynağı sınıf:

import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;

...

Projects projects = cloudResourceManager.projects();

4. Adım: İstek nesnesi oluşturun

Kaynak nesneye yönelik işlemler, istek sınıfları olarak gösterilir. Kullanılabilir işlemler kaynak sınıfına bağlıdır. Örneğin, bir kaynak "create", "get" ve "delete" özelliklerini sağlayan sınıf yöntem şunu içerir: "Oluştur", "Al" ve "Sil" sınıf iste.

Cloud Resource Manager örneğinde, Get isteği nesnesini aşağıdaki gibi oluşturabilirsiniz: projects.get yöntemi çağrılıyor:

Get get = projects.get("projects/your-project-id");

5. Adım: İsteği Yürütme

İstek nesnesi, isteği çalıştıran execute() yöntemine sahiptir. Bu görüşme Google hizmetine bir HTTP isteği gönderir ve JSON veri kümesini seri durumdan çıkarır yanıtı verilebilir. Örneğin, Get'in execute() yöntemi request nesnesi bir Proje nesnesi döndürür:

Project project = get.execute();
System.out.println("Project name: " + project.getDisplayName());

Özet

Bu adımları uygulayarak Google API'leri İstemci Kitaplığı'nı kullanarak Java. Burada, Kaynak Yönetici hizmeti.

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());
  }
}