OAuth デスクトップおよびウェブ アプリケーションのフロー

警告: 2024 年 3 月 31 日より、PHP 用 Google Ads API クライアント ライブラリでは、バージョン 8.1 より前の PHP はサポートされなくなります。シームレスなオペレーションのため、この日までに PHP のバージョンをアップグレードすることを強くおすすめします。

このガイドでは、独自の認証情報とデスクトップ フローまたはウェブフローを使用して、API アクセスに OAuth2 を設定する方法について説明します。この手順は、OAuth2 認証情報の許可されたスコープを取り消すか削除するか、または変更する必要がある場合を除き、1 回だけ行います。

OAuth2 認証情報を作成する

1. 手順に沿って Google Ads API の Google API Console プロジェクトを設定します。

2. クライアント ID とシークレットをメモしてから、このページに戻ります。

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

1. ターミナルで GenerateUserCredentials の例を実行します。これにより、OAuth2 クライアント ID とシークレットの入力を求められます。

   これはインタラクティブな例であり、入力が必要になります。

   php GenerateUserCredentials.php
   

2. この例の URL にアクセスすると、OAuth2 認証情報を使って Google 広告アカウントへのアクセスを許可する必要があります。

   Paste this URL in your browser:
   https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
   

   ブラウザのシークレット セッションまたはシークレット ウィンドウで、該当する URL に移動します。 Google 広告へのログインに使用している Google アカウントでログインします。OAuth2 同意画面で [続行] をクリックします。

   

3. 承認が成功したことを示すメッセージが表示されます。

   更新トークンを取得しました。詳しい手順については、コンソールの出力をご覧ください。

4. 例を実行していたコンソールに戻ります。サンプルを完了し、更新トークンといくつかの手順が表示されているはずです。その後、クライアント ライブラリを設定するために必要なプロパティが続きます。

   Your refresh token is: 1/Yw**********
   Copy the text below into a file named "google_ads_php.ini" in your home directory, and replace "INSERT_DEVELOPER_TOKEN_HERE" with your developer token:
   
   [GOOGLE_ADS]
   developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
   [OAUTH2]
   Copy the following lines to your 'google_ads_php.ini' file:
   clientId = "***********************apps.googleusercontent.com"
   clientSecret = "****"
   refreshToken = "****"