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 とサービス] > [ライブラリ] を選択します。
- [写真] を検索します。フォト API を 1 つ以上選択し、[有効にする] をクリックします。
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 でのみ行うことができます。たとえば、Picker API で特定のクライアント ID を使用して「セッション」を作成し、後でアプリでそのクライアント ID を変更すると、アプリは以前のクライアント ID で作成された API リソースにアクセスできなくなります。
使用している Photos API に適したクライアント ID タイプを慎重に選択してください。アクセスに関する問題を回避するために、絶対に必要な場合にのみクライアント ID を変更してください。