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 には、[高度な 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 を有効にする

高度な API として使用できる Google API を確認するには、エディタの上部にある [Advanced APIs] をクリックして、[Advanced APIs] ダイアログを表示します。有効にする API を選択します。

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

その他の考慮事項

高度な API を使用する際は、次の点に注意してください。

依存関係

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

権限

API にアクセスする際、スクリプトはスクリプトを承認したユーザーの権限を使用します。スクリプトを承認したユーザーに、スクリプトに必要なすべてのデータへのアクセス権があることを確認します。Google アナリティクス 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 依存関係を再度有効にし、スクリプトを再承認するよう求められます。