Google 広告スクリプトは、ブラウザベースの IDE で最新の JavaScript（ES6+）を使用して、Google 広告データをプログラムで管理、クエリできるサーバーレス自動化プラットフォームです。Google 広告スクリプトを使用すると、サーバーのプロビジョニングやデベロッパー認証情報の管理を行うことなく、1 つのアカウントまたは数千のアカウントで、日常的なアカウント管理ワークフローの自動化、カスタム レポートの生成、Google 広告と外部データソースの統合を行うことができます。
Google 広告のほとんどの機能は、mutate 呼び出しと search 呼び出しを介して Google 広告スクリプトで使用できます。スクリプトを使用すると、次のことができます。
- キャンペーン、広告グループ、キーワード、広告を管理します。
- リアルタイムのパフォーマンスや外部データに基づいて、入札単価、予算、ステータスを調整します。
- Google 広告クエリ言語（GAQL）を使用してクエリを実行し、カスタム レポートとダッシュボードを生成します。
- 自動実行をスケジュールして、1 時間ごと、毎日、毎週、毎月、またはオンデマンドで実行します。
- マネージャー スクリプトを使用して、お子様用アカウント間でマルチアカウント オペレーションを調整します。
- Google Workspace サービス（スプレッドシートやドライブなど）、Google Cloud サービス（BigQuery など）、サードパーティ API に接続する。
スクリプトには、組み込みのエンティティ セレクタとレポートも含まれています。
主な技術仕様
Google 広告スクリプトの実行環境と運用上の制限は、以下の技術仕様で定義されています。
| 仕様 | 単一アカウントのスクリプト | マネージャー アカウント スクリプト |
|---|---|---|
| 実行タイムアウト | 最大 30 分 |
executeInParallel とコールバックで最大 60 分（標準は 30 分） |
| ランタイム エンジン | V8 JavaScript ランタイム（ECMAScript 6 以降） | V8 JavaScript ランタイム（ECMAScript 6+） |
| エンティティ イテレータの上限 | イテレータあたりのデフォルトのエンティティ数: 50,000（レポートと検索クエリは除く） | 子アカウントごとに 50,000 個のエンティティ（レポートと検索クエリは対象外） |
| 並列アカウント | 該当なし（1 アカウント） | 最大 50 個のアカウントを並行して移行 |
| 一括アップロードの上限 | ファイルサイズ 50 MB、1,000,000 行 | ファイルサイズ 50 MB、1,000,000 行 |
| 承認済みスクリプト | ユーザーあたり最大 250 個の承認済みスクリプト | ユーザーごとに最大 250 個の承認済みスクリプト |
| ホスティングとインフラストラクチャ | Google のフルマネージド サービス（サーバーレス） | Google のフルマネージド サービス（サーバーレス） |
詳細については、上限をご覧ください。
Google 広告スクリプトは私に適したサービスですか？
Google では、Google 広告アカウントの自動化に役立つ複数のプロダクトを提供しています。次の表に、一般的なシナリオと、ニーズに合ったプロダクトを選択するうえで役立つ推奨事項を示します。
| シナリオ | 推奨事項 | 鍵特性 |
|---|---|---|
| 独自のソフトウェア プロダクトを構築するか、Google Ads API と統合したいデベロッパーです。コードの作成、サーバーやデータベースなどのソフトウェア インフラストラクチャの管理に慣れている。 | Google Ads API を使用します。 | 完全な API 制御、高スループット、専用ホスティング、OAuth 管理。 |
| コードの記述は得意だが、独自のソフトウェア インフラストラクチャの管理は避けたいデベロッパー。 | Google 広告スクリプトを使用する。 | Google 広告内でのサーバーレス実行、自動スケジュール設定、ブラウザベースの IDE。 |
| 私はデベロッパーではありませんが、Google 広告を自動化するためにプログラミングを学ぶ時間を投資するつもりです。 | Google 広告スクリプトを使用する。 | シンプルな JavaScript 構文、事前構築済みのスクリプト テンプレート、IDE の予測入力、構文のハイライト表示。 |
| 動画キャンペーンをプログラムで管理したい。 | Google 広告スクリプトを使用します。 |
AdsApp.videoCampaigns() を使用した動画キャンペーンの直接管理。
|
| アクティブなユーザー セッションを必要とせずに、タスクをスケジュールして実行したい。 | Google 広告スクリプトを使用する。 | 1 時間ごと、毎日、毎週、毎月などの自動スケジュール設定による OAuth2 バックグラウンド認証。 |
| ネストされた Google 広告アカウントにプログラムでアクセスしたい。 | マネージャー スクリプトを使用すると、1 つのスクリプトから配信中の子アカウントにアクセスできます。 |
お子様用アカウント全体での順次反復処理、または executeInParallel を使用した最大 50 個のお子様用アカウント全体での並列実行。 |
| Google 所有の API またはサードパーティの API を Google 広告の管理に統合したい。 | Google 広告スクリプトで Google API またはサードパーティ API を使用します。 |
組み込みの Google Workspace サービス（スプレッドシート、ドライブ、メール）、高度な Google API（BigQuery、アナリティクス、YouTube）、外部 REST API 用の UrlFetchApp。 |
| 私はデータ アナリスト（または同様の役割）で、さらに分析するために Google 広告レポートをダウンロードしたいと考えています。 | Google 広告用 BigQuery Data Transfer Service を使用します。 | コードを記述することなく、Google 広告データを BigQuery に取り込む自動パイプラインをスケジュールします。 |
| Google 広告を一括で管理したい。コードの記述は問題ない。 | Google 広告スクリプトで一括アップロードを使用します。 | プログラムによる CSV またはスプレッドシートのアップロード（最大 1,000,000 行まで対応）。 |
| Google 広告を一括で管理したいが、コードは記述したくない。 | 自動化ルール、一括アップロード、Google 広告エディタを使用します。 | 一括更新とルールのスケジュール設定を行うためのノーコードのデスクトップ ツールまたは UI ツール。 |
前提条件
JavaScript の基本的な知識があれば十分です。IDE には、構文のハイライト表示、自動補完、プレビューなどの機能が備わっています。Google 広告アカウントがあれば、最初のスクリプトの作成を開始できます。
よくある質問
Google 広告スクリプトのアーキテクチャ、実行制限、統合に関するよくある質問とその回答を紹介します。
Google 広告スクリプトとは
Google 広告スクリプトは、Google 広告内でサーバーレスの自動化環境を提供します。広告主やデベロッパーは、JavaScript コードを記述して、パフォーマンス指標のクエリ、キャンペーンの作成と変更、入札単価と予算の更新、外部 API との接続を行うことができます。サーバーの構成、OAuth トークンの管理、インフラストラクチャの費用は不要です。
Google 広告スクリプトと Google Ads API の違いは何ですか？
Google 広告スクリプトは、JavaScript を使用して Google 広告アカウントで直接実行されます。サーバー インフラストラクチャは不要で、ブラウザで自動的に承認が処理されます。Google Ads API は、大規模なエンタープライズ アプリケーション、サードパーティ ツール、大量のデータ パイプライン向けに設計された REST および gRPC API です。独自のサーバーで実行され、専用のデベロッパー トークンと OAuth 認証情報が必要です。
Google 広告スクリプトを実行するにはサーバーが必要ですか？
いいえ。Google 広告スクリプトは、追加料金なしで Google のクラウド インフラストラクチャ上で実行されます。スクリプトの作成、プレビュー モードでのテスト、スケジュールの設定は、Google 広告のウェブ インターフェースで直接行うことができます。
Google 広告スクリプトの実行上限はどのくらいですか？
個々のアカウントの標準スクリプトは、1 回の実行につき最大 30 分間実行できます。executeInParallel を使用するクライアント センター（MCC）アカウント スクリプトは、最大 50 個の子アカウントで最大 60 分間実行できます（コールバック関数が指定されている場合）。スクリプトがタイムアウトした場合でも、キャンセル前に加えられた変更は Google 広告に適用されます。タイムアウト、割り当て、一括アップロードの上限の詳細については、上限をご覧ください。
Google 広告スクリプトは外部 API に接続できますか？
はい。Google 広告スクリプトには、Google スプレッドシートの読み取りと書き込みを行う SpreadsheetApp、外部 REST API に HTTP リクエストを送信する UrlFetchApp、BigQuery や YouTube などのサービスと統合するための Advanced Google APIs などの組み込みサービスが含まれています。詳細については、サードパーティ API と Advanced Google API をご覧ください。
フィードバック
Google 広告スクリプトに関するフィードバックがございましたら、ぜひお聞かせください。Discord でお問い合わせください。
サポートが必要な場合は、スクリプトのテクニカル サポートにお問い合わせください。