使ってみる

最初のスクリプトを起動する手順は次のとおりです。

  1. ログインして Google 広告アカウントにアクセスします。
  2. 左側のナビゲーションの [ツール] メニューから、[**一括操作**]、 [**スクリプト**] の順に選択します。Google 広告の検索バーで「スクリプト」を検索して、このページに移動することもできます。
  3. + アイコン 白いプラス記号の付いた青い円 を押して、スクリプトを追加します。プルダウン メニューからスクリプト テンプレートを参照できますが、この演習では [新しいスクリプト] を選択します。
  4. [スクリプト名] テキスト フィールドにスクリプトの名前を入力することもできます。名前を付けることで、スクリプトを整理し、スクリプトの機能を把握しやすくなります。

  5. 次のコードをコピーしてエディタ領域に貼り付け、メイン関数を置き換えます。

    function main() {
  // Get the campaign names from all the campaigns
  const rows = AdsApp.search('SELECT campaign.name FROM campaign');

  console.log('My campaigns:');
  // Iterate through the campaigns and print the campaign names
  for (const row of rows) {
    console.log(row.campaign.name);
  }
}

  6. メッセージが表示されたら、[承認] をクリックして、スクリプトがユーザーに代わってアカウントにアクセスできるようにします。これは、スクリプトごとに 1 回行う必要があります。

  7. [**プレビュー**] をクリックして、スクリプトをプレビュー モードで実行します。 結果は [変更] / [ログ] パネルに表示されます。この例では、キャンペーン名がログに表示されます。

  8. プレビューの結果に問題がなければ、[実行] をクリックしてスクリプトを実行し、[スクリプトの履歴] ページを開きます。このページには、最近実行されたスクリプトとそのステータスと結果が表示されます。

  9. 変更とログの詳細を表示するには、[変更] 列で、実行したスクリプトに対応するリンクをクリックします。プレビューしたときと同じログ出力が表示されます。

クライアント センター（MCC）アカウント

広告管理スクリプトを実行するには、まず Google 広告 MCC アカウント が必要です。

  1. ログインして Google 広告 MCC アカウントをご利用ください。
  2. 左側のナビゲーションの [ツール] メニューから、[**一括操作**]、 [**スクリプト**] の順に選択します。Google 広告の検索バーで「スクリプト」を検索して、このページに移動することもできます。
  3. + アイコン 白いプラス記号の付いた青い円 を押して、スクリプトを追加します。プルダウン メニューからスクリプト テンプレートを参照できますが、この演習では [新しいスクリプト] を選択します。
  4. [スクリプト名] テキスト フィールドにスクリプトの名前を入力することもできます。名前を付けることで、スクリプトを整理し、スクリプトの機能を把握しやすくなります。

  5. 次のコードをコピーしてエディタ領域に貼り付け、メイン関数を置き換えます。

    function main() {
  // Retrieve all children accounts.
    const accountIterator = AdsManagerApp.accounts().get();

  // Iterate through the account list.
  for (const account of accountIterator) {
    // Get stats for the child account.
    const stats = account.getStatsFor("THIS_MONTH");
    // And log it.
    console.log(`${account.getCustomerId()},${stats.getClicks()},` +
      `${stats.getImpressions()},${stats.getCost()}`);
  }
}

  6. メッセージが表示されたら、[承認] をクリックして、スクリプトがユーザーに代わってアカウントにアクセスできるようにします。これは、スクリプトごとに 1 回行う必要があります。

  7. [**プレビュー**] をクリックして、スクリプトをプレビュー モードで実行します。 結果は [変更] / [ログ] パネルに表示されます。この例では、子アカウントとその指標がログに表示されます。

  8. プレビューの結果に問題がなければ、[実行] をクリックしてスクリプトを実行し、[スクリプトの履歴] ページを開きます。このページには、最近実行されたスクリプトとそのステータスと結果が表示されます。

  9. 変更とログの詳細を表示するには、[変更] 列で、実行したスクリプトに対応するリンクをクリックします。プレビューしたときと同じログ出力が表示されます。

スクリプト スニペットのサンプルについては、 例のページをご覧ください。