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 広告スクリプトを使用する。 | OAuth2 バックグラウンド認証。1 時間ごと、毎日、毎週、毎月の自動スケジュール設定。 |
| ネストされた Google 広告アカウントにプログラムでアクセスしたい。 | MCC スクリプトを使用して、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 広告スクリプトの実行上限はどのくらいですか？
個々のアカウントの標準スクリプトは、実行ごとに最大 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 でお問い合わせください。
サポートが必要な場合は、スクリプトのテクニカル サポートにお問い合わせください。