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 をオンにします。
次に、[Google API Console] リンクをクリックして、コンソールで [API Console] ページを開きます。このページには、スクリプトに関連付けられたプロジェクトが表示されます。プロジェクトがまだ選択されていない場合は、[プロジェクト] プルダウン リストから選択します。検索バーに API 名を入力して、スクリプトで使用する API を検索します。
検索結果で API を選択し、次のページで [有効にする]を選択します。[無効にする]ボタンが表示されている場合は、この API はすでに 有効になっています。有効にする API それぞれに同じ操作を繰り返します。
プロジェクトで有効になっている API のリストを表示するには、[ダッシュボード] ページを選択します。スクリプトで使用するすべての高度な API がリストに表示されていることを確認します。
[API（上級）] ダイアログを閉じ、エディタに戻ります。新しい API がスクリプトで有効になり、自動補完リストに表示されます。
考慮事項
高度な API を使用する際は、次の点にご留意ください。
プロジェクト ID
各 Google 広告スクリプトには、Google Cloud プロジェクト ID （プロジェクト番号とも呼ばれます）が関連付けられています。スクリプトのプロジェクト番号は、[API（上級）] ダイアログから Google API Console ページを開いて確認できます。このプロジェクト ID は、スクリプトを作成したときに作成され、Google 広告スクリプトを作成したユーザーに関連付けられます。スクリプトを作成したユーザーが後でアカウントから削除された場合、スクリプトにアクセスしようとすると、スクリプトの再認証と高度な API の依存関係の再設定を求めるメッセージが表示されます。新しい Google デベロッパー プロジェクト ID も作成されるため、このドキュメントの前半で説明したように、高度な API を再度設定する必要があります。
依存関係
スクリプトの高度な API の依存関係を変更できるのは、アカウントでスクリプトを作成したユーザーのみです。
権限
API にアクセスする際、スクリプトはスクリプトを承認したユーザーの権限を使用します。スクリプトを承認したユーザーが、使用されているすべての高度な API と、スクリプトに必要なデータにアクセスするための必要な権限を持っていることを確認してください。Google アナリティクス API を使用している場合は、スクリプトを承認したユーザーが、アクセスするアナリティクス アカウントに必要な権限を持っていることを確認してください。
利用規約
高度な API にはそれぞれ独自の利用規約が適用される場合があります。Google API Console で API を有効にする際は、利用規約に同意する必要があります。
Quota
大部分の高度な API には、1 日あたりの無料の使用量が割り当てられています。スクリプトがこの割り当てを超えると、追加のデータをリクエストするか、無料の割り当てが補充されるまで API は動作を停止します。スクリプトで使用されている割り当ては、[Advanced APIs] ダイアログからスクリプトの Google API Console を開いて 確認できます。Google API Console では、API の追加の割り当てをリクエストすることもできます。
課金
一部の高度な API では、使用料金が発生します。これらの支払いは、Google 広告ではなく、スクリプトに関連付けられた Google Cloud プロジェクトを通じて管理されます。スクリプトの Google Cloud プロジェクトの課金を有効にする方法について詳しくは、こちらのドキュメントをご覧ください。