Google広告は自動化できたけれど、Meta・LINE・TikTok・Yahoo!……と媒体が増えるたびに管理画面を開いてExcelにコピペする作業だけが手作業のまま残っている。そんな状態に心当たりがある人は多いはずです。
これ、Google Apps Script（GAS）とスプレッドシートの組み合わせだけで、追加費用なしに自動化できます。GAS自体はGoogleアカウントがあれば無料で使え、各媒体の広告APIをUrlFetchAppで叩いてスプレッドシートに書き込む、という1つの型に載せてしまえるからです。
ただしGASには実行時間やトリガー回数といった見えにくい上限があり、媒体・アカウントが増えるとどこかで詰まります。そこでここからは、基本の型→実際に動くコード→各媒体APIとの繋ぎ方（詳細は媒体別記事に譲ります）→GASが限界を迎えるラインとその先の選択肢、という順で見ていきます。
自動化のレベル感を先に俯瞰しておきます。
多くの現場はGASから始めて、媒体が増えたタイミングでBigQueryか外注を検討する、という順番を辿ります。まずはGASでの基本の型を見ていきます。
どの媒体のAPIを叩く場合でも、GASでの自動化はほぼ同じ5手順に分解できます。
まず、書き込み先になるスプレッドシートを用意するところからです。
広告レポート自動化）に変更してEnterキーを押しますfunction myFunction() {} という空の関数が表示されますad-report-fetch）を入力して「名前を変更」をクリックしますここまでの確認: ブラウザのタブ名が「(プロジェクト名) - プロジェクト エディタ」のような表示になり、コードエディタが開いていれば成功です。ここに自動化コードを書いていきます。
なお「Apps Script」メニューは2021年11月頃に旧「ツール」→「スクリプトエディタ」から名称・場所が変わっています。古い解説記事の手順をなぞって「ツールの中に見当たらない」と迷う人が今でも一定数いるので、現行の「拡張機能」→「Apps Script」を覚えておくと無駄がありません。
トリガーは「どの関数を・いつ自動実行するか」の設定です。設定時に実行対象の関数を選ぶ必要があるため、実際の作業順としては、手順5までのコードを書いて保存した後にこの設定をしてください（ここでは型の全体像として先に説明します）。
fetchAdReportToSheet）ここまでの確認: トリガー一覧の画面に戻り、表に今作ったトリガー（関数名・イベント「時間ベース」）が1行表示されていれば設定完了です。これで、UrlFetchAppで各媒体APIを呼ぶ関数が毎日自動で実行されるようになります。
※トリガーの実行時刻は、Apps Scriptプロジェクトのタイムゾーン設定に従います。画面左端の歯車アイコン「プロジェクトの設定」を開き、「タイムゾーン」が「(GMT+09:00) 日本標準時 - 東京」になっているか確認してください。ここが日本以外になっていると、意図しない時刻に実行されます。
※ダイアログの項目名・ボタンの表記は、UIのバージョンによって多少異なる場合があります。
シンプルトリガーと違い、インストール型トリガーは外部API呼び出しを含む「承認が必要なサービス」を利用できます。広告APIを叩く自動化では必ずこちらを使うことになります。ここで押さえておきたいのが実行時間の上限で、無料のGoogleアカウントは1日90分、Google Workspaceは1日6時間までしかトリガーを実行できません。媒体を増やすたびにこの上限に近づいていく点は、後述する「GASの限界」で詳しく触れます。
各媒体側の管理画面・開発者ポータルでOAuth2.0のクライアントID・シークレットを発行し、リフレッシュトークンを取得します。ここでは例として、Google広告のクレデンシャル一式（クライアントID・クライアントシークレット・リフレッシュトークン・開発者トークン）を発行する手順を最後まで通します。他媒体も「開発者ポータルでアプリ登録→キー発行→トークン取得」という骨格は同じです。
※Google CloudコンソールやGoogle広告管理画面の表記・メニュー位置はアップデートで変わることがあります。以下は2026年8月時点の一般的な表記です。
ads-report-gas）を入力し、「作成」をクリックします。作成が終わると画面右上のベルアイコン（通知）に完了が表示されるので、通知内の「プロジェクトを選択」をクリックします（上部バーのプロジェクト名が今作った名前になっていることを確認してください）ads-report-gas）gas-oauth-client）https://developers.google.com/oauthplayground と入力します（次の3-2で使います。末尾にスラッシュを付けないでください）〜.apps.googleusercontent.com という形式）と「クライアント シークレット」が表示されます。両方をこの場でコピーして、パスワード管理ツールなど安全な場所に控えますGoogle Ads API と入力し、検索結果の「Google Ads API」をクリックして「有効にする」をクリックしますここまでの確認: 「APIとサービス」→「有効なAPIとサービス」の一覧に「Google Ads API」が表示されていれば成功です。
https://www.googleapis.com/auth/adwords と入力し、「Authorize APIs」ボタンをクリックします1// で始まる文字列が表示されるので、コピーして控えます。これがリフレッシュトークンですここまでの確認: 「Refresh token」欄が空でなければ成功です。空のままの場合は、Googleアカウントのアクセス権管理で該当アプリのアクセス権を一度削除してから、手順3からやり直してください。
注意: OAuth同意画面の公開ステータスが「テスト」のままだと、リフレッシュトークンは7日で失効します。継続運用する場合は、Google Auth Platformの「対象」画面にある「アプリを公開」をクリックして本番ステータスにしておいてください。
login-customer-id 経由で）アクセスできるのは、そのMCCにリンクされている広告アカウントだけです。MCCの左メニュー「アカウント」→「サブアカウント設定」（またはアカウント一覧右上の「＋」）→「既存のアカウントをリンク」で対象アカウントのお客様IDを入力してリンク申請し、広告アカウント側の管理画面（「ツールと設定」→「アクセスと権限」→「管理者」タブ）で申請を承諾してください。開発者トークン取得のために新規でMCCを作った場合、このリンクを忘れると後の実行が必ず PERMISSION_DENIED で失敗します。また、3-2で認可に使うGoogleアカウントは、広告アカウントだけでなくこのMCCにもアクセスできる必要がありますアクセスレベルごとの上限や審査の詳細はGoogle広告レポート自動化のやり方にまとめています。
この手順3だけは、媒体ごとに画面も審査要否もまったく異なります。審査に数営業日〜数週間かかる媒体もあるため、先に申請だけ済ませておくのが効率的です。Google広告以外の媒体ごとの具体的な画面遷移は、この記事の後半で媒体別記事にリンクしています。
手順3で控えた値を、GASの「スクリプトプロパティ」（PropertiesService）に保存します。コードに直接書く（ハードコーディングする）と、コードを共有・コピーした瞬間に認証情報が漏れるため、必ずここに保存しておくのが定石です。
| プロパティ（キー名） | 値（Google広告の例） |
|---|---|
AD_CLIENT_ID | 3-1で控えたクライアントID（〜.apps.googleusercontent.com） |
AD_CLIENT_SECRET | 3-1で控えたクライアントシークレット |
AD_REFRESH_TOKEN | 3-2で控えたリフレッシュトークン（1// で始まる文字列） |
AD_DEVELOPER_TOKEN | 3-3で控えた開発者トークン |
AD_CUSTOMER_ID | データを取りたい広告アカウントのお客様ID。管理画面右上に「123-456-7890」の形式で表示されるものをハイフンなしの10桁（例: 1234567890）で入力 |
AD_LOGIN_CUSTOMER_ID | MCC（管理アカウント）のお客様ID。同じくハイフンなしの10桁。3-3の手順2のとおり、このMCCに AD_CUSTOMER_ID のアカウントがリンクされていることが前提です |
ここまでの確認: 保存後、「スクリプト プロパティ」欄に6行のキーと値が一覧表示されていれば成功です。
実行時はUrlFetchAppでOAuthトークンエンドポイントを叩いてアクセストークンを取得し、各媒体のレポートAPIにAuthorizationヘッダーを付けてリクエストする、という2段構えになります（コードは次のセクションで丸ごと示します）。
最後に、APIのレスポンスを書き込む先のシートを整えます。
レポート に変更してEnterキーを押します。コード内の getSheetByName('レポート') とシート名が一字一句一致している必要があります日付 キャンペーン名 クリック数 費用 CV数 と入力しておきますコード側では SpreadsheetApp.getActiveSpreadsheet().getSheetByName('レポート') で書き込み先のシートを取得し、APIから返ってきたJSONレスポンスをパースして setValues() で2行目以降に書き込みます。ここまでで、手作業のコピペは自動化された状態になります。
注意したいのは、Amazon AdsやYahoo!広告のようにレポート取得が非同期方式の媒体です。この手順5の中でポーリングループが必要になり、GASの1回あたり6分という実行時間制限に引っかかりやすいポイントになります。詳しくは後述します。
媒体ごとにエンドポイントやリクエスト形式は違いますが、GAS側のコードの骨格はどの媒体でもほぼ共通です。手順3・4で用意したGoogle広告のクレデンシャルを使って、過去30日のキャンペーン別・日別実績をシート「レポート」に書き込む完全なコードを示します。このままコピペで動きます。ただし本番の広告アカウントに対して動くのは、3-3のBasicアクセス承認が下りた後です。承認前に試す場合はテストアカウントで検証してください。
/**
* Google広告のキャンペーン別・日別レポート（過去30日）をシート「レポート」に書き込む
* 事前準備:
* - 手順3: クライアントID / シークレット / リフレッシュトークン / 開発者トークンを取得済み
* - 手順4: スクリプトプロパティに6つの値（AD_CLIENT_ID など）を保存済み
* - 手順5: スプレッドシートに「レポート」という名前のシートを用意済み
*/
function fetchAdReportToSheet() {
// ---- 認証情報をスクリプトプロパティから読み込む（手順4で保存した値）----
const props = PropertiesService.getScriptProperties();
const clientId = props.getProperty('AD_CLIENT_ID');
const clientSecret = props.getProperty('AD_CLIENT_SECRET');
const refreshToken = props.getProperty('AD_REFRESH_TOKEN');
const developerToken = props.getProperty('AD_DEVELOPER_TOKEN');
const customerId = props.getProperty('AD_CUSTOMER_ID'); // ハイフンなし10桁
const loginCustomerId = props.getProperty('AD_LOGIN_CUSTOMER_ID'); // MCCのID（ハイフンなし）
// ---- 1. リフレッシュトークンからアクセストークンを取得 ----
const tokenRes = UrlFetchApp.fetch('https://oauth2.googleapis.com/token', {
method: 'post',
payload: {
client_id: clientId,
client_secret: clientSecret,
refresh_token: refreshToken,
grant_type: 'refresh_token',
},
muteHttpExceptions: true, // エラー時もレスポンス本文を読めるようにする
});
if (tokenRes.getResponseCode() !== 200) {
throw new Error('アクセストークンの取得に失敗: ' + tokenRes.getContentText());
}
const accessToken = JSON.parse(tokenRes.getContentText()).access_token;
// ---- 2. Google Ads APIのレポートエンドポイント（searchStream）を呼ぶ ----
const query =
'SELECT segments.date, campaign.name, metrics.clicks, ' +
'metrics.cost_micros, metrics.conversions ' +
'FROM campaign WHERE segments.date DURING LAST_30_DAYS ' +
'ORDER BY segments.date';
const reportRes = UrlFetchApp.fetch(
'https://googleads.googleapis.com/v25/customers/' + customerId + '/googleAds:searchStream',
{
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + accessToken,
'developer-token': developerToken,
'login-customer-id': loginCustomerId,
},
payload: JSON.stringify({ query: query }),
muteHttpExceptions: true,
}
);
if (reportRes.getResponseCode() !== 200) {
throw new Error('レポート取得に失敗: ' + reportRes.getContentText());
}
// ---- 3. レスポンスをパースして2次元配列にする ----
// searchStreamのレスポンスは [{ results: [...] }, ...] というバッチの配列で返る
const batches = JSON.parse(reportRes.getContentText());
const values = [];
batches.forEach(function (batch) {
(batch.results || []).forEach(function (row) {
values.push([
row.segments.date,
row.campaign.name,
Number(row.metrics.clicks || 0),
Number(row.metrics.costMicros || 0) / 1000000, // 費用は100万分の1単位で返るため口座の通貨単位（日本円アカウントなら円）に換算
Number(row.metrics.conversions || 0),
]);
});
});
if (values.length === 0) {
Logger.log('対象期間のデータが0件でした');
return;
}
// ---- 4. シート「レポート」の2行目以降に書き込み ----
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('レポート');
if (!sheet) {
throw new Error('シート「レポート」が見つかりません。シート名を確認してください');
}
sheet.getRange(2, 1, sheet.getMaxRows() - 1, 5).clearContent(); // 前回の書き込みをクリア
sheet.getRange(2, 1, values.length, 5).setValues(values);
Logger.log(values.length + '行を書き込みました');
}なお、エンドポイントURL内の v25 は執筆時点（2026年8月）の最新バージョンです。Google Ads APIのバージョンは約1年でサンセット（廃止）されるため、時間が経ってから実装する場合は公式リリースノートで現行バージョンを確認し、読み替えてください。
貼り付けから初回実行までの操作は次のとおりです。
function myFunction() {} をすべて削除し、上のコードを丸ごと貼り付けますエラーになった場合は、実行ログに出るメッセージで切り分けます。invalid_grant ならリフレッシュトークンの期限切れか値の貼り間違い（3-2をやり直し）、DEVELOPER_TOKEN_NOT_APPROVED を含むエラーなら開発者トークンが本番アカウント未承認（3-3の審査待ち）、PERMISSION_DENIED（USER_PERMISSION_DENIED を含む）なら、認可したGoogleアカウントに広告アカウント・MCCの閲覧権限がないか、AD_LOGIN_CUSTOMER_ID のMCCに対象アカウントがリンクされていない（3-3の手順2を確認）、が代表的な原因です。
動作が確認できたら、最後に手順2のとおりトリガーを設定すれば、毎朝自動でシートが更新される状態になります。
このコードのうち媒体ごとに書き換えるのは、(1) トークンエンドポイントのURL、(2) レポートAPIのURL・ヘッダー・リクエスト形式、(3) レスポンスのパース部分、の3か所だけです。媒体側の認証方式（OAuth2.0か、JWS署名かなど）とレスポンス構造は媒体ごとに差があるため、実際のエンドポイント名は各媒体の記事を参照してください。
主要8媒体の認証方式とレポート取得の同期・非同期の別を一覧にしました。GASのUrlFetchAppでどう繋ぐかの具体的な手順は、それぞれの記事にまとめています。
| 媒体 | 主な認証方式 | レポート取得 | 詳しい手順 |
|---|---|---|---|
| Google広告 | OAuth2.0 | 比較的同期的（GAQL） | Google広告レポート自動化のやり方 |
| Meta広告 | OAuth2.0 | 比較的同期的（Insights API） | Meta広告レポート自動化のやり方 |
| LINE広告 | アクセスキー＋シークレットキーによるJWS署名方式 | 媒体別記事を参照 | LINE広告レポート自動化の現在地 |
| TikTok広告 | OAuth2.0 | 媒体別記事を参照 | TikTok広告レポート自動化のやり方 |
| Yahoo!広告 | OAuth（独自エンドポイント） | 非同期（作成→ポーリング→DL） | Yahoo!広告レポート自動化のやり方 |
| X（Twitter）広告 | 書き込み系はOAuth1.0a中心、一部読み取りでOAuth2.0ベアラートークン | 媒体別記事を参照 | X広告レポート自動化のやり方 |
| Amazon Ads | OAuth2.0 | 非同期（作成→ポーリング→DL） | Amazon Adsレポート自動化のやり方 |
| Microsoft Advertising | OAuth2.0 | 媒体別記事を参照 | Microsoft広告レポート自動化のやり方 |
表からも分かるとおり、Amazon AdsとYahoo!広告は「レポート作成リクエスト→ステータスポーリング→完了後ダウンロードURL取得」という非同期のジョブ方式です。GASでこの流れを扱うのが、次に説明する限界の中でもいちばん詰まりやすいポイントになります。
GASは無料で始められる反面、Googleが公式に定めているクォータの範囲でしか動きません。広告レポート自動化で実際に当たりやすい上限を並べます。
| 制限項目 | 上限 |
|---|---|
| スクリプトの実行時間 | 6分/回（カスタム関数は30秒/回） |
| トリガーの合計実行時間 | 無料アカウント90分/日、Google Workspace 6時間/日 |
| トリガー数 | 20個/ユーザー/スクリプトまで |
| 同時実行数 | 30/ユーザー、1,000/スクリプト |
| URL Fetch呼び出し回数 | 無料アカウント20,000回/日、Workspace 100,000回/日 |
| URL Fetch応答サイズ | 50MB/回 |
※上限値は変更されることがあります。最新値は公式のクォータページで確認してください。
数字だけ見ると余裕がありそうですが、実務でつまずくのは主に3つです。
1. 媒体×アカウントが増えると1本のスクリプトでは収まらなくなる。実行時間6分とトリガー合計90分/日（無料）・6時間/日（Workspace）の上限があるため、複数媒体×複数アカウントの日次レポート取得を1つのスクリプトに詰め込むと、どこかで必ず詰まります。「毎朝7時のトリガーが、3媒体目の取得中に6分制限で落ちる」といった形で症状が出るのが典型です。トリガーを媒体・アカウントごとに分割し、実行時間をずらす設計がほぼ必須になります。
2. 非同期レポートAPIとの相性が悪い。Amazon AdsやYahoo!広告のようにジョブ作成→ポーリング→ダウンロードという複数リクエストが必要な媒体は、GASの6分実行制限に収める工夫が必須になります。具体的には、Utilities.sleepで完了を待ち続けるのではなく、いったん処理を終えてトリガーで数分後に再開する「分割実行」に組み替えます。この工夫を怠ると「たまに処理が完走しない」という不安定さを抱え込みます。また、ポーリングのたびにリクエストが増えるため、URL Fetch呼び出し回数の上限（無料20,000回/日）にも影響します。
3. トークン管理が属人化しやすい。各媒体のOAuthリフレッシュトークンやアクセストークンには、媒体によって数十日単位の有効期限があります。この管理をGAS単体・スクリプトプロパティだけで堅牢に運用するのは難しく、担当者しか仕組みを把握していない状態になりがちです。これがBigQueryや専用ツールへの移行を検討する動機になります。
GASでの自動化は、1〜2媒体・数アカウント程度であれば十分に実用的です。限界が来るのは、たいてい媒体数が増えたタイミングです。
BigQueryに移行すれば、GASの実行時間・トリガー回数といった制約から解放され、複数媒体のデータを1つのDWHに集約して横断分析やAI分析にも繋げやすくなります。BigQueryのクエリ課金の考え方はBigQueryの料金体系とコスト削減｜課金トラップと対策で解説しています。また、レポート自動化を外注する場合の費用感は広告レポート自動化の費用は？ツール・代行の料金相場と選び方、GAS以外の選択肢との比較は広告レポート自動化ツール比較｜主要9ツールの料金・対応媒体・選び方にまとめています。
私たちが提供しているアドヨミAIは、この「複数媒体×API連携×BigQuery集約」を肩代わりするサービスです。GASでの内製が属人化してきた、媒体が増えて保守の手が回らない、という段階で選択肢に入れていただければと思います。
まずは1媒体、今日この手順でGASを動かしてみてください。そこから先で壁に当たったら、この記事の各リンク先に戻ってきてもらえれば大丈夫です。
株式会社EvastのアドヨミAIは、Google・Meta・TikTokなど主要媒体の広告データをAPIで自動連携し、自社所有のBigQueryに集約する半スクラッチ型の広告レポート自動化・AI分析サービスです。
現状の運用の棚卸しからで構いません。1媒体・初期5万円・月額1.5万円〜（媒体数に応じた累進制）、最短2週間から始められます。
Amazon広告のレポート自動化は、まず「Amazon Ads API」と出品者業務向けの「SP-API」を混同しないことが出発点です。LWA（Login with Amazon）でのOAuth認証、API利用申請、Profile ID取得の手順から、reporting/reportsへのレポートリクエスト→ステータスのポーリング→ダウンロードという非同期取得の3ステップ、Pythonの実コードまでを、2026年8月時点で確認できる公式情報に沿って整理します。
Microsoft広告(Bing)にはGoogleやMetaのような無料の公式コネクタ・転送サービスが無く、日本語の情報もほとんどありません。管理画面でのレポート出力やETLツール経由の方法に加え、本命のReporting API直連携について、開発者トークンの取得からAzure Portalでのアプリ登録、OAuth認証、非同期レポート取得のPython実装までを2026年8月時点の公式ドキュメントに基づいて解説します。ダウンロードURLの5分間有効期限など、つまずきやすい落とし穴も押さえます。
X広告（旧Twitter広告）には無料の公式コネクタが無く、レポート自動化の本命はX Ads APIの直連携になります。ただし認証は一般のX API v2と異なるOAuth 1.0aで、利用にはApp IDごとの申請・審査が必要です。デベロッパー登録からKeys and tokensの発行、Ads API Access Formでの申請、広告主アカウントへの権限付与、非同期ジョブで日次CSVを自動取得するPython実装まで、実際のメニュー名とコピペで動くコードで一つずつ追います。
Google広告の日次レポートは、無料の公式手段だけで自動化できます。Looker Studio・Google Adsスクリプト・BigQuery Data Transfer・Ads API直連携それぞれの設定のやり方、開発者トークン申請とGAQL・Pythonの実コード、そして集めたデータをChatGPTやGeminiにつないで考察・日次サマリまで自動化する方法、リフレッシュトークン失効などの落とし穴を、2026年7月時点の公式情報で整理します。