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

PHP クライアントライブラリで 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 ファイルは、後で設定に使用します。このクライアントライブラリと連携する PHP 用 Google 認証ライブラリ。

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

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

PHP クライアントライブラリがすべてのバックエンド API 呼び出しを処理し、一般的な API タスクのコードサンプルを含む、操作しやすいオブジェクトを紹介します。まず、PHP 用の Google Photos Library API クライアントライブラリをダウンロードしてインストールし、 GitHub にある依存関係をご覧ください。次に、PHP の OAuth2 認証情報を設定します。

ダウンロードオプション

composer を使用するを使用して、開発環境に依存関係としてライブラリを組み込む必要があります。次のコマンドを実行します。次のコマンドを実行して、ライブラリをプロジェクト構成に追加し、 vendor/ ディレクトリに移動します。

composer require google/photos-library

別の方法として、クローンを作成し、リポジトリまたは圧縮ファイルをダウンロードして tarball を使用します。

PHP の OAuth2 認証情報を設定する

このクライアントライブラリは Google 認証ライブラリ PHP。詳しくは詳しくは、Using OAuth 2.0 with the Google API Client Library for PHP。

設定時に認証ライブラリから返された認証情報を使用する PhotosLibraryClient。

サンプルを試す

次のコードを試して、PHP クライアントライブラリを使用して最初の API 呼び出しを行います。

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

その他サンプル（GitHub）試してみましょう。

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