Google 広告スクリプトの高度な API を使用すると、経験豊富なデベロッパーは、HTTP インターフェースを使用する場合よりも少ない設定で、特定の公開 Google API に接続できます。これらの API は、スクリプトの組み込みサービスとよく似ており、自動補完や自動承認などの便利な機能を提供します。
API（上級）の用途
- Google アナリティクス
- Google アナリティクスを使用して、ウェブサイトにアクセスしたトラフィックをトラッキングし、それに応じてキャンペーン入札単価を調整できます。Google アナリティクスのプロパティを Google 広告アカウントにリンクすると、ウェブサイトでのユーザー行動も分析できます。この情報により、Google 広告を経由したウェブサイトの表示回数や売り上げが明らかになり、広告とウェブサイトを改善することができます。アナリティクスと Google 広告のアカウントのリンクについて詳しくは、ヘルプセンターをご覧ください。
- Google BigQuery
- 大量のデータを Google Cloud Storage に読み込み、Google BigQuery を使用してそのデータをクエリできます。たとえば、過去 10 年間の公開天気データを読み込み、スクリプトで地域の平均気温をクエリして、その情報を使用して入札単価を調整できます。また、アカウントのパフォーマンス データを数年間にわたって分析することもできます。
- YouTube と YouTube アナリティクス
- 動画、再生リストなどのデータを取得して更新したり、動画のパフォーマンス データを取得して入札単価の決定に役立てたりできます。
- Google カレンダー
- スクリプトでは、今後のタスクの予定を作成したり（例: 2 週間後にキャンペーンのパフォーマンス レポートを実行する）、カレンダーに作成したエントリに基づいてアクションを実行したりできます（例: 特定の日付にキャンペーンを有効にする）。
- ショッピング コンテンツ
- スクリプトでは、Apps Script の Google Content API for Shopping を使用できます。この API を使用すると、Google Merchant Center ユーザーは商品リスティングのアップロードと管理、Merchant Center アカウントの管理を行うことができます。スクリプトでは、商品リスティングを確認したり、特定の商品を特定の広告にリンクしたりする際に役立ちます。
- Google ToDo リスト
- スクリプトでは、今後のタスクのリマインダー リストを作成したり（たとえば、今日から 2 週間後にキャンペーンのパフォーマンス レポートを実行する）、リマインダー リストに作成したエントリに基づいてアクションを実行したりできます（たとえば、特定の日付にキャンペーンを有効にする）。
- Google スライド
- スクリプトを使用してキャンペーンの詳細や統計情報を Google スライドにエクスポートし、プレゼンテーションに適した形式で公開できます。
Advanced API を有効にする
高度な API として使用可能な Google API を確認するには、上部のエディタバーにある [高度な API] ボタンをクリックします。
表示される [API（上級）] ダイアログで、有効にする API を確認します。
次に、[Google API Console] リンクをクリックして、スクリプトに関連付けられているプロジェクトを含む [API Console] ページをコンソールに表示します。プロジェクトがまだ選択されていない場合は、[プロジェクト] プルダウン リストから選択します。検索バーに API 名を入力して、スクリプトで使用する API を検索します。
検索結果で API を選択し、次のページで [有効にする] を選択します。[無効にする] ボタンが表示されている場合は、この API はすでに有効になっています。有効にする API それぞれに同じ操作を繰り返します。
プロジェクトで有効になっている API のリストを表示するには、[ダッシュボード] ページを選択します。スクリプトに使用する Advanced API がすべてリストに表示されていることを確認します。
[API（上級）] ダイアログを閉じ、エディタに戻ります。新しい API がスクリプトで有効になり、自動入力リストで使用できるようになります。
使用可能な API
使用できる API は次のとおりです。
| API 名 | ドキュメント |
|---|---|
| Google アナリティクス | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google カレンダー | https://developers.google.com/apps-script/advanced/calendar |
| Google スライド | https://developers.google.com/apps-script/advanced/slides |
| Google ToDo リスト | https://developers.google.com/apps-script/advanced/tasks |
| ショッピング コンテンツ | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube アナリティクス | https://developers.google.com/apps-script/advanced/youtube-analytics |
これらの API の使用方法については、コード スニペットのページも参照してください。
考慮事項
Advanced API を使用する際は、次の点に注意してください。
プロジェクト ID
各 Google 広告スクリプトには、Google Cloud Platform のプロジェクト ID（プロジェクト番号）が関連付けられています。スクリプトのプロジェクト番号を確認するには、[Advanced APIs] ダイアログから Google API コンソール ページを開きます。このプロジェクト ID はスクリプトの作成時に作成され、Google 広告スクリプトを作成したユーザーに関連付けられます。スクリプトを作成したユーザーが後でアカウントから削除された場合、スクリプトにアクセスしようとすると、スクリプトを再承認し、Advanced API の依存関係を再度設定するよう求められます。新しい Google デベロッパー プロジェクト ID も作成されます。このドキュメントの前半で説明したように、Advanced API を再度設定する必要があります。
依存関係
アカウントでスクリプトを作成したユーザーのみが、そのスクリプトの Advanced APIs の依存関係を変更できます。
権限
スクリプトは、API にアクセスするときに、スクリプトを承認したユーザーの権限を使用します。スクリプトを承認したユーザーに、使用されているすべての Advanced API とスクリプトに必要なデータへの必要なアクセス権があることを確認します。Google Analytics API を使用している場合は、スクリプトを承認したユーザーに、アクセスするアナリティクス アカウントに必要な権限があることを確認してください。
利用規約
各 Advanced API には独自の利用規約があり、Google API コンソールで API を有効にするときに同意する必要があります。
割り当て
大部分の API（上級）には、1 日あたりの無料の使用量が割り当てられています。スクリプトがこの割り当てを超えると、追加のデータをリクエストするか、無料の割り当てが補充されるまで、API は機能しなくなります。スクリプトで使用される割り当てをモニタリングするには、[Advanced APIs] ダイアログからスクリプトの Google API Console を開きます。Google API Console では、API の追加の割り当てをリクエストすることもできます。
課金
一部の Advanced API では、使用料金が発生します。これらのお支払いは、Google 広告ではなく、スクリプトに関連付けられている Google Cloud Platform プロジェクトで管理されます。スクリプトの Google Cloud Platform プロジェクトで課金を有効にする方法については、ドキュメントをご覧ください。