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

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

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

OAuth 2.0 クライアント ID を使用すると、アプリケーションユーザーがログイン、認証、 Library API を使用しますLibrary API は、サービスアカウントユーザーがこの API を使用するには、有効な Google 。

アプリを設定する

API を有効にする

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

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

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

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

Google API Console に移動します。プロジェクトを選択します
メニューから [API とサービス >認証情報。
[認証情報] ページで、[認証情報を作成 >OAuth クライアント ID。
アプリケーションの種類を選択します。この例でのアプリケーションの種類は ウェブアプリケーション。
アプリに Google API へのアクセスを許可するオリジンを登録します。次のとおりです。
1. クライアント ID を識別するには、名前を入力します。
2. [承認済みの JavaScript 生成元] フィールドに、。このフィールドではワイルドカードを使用できません。
  
  複数のオリジンを入力すると、さまざまなオリジンでアプリを実行できるようになります。プロトコル、ドメイン、サブドメインです。入力する URL は、開始できます。
  
  次の例は、ローカルの開発用 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 認証ライブラリ。

Library API にアクセスする公開アプリをリリースする前に、 Google による審査を受ける必要があります。「未確認のアプリ」というメッセージがアプリケーションのテスト中に、確認済み。

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

Java クライアントライブラリは、すべてのバックエンド API 呼び出しを処理し、一般的な API タスクのコードサンプルを含む、操作しやすいオブジェクトを紹介します。まず、Java 用 Google Photos Library 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 です。詳しくは詳しくは、Using OAuth 2.0 with the Google API Client Library for Java です。

次の場合は、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 クライアント ライブラリのスタートガイド コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。