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 を確認するには、エディタの上部のバーにある [高度な API] をクリックして、[高度な API] ダイアログを表示します。有効にする API を選択します。

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

その他の考慮事項

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

依存関係

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

権限

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

2019 年 5 月より前に作成されたスクリプトに関する考慮事項

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

高度な API を有効にする

2019 年より前に作成されたスクリプトの場合は、スクリプトで使用する高度な API を手動で有効にする必要があります。

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

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