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 広告アカウントにプログラムでアクセスしたい。 | マネージャー スクリプトを使用すると、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 広告内でサーバーレスの自動化環境を提供します。広告主やデベロッパーは、サーバーの構成、OAuth トークンの管理、インフラストラクチャの費用を支払うことなく、JavaScript コードを記述して、パフォーマンス指標のクエリ、キャンペーンの作成と変更、入札単価と予算の更新、外部 API との接続を行うことができます。
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 などのサービスと統合するための拡張 Google API などの組み込みサービスが含まれています。詳細については、サードパーティ API と高度な Google API をご覧ください。
フィードバック
Google 広告スクリプトに関するフィードバックがございましたら、ぜひお寄せください。Discord でお問い合わせください。
サポートが必要な場合は、スクリプトのテクニカル サポートにお問い合わせください。