Java クライアントライブラリのスタートガイド

Java クライアントライブラリで Google Photos API の使用を開始するには、開発環境でクライアントライブラリを設定する必要があります。その前に、Google API Console で API を有効にし、OAuth 2.0 クライアント ID を設定してプロジェクトを設定します。

アプリは、ユーザーの代わりに Google フォトとやり取りします。 Google フォトのユーザー。たとえば、ユーザーのフォルダ内にアルバムを作成するとメディアアイテムをユーザーの使用している場合、ユーザーは OAuth 2.0 プロトコル。

OAuth 2.0 クライアント ID を使用すると、アプリケーションユーザーが、ログイン、認証、 Photos API を使用する方法について説明します。Photos API はサービスアカウントをサポートしていません。この API を使用するには、ユーザーは有効な Google アカウントにログインしている必要があります。

アプリを設定する

API を有効にする

Photos API を使用するには、プロジェクトでこの機能を有効にする必要があります。

Google API コンソールに移動します。
メニューバーで、プロジェクトを選択するか、新しいプロジェクトを作成します。
Google API ライブラリを開くには、ナビゲーションメニューで API とサービス >Library にあります。
「Google Photos APIs」を検索します。正しい結果を選択してクリックしてください 有効にする。

OAuth 2.0 クライアント ID をリクエストする

以下の手順に沿って OAuth クライアント ID をリクエストし、説明します。この例では、OAuth フロー全体がサーバーサイドで処理されます。設定プロセスは実装シナリオによって異なる場合があります。

Google API Console に移動します。プロジェクトを選択します
メニューから [API とサービス >認証情報。
[認証情報] ページで、[認証情報を作成] > [OAuth クライアント ID] をクリックします。
アプリケーションの種類を選択します。この例では、アプリケーションの種類は [ウェブアプリケーション] です。
アプリに Google API へのアクセスを許可するオリジンを登録します。次のとおりです。
1. クライアント ID を識別するには、名前を入力します。
2. [承認済み JavaScript 生成元] に、アプリの生成元を入力します。このフィールドではワイルドカードは使用できません。
  
  複数のオリジンを入力すると、さまざまなオリジンでアプリを実行できるようになります。プロトコル、ドメイン、サブドメインです。入力する URL で OAuth リクエストを開始できます。
  
  次の例は、ローカルの開発用 URL を示しています（このサンプルでは、 localhost:8080）と本番環境の URL です。
```
http://localhost:8080
https://myproductionurl.example.com
```
3. [承認済みのリダイレクト URI] フィールドは、リクエストを受信するエンドポイントです。 OAuth 2.0 サーバーから返されます。通常、これにはアプリケーションのパスを指します。
```
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
```
4. [作成] をクリックします。

表示される OAuth クライアントダイアログから、クライアント設定を含む JSON ファイルをダウンロードします。クライアントの詳細は次のとおりです。
- クライアント ID
- クライアントシークレット
この JSON ファイルは、このクライアントライブラリと連携する Java 用 Google 認証ライブラリを設定するために後で使用されます。

Photos API にアクセスする公開アプリをリリースする前に、 Google による審査を受ける必要があります。アプリケーションが確認されるまで、テストを行う際に「未確認のアプリ」であることを示すメッセージが画面に表示されます。

クライアントライブラリを設定する

Java クライアントライブラリは、すべてのバックエンド API 呼び出しを処理します。また、連携しやすいオブジェクトを公開します（一般的な API タスクのコードサンプルを含む）。まず、Java 用 Google Photos API クライアントライブラリを GitHub にある依存関係を使用します。次に、Java の OAuth2 認証情報を設定します。

ダウンロードオプション

クライアントライブラリをダウンロードするには、以下のような方法があります。

Gradle 依存関係:

Gradle でこのライブラリを使用するには、次の依存関係を build.gradle ファイル。

repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}

Maven 依存関係:

Maven でこのライブラリを使用するには、Maven の pom.xml ファイルに次の内容を追加します。

<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>

リリースをダウンロードする:

リリースページには、ライブラリリリースごとに異なるアーティファクトが含まれます（jar ファイルなど）。
リポジトリのクローンを作成します。

このライブラリを変更または編集して、 pull リクエストを送信するか、サンプルを試してみることができます。ユーザーがリポジトリのクローンを作成すると、このリポジトリ内のすべてのファイルがダウンロードされます。
1. コマンドプロンプトで git clone https://github.com/google/java-photoslibrary.git を実行します。
2. java-photoslibrary ディレクトリが作成されます。cd java-photoslibrary を実行して移動します。
3. IDE で build.gradle ファイルを開くか、次の場所で ./gradlew assemble を実行します。プロジェクトをビルドします。詳細: ./gradlew tasks できます。

Java の OAuth2 認証情報を設定する

このクライアントライブラリは、Google 認証ライブラリ Java です。詳細については、Java 用 Google API クライアントライブラリでの OAuth 2.0 の使用をご覧ください。

次の場合は、CredentialsProvider でクライアントの OAuth 構成を指定します。 PhotosLibraryClient オブジェクトの PhotoLibrarySettings を作成します。

サンプルを試す

Java クライアントライブラリを使用して最初の API 呼び出しを行うには、以下のコードを試してください。

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

その他のサンプル GitHub で公開しています。

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