従来版の Search Ads 360 Reporting API は、2024 年 6 月 30 日に廃止され、廃止されます。なお、Search Ads 360 Conversion API は影響を受けず、引き続きサポートされます。新しいレポートの作成には、必ず新しい Search Ads 360 Reporting API を使用してください。

2024 年 4 月以降、レポートをリクエストすると、unsupportedApiVersion エラーが返されます。詳しくはこちらをご覧ください。

また、既存の検索広告 360 の実装を新しい API に移行することを強くおすすめします。詳しくは、新しい Search Ads 360 Reporting API のスタートガイドと移行ガイドをご覧ください。

このページは Cloud Translation API によって翻訳されました。

認可を設定する

Search Ads 360 API では、認証に使用するすべてのリクエストで OAuth 2.0 アクセストークンを指定する必要があります。任意の標準の OAuth 2.0 認証ワークフローに沿ってトークンを生成し、検索広告 360 API に渡すことができます。以下で説明するワークフローは、完全に自動化されたコンバージョンアップロードやレポートのダウンロードに適しているため、おすすめします。

以下で説明するワークフローの代わりに、インストール済みアプリケーションで OAuth 2.0 を使用するまたはサーバー間アプリケーションでの OAuth 2.0 の使用をご覧ください。代替ワークフローを使用する場合は、OAuth 2.0 認証コードをリクエストするときに scope パラメータとして次の値を指定します。
https://www.googleapis.com/auth/doubleclicksearch
サーバー間のルートをたどる場合は、サービスアカウントを検索広告 360 ユーザーとして追加します。

推奨される承認ワークフロー

Google API Console に移動し、プロジェクトを選択します。
Google API Console プロジェクトと OAuth 認証情報をまだ作成していない場合は、クライアント用の Google API Console プロジェクトと OAuth 認証情報を作成するの手順を行います。

プロジェクトの OAuth クライアント ID とシークレットを確認するには、次の手順を行います。
1. [認証情報] ページを開きます。
2. [名前] 列で、OAuth クライアントの名前をクリックします。
3. クライアント ID とシークレットがページに一覧表示されます。
ウェブブラウザを開き、検索広告 360 内のデータへのアクセス権がある Google アカウントで Google にログインします。
これは、API クライアントが検索広告 360 の認証に使用する Google アカウントです。 Google アカウント所有者が退職し、検索広告 360 のアクセス権をアカウントから削除する場合は、この承認ワークフローを繰り返し、別の Google アカウントを指定する必要があります。
次のように検索広告 360 ユーティリティスクリプトを呼び出して、更新トークンを取得します。
sa360Api.py --login

スクリプトは、OAuth クライアント ID とシークレットを使用して更新トークンを取得するプロセスについて説明します。更新トークンは、前の手順でログインした Google アカウントでのみ有効です。
このプロセスでスクリプトは URL を生成し、ウェブブラウザで URL にアクセスするよう指示します。
OAuth クライアントに検索広告 360 のデータへのアクセスを許可するように求められたら、前にログインした Google アカウントが表示されていることを確認します。（複数の Google アカウントにログインしている場合は、別のアカウントが表示されることがあります。）。

プロセスの最後に、sa360Api.py スクリプトがカンマ区切りの文字列を出力します。最初の値は指定したクライアント ID で、2 番目の値は指定したクライアントシークレットです。3 番目の値は更新トークンです。次の出力例では、更新トークンが太字で示されています。
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
クライアント ID、クライアントシークレット、更新トークンを、アプリケーションがアクセスできるバックエンドデータベースまたはその他の安全な場所に保存します。
sa360Api.py を使用してサンプル JSON リクエストを Search Ads 360 API に送信する場合は、カンマ区切りの文字列全体をわかりやすい場所に保管してください。スクリプトを呼び出すたびに、文字列全体をパラメータとして渡します。
以下の処理を行うコードをアプリに追加します。
1. クライアント ID、クライアントシークレット、更新トークンを使用して新しい OAuth 2.0 アクセストークンを取得します。
2. 新しいアクセストークンを使用して Search Ads 360 API にリクエストを送信します。
クライアントライブラリを使用している場合は、次のセクションのアプリケーションを設定するで、この認証コードをアプリケーションに追加する方法を確認してください。

いずれかのクライアントライブラリを使用していない場合は、インストール済みのアプリケーションに OAuth 2.0 を使用するを参照して、新しいアクセストークンを取得してください。