Google Photos Library API の使用を開始するには、Google API Console で API を有効にし、OAuth 2.0 クライアント ID を設定して、プロジェクトを設定します。
アプリケーションが Google フォトのユーザーに代わって Google フォトとやり取りします。たとえば、ユーザーの Google フォト ライブラリでアルバムを作成する場合や、ユーザーの Google フォト アカウントにメディア アイテムをアップロードする場合、ユーザーは OAuth 2.0 プロトコルを介してこれらの API リクエストを承認します。
OAuth 2.0 クライアント ID を使用すると、アプリケーション ユーザーはログインと認証を行い、Library API を使用できます。Library API はサービス アカウントをサポートしていません。この API を使用するには、ユーザーは有効な Google アカウントにログインする必要があります。
アプリを設定する
API を有効にする
Library API を使用する前に、プロジェクトで有効にする必要があります。
- Google API Console に移動します。
- メニューバーで、プロジェクトを選択するか、新しいプロジェクトを作成します。
- Google API ライブラリを開くには、ナビゲーション メニューから [API とサービス] > [ライブラリ] を選択します。
- 「Google Photos Library API」を検索します。正しい結果を選択して、[有効にする] をクリックします。
OAuth 2.0 クライアント ID をリクエストする
OAuth クライアント ID をリクエストし、アプリケーション用に構成するには、次の手順を行います。この例では、サンプルのように、OAuth フロー全体がサーバーサイドで処理されるアプリケーションを使用します。設定プロセスは、他の実装シナリオによって異なる場合があります。
- Google API Console に移動し、プロジェクトを選択します。
- メニューから、[API とサービス] > [認証情報] を選択します。
- [認証情報] ページで、[認証情報を作成] > [OAuth クライアント ID] をクリックします。
- [アプリケーションの種類] を選択します。この例では、アプリケーションの種類はウェブ アプリケーションです。
アプリが Google API へのアクセスを許可するオリジンを次のように登録します。
- クライアント ID を識別するため、名前を入力します。
[承認済みの JavaScript 生成元] フィールドに、アプリの生成元を入力します。この項目ではワイルドカードを使用できません。
複数のオリジンを入力すると、さまざまなプロトコル、ドメイン、サブドメインでアプリを実行できます。入力した URL で OAuth リクエストを開始できます。
次の例は、ローカル開発用 URL（サンプルでは
localhost:8080を使用）と本番環境用 URL を示しています。http://localhost:8080 https://myproductionurl.example.com[承認済みのリダイレクト URI] フィールドは、OAuth 2.0 サーバーからのレスポンスを受信するエンドポイントです。通常、これには開発環境が含まれ、アプリケーション内のパスを参照します。
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback[作成] をクリックします。
-
表示される OAuth クライアント ダイアログから、次の内容をコピーします。
- クライアント ID
- クライアント シークレット
アプリは、これらの値を使用して、有効な Google API にアクセスできます。
Library API にアクセスする公開アプリをリリースする前に、Google によるアプリの審査を受ける必要があります。アプリケーションをテストする際、確認されるまで画面に「未確認アプリ」というメッセージが表示されます。
サンプルを試す
Library API を使用できるようにプロジェクトを設定したので、GitHub のサンプルアプリをご覧ください。サンプルアプリでは、Library API を使用してスマート フォトフレームを作成する方法を示します。