アプリを設定する

Google Photos API の使用を開始するには、Google API Console で必要な Photos API を有効にし、OAuth 2.0 クライアント ID を設定してプロジェクトを設定します。

Google フォト ユーザーに代わってアプリケーションが Google フォトとやり取りします。たとえば、ユーザーの Google フォト ライブラリにアルバムを作成したり、ユーザーの Google フォト アカウントにメディア アイテムをアップロードしたりする際、ユーザーは OAuth 2.0 プロトコルを使用してこれらの API リクエストを承認します。

OAuth 2.0 クライアント ID を使用すると、アプリケーション ユーザーは、ログインして Photos API を使用できます。Photos API はサービス アカウントに対応していません。これらの API を使用するには、ユーザーは有効な Google アカウントにログインする必要があります。

アプリを設定する

まず API を有効にしてから、OAuth 2.0 クライアント ID をリクエストします。

API を有効にする

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

  1. Google API コンソールに移動します。
  2. メニューバーで、プロジェクトを選択するか、新しいプロジェクトを作成します。
  3. Google フォトの API のいずれかを開くには、ナビゲーション メニューから [API とサービス] > [ライブラリ] を選択します。
  4. 「フォト」を検索します。1 つ以上の Photos API を選択し、[有効にする] をクリックします。

Google Cloud コンソールの Picker API のスクリーンショット

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

OAuth クライアント ID をリクエストし、アプリケーション用に構成する手順は次のとおりです。この例では、サンプルのアプリケーションのように、OAuth のフロー全体がサーバーサイドで処理されるアプリケーションを使用します。設定プロセスは実装シナリオによって異なる場合があります。

  1. Google API Console に移動し、プロジェクトを選択します。
  2. メニューから [API とサービス] > [認証情報] を選択します。

  3. [認証情報] ページで、[認証情報を作成] > [OAuth クライアント ID] をクリックします。

  4. アプリケーションの種類を選択します。この例では、アプリケーションの種類はウェブ アプリケーションです。

  5. 次のように、アプリに Google API へのアクセスを許可するオリジンを登録します。

    1. クライアント ID を識別するために、名前を入力します。
    2. [承認済みの JavaScript 生成元] フィールドに、アプリの生成元を入力します。このフィールドではワイルドカードを使用できません。

    複数の生成元を入力すると、アプリをさまざまなプロトコル、ドメイン、サブドメインで実行できるようになります。入力した URL で OAuth リクエストを開始できます。

    次の例は、ローカルの開発用 URL（サンプルでは localhost:8080 を使用）と本番用 URL を示しています。

        http://localhost:8080
    https://myproductionurl.example.com
    ```

1.  The **Authorized redirect URI** field is the endpoint that receives
    responses from the OAuth 2.0 server. Typically, this includes your
    development environment and points to a path in your application.

```none
    http://localhost:8080/auth/google/callback
    https://myproductionurl.example.com/auth/google/callback
    ```

1.  Click **Create**.

  1. 表示される OAuth クライアント ダイアログから、次の内容をコピーします。

    • クライアント ID
    • クライアント シークレット

    アプリはこれらの値を使用して、有効化された Google API にアクセスできます。

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

アプリを構成したら、次は使用を開始できます。

クライアント ID を変更する

Google フォト API を使用して作成されたリソースにアクセスまたは変更できるのは、作成に使用した元のクライアント ID を使用した場合のみです。たとえば、特定のクライアント ID を使用して Picker API で「セッション」を作成し、その後アプリでそのクライアント ID を変更すると、アプリは以前のクライアント ID で作成された API リソースにアクセスできなくなります。

使用している Photos API に適したクライアント ID タイプを慎重に選択してください。アクセスの問題を回避するために、どうしても必要な場合にのみクライアント ID を変更してください。