API(上級)

Google 広告スクリプトの高度な API を使用すると、HTTP インターフェースを使用する場合よりも少ない設定で、特定の公開 Google API に接続できます。これらの API は、スクリプトの組み込みサービスと同様に使用でき、オートコンプリートや自動承認などの便利な機能も提供されます。

これらの API の使用方法を示す例については、コード スニペットのページをご覧ください。

利用可能な高度な API

Google アナリティクス
Google アナリティクスを使用すると、ウェブサイトにアクセスしたトラフィックをトラッキングし、それに応じてキャンペーンの入札単価を調整できます。Google アナリティクスのプロパティを Google 広告アカウントにリンクすると、ウェブサイトでのユーザー行動を分析することもできます。これにより、Google 広告経由のサイト閲覧数や売り上げを把握し、広告やサイトの改善に役立てることができます。アナリティクスと 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 APIs] ダイアログで個別に有効にできるサブ API があります。Google Merchant Center アカウントのリンクについて詳しくは、デベロッパーとして登録するガイドをご覧ください。
ショッピング コンテンツ
スクリプトで Google Content API for Shopping を使用すると、商品リスティングのアップロードと管理、Google Merchant Center アカウントの管理を行うことができます。スクリプトでは、商品リスティングを確認したり、特定の商品を特定の広告にリンクしたりする際に役立ちます。注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。代わりに、前のセクションで説明した Merchant API を使用してください。
YouTube と YouTube アナリティクス
動画、再生リストなどのほか、動画のパフォーマンス データを取得、更新して、入札の判断に利用できます。

高度な API を有効にする

拡張 API として利用可能な Google API を確認するには、エディタの上部バーにある [拡張 API] をクリックして、[拡張 API] ダイアログを表示します。有効にする API を選択します。

[保存] をクリックして選択内容を保存し、スクリプト エディタに戻ります。新しい API がスクリプトで有効になり、オートコンプリート リストで使用できるようになります。

その他の考慮事項

拡張サービスを使用する際には、注意点がいくつかあります。

依存関係

アカウントでスクリプトを作成したユーザーのみが、そのスクリプトの高度な API 依存関係を変更できます。

権限

API にアクセスするとき、スクリプトはスクリプトを承認したユーザーの権限を使用します。スクリプトを承認したユーザーに、スクリプトに必要なすべてのデータへのアクセス権が付与されていることを確認します。Google Analytics API を使用している場合は、スクリプトを承認したユーザーが、アクセス対象のアナリティクス アカウントに必要な権限を持っていることを確認します。

2019 年 5 月より前のスクリプトに関する考慮事項

2019 年 5 月より前に作成されたスクリプトについては、スクリプトに関連付けられた Google Cloud プロジェクトで関連する API を手動で有効にする必要がある場合があります。スクリプトが影響を受けるかどうかは、高度な API のダイアログに Google Cloud コンソールへのリンクが表示されるかどうかで判断できます。

拡張 API を有効にする

2019 年より前のスクリプトでは、スクリプトで使用する各拡張 API を手動で有効にする必要があります。

  1. [Advanced APIs] ボタンをクリックします。次のダイアログ ウィンドウで、Google Cloud コンソールへのリンクをクリックします。
  2. プロジェクトがまだ選択されていない場合は、[プロジェクト] プルダウン リストから選択します。
  3. 検索バーに API 名を入力して、スクリプトで使用する API を検索します。
  4. 検索結果から API を選択し、次のページで [有効にする] ボタンをクリックします。

スクリプトを作成したユーザーが後でアカウントから削除されると、スクリプトにアクセスしようとする新しいユーザーは、高度な API の依存関係を再度有効にし、スクリプトを再承認するよう求められます。