Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Java クイックスタート

People API にリクエストを行う Java コマンドラインアプリケーションを作成します。

クイックスタートでは、Google Workspace API を呼び出すアプリを設定して実行する方法について説明します。このクイックスタートでは、テスト環境に適した簡略化された認証方法を使用します。本番環境では、アプリに適したアクセス認証情報を選択する前に、認証と認可について学習することをおすすめします。

このクイックスタートでは、Google Workspace の推奨 API クライアントライブラリを使用して、認証と認可フローの詳細を処理します。

目標

環境をセットアップする。
サンプルをセットアップする。
サンプルを実行する。

前提条件

API アクセスが有効になっている Google Workspace ドメイン。
管理者権限を持つ、そのドメイン内の Google アカウント。

環境をセットアップする

このクイックスタートを完了するには、環境をセットアップします。

API を有効にする

Google API を使用する前に、Google Cloud プロジェクトで API を有効にする必要があります。1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。

Google Cloud コンソールで、People API を有効にします。

API を有効にする

OAuth 同意画面を構成する

このクイックスタートを完了するために新しい Google Cloud プロジェクトを使用している場合は、OAuth 同意画面を構成します。Cloud プロジェクトでこの手順をすでに完了している場合は、次のセクションに進みます。

Google API Console で、メニュー > [Google Auth Platform] > [Branding] に移動します。
[Branding] に移動
Google Auth Platform をすでに構成している場合は、[Branding]、[Audience]、および [Data Access] で次の OAuth 同意画面の設定を構成できます。[**Google Auth Platform はまだ構成されていません**] というメッセージが表示されたら、[**Get Started**] をクリックします。

[App Information] の [App name] に、アプリの名前を入力します。
[User support email] で、ユーザーが同意について問い合わせる際に使用するサポートのメールアドレスを選択します。
[Next] をクリックします。
[Audience] で [Internal] を選択します。
[Next] をクリックします。
[Contact Information] の [Email address] に、プロジェクトに対する変更の通知を受け取るメールアドレスを入力します。
[Next] をクリックします。
[Finish] で、Google API サービスのユーザーデータに関するポリシーを確認し、同意する場合は [I agree to the Google API Services: User Data Policy] を選択します。
[Continue] をクリックします。
[Create] をクリックします。

現時点では、スコープの追加はスキップできます。 今後、Google Workspace 組織外で使用するアプリを作成する場合は、 [User type] を [External] に変更する必要があります。次に、アプリに必要な認可スコープを追加します。詳細については、 OAuth 同意画面を構成するをご覧ください。

デスクトップアプリケーションの認証情報を認可する

エンドユーザーを認証してアプリ内のユーザーデータにアクセスするには、1 つ以上の OAuth 2.0 クライアント ID を作成する必要があります。クライアント ID は、Google の OAuth サーバーで個々のアプリを識別するために使用します。アプリが複数のプラットフォームで実行される場合は、プラットフォームごとに個別のクライアント ID を作成する必要があります。

Google API Console で、メニュー > [Google Auth Platform] > [Clients] に移動します。
[Clients] に移動
[Create Client] をクリックします。
[Application type] > [Desktop app] をクリックします。
[Name] フィールドに、認証情報の名前を入力します。この名前は Google API Console にのみ表示されます。
[Create] をクリックします。
新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。
ダウンロードした JSON ファイルを credentials.json として保存し、ファイルを作業ディレクトリに移動します。

職場環境を整える

作業ディレクトリに、新しいプロジェクト構造を作成します。
```
gradle init --type basic
mkdir -p src/main/java src/main/resources 
```
src/main/resources/ ディレクトリに、以前にダウンロードした credentials.json ファイルをコピーします。
デフォルトの build.gradle ファイルを開き、その内容を次のコードに置き換えます。

people/quickstart/build.gradle

GitHub で表示
```
apply plugin: 'java'
apply plugin: 'application'

mainClassName = 'PeopleQuickstart'
sourceCompatibility = 11
targetCompatibility = 11

version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.api-client:google-api-client:2.0.0'
    implementation 'com.google.oauth-client:google-oauth-client-jetty:1.34.1'
    implementation 'com.google.apis:google-api-services-people:v1-rev20220531-2.0.0'
}
```

