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 を使用するには、プロジェクトで有効にする必要があります。
- Google API コンソールに移動します。
- メニューバーで、プロジェクトを選択するか新しいプロジェクトを作成します。
- Google フォト API を開くには、ナビゲーション メニューで [API とサービス] > [ライブラリ] を選択します。
- 「フォト」を検索します。1 つ以上の Photos 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 にアクセスできます。
Photos API にアクセスする公開アプリをリリースする前に、Google によるアプリの審査を受ける必要があります。アプリケーションが確認されるまで、テストを行う際に「未確認のアプリ」であることを示すメッセージが画面に表示されます。
アプリを構成したら、次の手順で開始できます。
クライアント ID の変更
Google Photos API を使用して作成されたリソースへのアクセスや変更は、作成に使用された元のクライアント ID でのみ行うことができます。たとえば、特定のクライアント ID を使用して Picker API で「セッション」を作成し、その後アプリでそのクライアント ID を変更すると、アプリは以前のクライアント ID で作成された API リソースにアクセスできなくなります。
慎重に計画し、使用する Photos API に適したクライアント ID タイプを選択してください。アクセスの問題を回避するために、どうしても必要な場合にのみクライアント ID を変更してください。