Google 広告スクリプトの高度な API を使用すると、HTTP インターフェースを使用する場合よりも少ない設定で、特定の公開 Google API に接続できます。これらの API は、スクリプトの組み込みサービスと同様に使用でき、オートコンプリートや自動承認などの便利な機能も提供されます。
これらの API の使用方法を示す例については、コード スニペットのページをご覧ください。
利用可能な拡張 API
- Google アナリティクス
- 注: [Advanced APIs] ダイアログの
Analytics拡張 API は、廃止されたユニバーサル アナリティクス v3 API をターゲットとしているため、リクエストは失敗します。Google 広告スクリプトは、Google アナリティクス 4 のAnalyticsDataまたはAnalyticsAdminの高度なサービスをサポートしていません。スクリプトから Google アナリティクス 4 のデータをクエリするには、UrlFetchAppサービスと OAuth 2.0 を使用して、Google Analytics Data API に HTTPS リクエストを送信します。Google アナリティクス 4 プロパティを Google 広告アカウントにリンクして、ウェブサイトとアプリのコンバージョン データを直接共有することもできます。設定手順については、アナリティクス設定ガイドをご覧ください。 - Google BigQuery
- 大量のデータを Google Cloud Storage に読み込み、Google BigQuery を使用してそのデータにクエリを実行できます。たとえば、過去 10 年間の一般公開の気象データを読み込み、その情報を使用して入札単価を調整するスクリプトで、ある地域の平均気温をクエリできます。また、数年間にわたるアカウントのパフォーマンス データを集計する際にも使用できます。
- Google カレンダー
- スクリプトを使用すると、将来のタスクの予定を作成したり（たとえば、今日から 2 週間後にキャンペーンのパフォーマンス レポートを実行する）、カレンダーに作成したエントリに基づいてアクションを実行したり（たとえば、特定の日付にキャンペーンを有効にする）できます。
- Google スライド
- スクリプトでキャンペーンの詳細や統計情報を Google スライドにエクスポートして、そのような情報をプレゼンテーション形式で公開できます。
- Google ToDo リスト
- スクリプトを使用すると、将来のタスクのリマインダー リストを作成したり（例: 今日から 2 週間後にキャンペーンのパフォーマンス レポートを実行する）、リマインダー リストに作成したエントリに基づいてアクションを実行したりできます（例: 特定の日付にキャンペーンを有効にする）。
- Merchant API
- スクリプトで Merchant API を使用して、商品リスティングのアップロードと管理、Google Merchant Center アカウントの管理を行うことができます。スクリプトでは、商品リスティングを確認し、特定の商品を特定の広告にリンクするのに役立ちます。Merchant API には、[Advanced API] ダイアログで個別に有効にできるサブ API があります。Google Merchant Center アカウントのリンクについて詳しくは、デベロッパーとして登録するガイドをご覧ください。
- ショッピング コンテンツ
- スクリプトで Google Content API for Shopping を使用して、商品リスティングのアップロードと管理、Google Merchant Center アカウントの管理を行うことができます。スクリプトでは、商品リスティングを確認し、特定の商品を特定の広告にリンクするのに役立ちます。注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。代わりに、前のセクションで説明した Merchant API を使用してください。
- YouTube と YouTube アナリティクス
- 動画、再生リストなどのほか、動画のパフォーマンス データを取得、更新して、入札の判断に利用できます。
拡張 API を有効にする
どの Google API が拡張 API として利用可能かを確認するには、エディタの上部バーにある [拡張 API] をクリックして、[拡張 API] ダイアログを表示します。有効にする API を選択します。
[保存] をクリックして選択内容を保存し、スクリプト エディタに戻ります。新しい API がスクリプトで有効になり、予測入力リストに表示されます。
その他の考慮事項
高度な API を使用する際には、注意点がいくつかあります。
依存関係
アカウントでスクリプトを作成したユーザーのみが、そのスクリプトの高度な API 依存関係を変更できます。
権限
高度な API にアクセスする場合、スクリプトはスクリプトを承認したユーザーの権限を使用します。承認するユーザーは、スクリプトが必要とするすべてのデータへのアクセス権を持っている必要があります。たとえば、BigQuery アドバンスド API を使用するには、承認ユーザーに、ターゲットの Google Cloud プロジェクトと BigQuery データセットに必要な権限が付与されている必要があります。
2019 年 5 月より前のスクリプトに関する考慮事項
2019 年 5 月より前に作成されたスクリプトの場合、スクリプトに関連付けられた Google Cloud プロジェクトで、関連する API を手動で有効にする必要があります。高度な API ダイアログに Google Cloud コンソールへのリンクが表示されている場合は、スクリプトが影響を受けていることがわかります。
拡張 API を有効にする
2019 年より前のスクリプトでは、スクリプトで使用する各拡張サービスを手動で有効にする必要があります。
- [Advanced APIs] ボタンをクリックします。次のダイアログ ウィンドウで、Google Cloud コンソールへのリンクをクリックします。
- プロジェクトがまだ選択されていない場合は、[プロジェクト] プルダウン リストから選択します。
- 検索バーに API 名を入力して、スクリプトで使用する API を検索します。
- 検索結果から API を選択し、次のページで [有効にする] ボタンをクリックします。
スクリプトを作成したユーザーが後でアカウントから削除された場合、スクリプトにアクセスしようとする新規ユーザーは、高度な API 依存関係を再度有効にし、スクリプトを再承認するように求められます。