サンプルのセットアップ

src/main/java/ ディレクトリに、build.gradle ファイルの mainClassName 値と一致する名前の新しい Java ファイルを作成します。

新しい Java ファイルに次のコードを追加します。

people/quickstart/src/main/java/PeopleQuickstart.java

GitHub で表示

import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.people.v1.PeopleService;
import com.google.api.services.people.v1.PeopleServiceScopes;
import com.google.api.services.people.v1.model.ListConnectionsResponse;
import com.google.api.services.people.v1.model.Name;
import com.google.api.services.people.v1.model.Person;

import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.security.GeneralSecurityException;
import java.util.Arrays;
import java.util.List;

public class PeopleQuickstart {
  private static final String APPLICATION_NAME = "Google People API Java Quickstart";
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
  private static final String TOKENS_DIRECTORY_PATH = "tokens";

  /**
   * Global instance of the scopes required by this quickstart.
   * If modifying these scopes, delete your previously saved tokens/ folder.
   */
  private static final List<String> SCOPES = Arrays.asList(PeopleServiceScopes.CONTACTS_READONLY);
  private static final String CREDENTIALS_FILE_PATH = "/credentials.json";

  /**
   * Creates an authorized Credential object.
   *
   * @param HTTP_TRANSPORT The network HTTP Transport.
   * @return An authorized Credential object.
   * @throws IOException If the credentials.json file cannot be found.
   */
  private static Credential getCredentials(final NetHttpTransport HTTP_TRANSPORT)
      throws IOException {
    // Load client secrets.
    InputStream in = PeopleQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
    if (in == null) {
      throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
    }
    GoogleClientSecrets clientSecrets =
        GoogleClientSecrets.load(JSON_FACTORY, new InputStreamReader(in));

    // Build flow and trigger user authorization request.
    GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
        HTTP_TRANSPORT, JSON_FACTORY, clientSecrets, SCOPES)
        .setDataStoreFactory(new FileDataStoreFactory(new java.io.File(TOKENS_DIRECTORY_PATH)))
        .setAccessType("offline")
        .build();
    LocalServerReceiver receiver = new LocalServerReceiver.Builder().setPort(8888).build();
    return new AuthorizationCodeInstalledApp(flow, receiver).authorize("user");
  }

  public static void main(String... args) throws IOException, GeneralSecurityException {
    // Build a new authorized API client service.
    final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
    PeopleService service =
        new PeopleService.Builder(HTTP_TRANSPORT, JSON_FACTORY, getCredentials(HTTP_TRANSPORT))
            .setApplicationName(APPLICATION_NAME)
            .build();

    // Request 10 connections.
    ListConnectionsResponse response = service.people().connections()
        .list("people/me")
        .setPageSize(10)
        .setPersonFields("names,emailAddresses")
        .execute();

    // Print display name of connections if available.
    List<Person> connections = response.getConnections();
    if (connections != null && connections.size() > 0) {
      for (Person person : connections) {
        List<Name> names = person.getNames();
        if (names != null && names.size() > 0) {
          System.out.println("Name: " + person.getNames().get(0)
              .getDisplayName());
        } else {
          System.out.println("No names available for connection.");
        }
      }
    } else {
      System.out.println("No connections found.");
    }
  }
}

サンプルの実行

サンプルを実行する
```
gradle run
```

サンプルを初めて実行すると、アクセス権の承認を求めるメッセージが表示されます。
1. Google アカウントにまだログインしていない場合は、ログインを求められたらログインします。複数のアカウントにログインしている場合は、承認に使用するアカウントを 1 つ選択します。
2. [Accept] をクリックします。
Java アプリケーションが実行され、People API が呼び出されます。

認可情報はファイルシステムに保存されるため、次回サンプルコードを実行するときに認可を求められることはありません。

Java クイックスタート コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

目標