本頁面由 Cloud Translation API 翻譯而成。

Ads Manager 指令碼

Google Ads 指令碼中的 AdsManagerApp 類別可讓您管理管理員帳戶下方連結的帳戶。你可以管理所有廣告客戶帳戶都只需要一個指令碼，不用另外建立為每個帳戶建立獨立的指令碼

擷取帳戶清單

您可以使用 accounts 方法，例如：

const accountSelector = AdsManagerApp.accounts()
    .withCondition('customer_client.descriptive_name = "My Account"');

const accountIterator = accountSelector.get();

可供擷取的帳戶有一些限制：

如果您有多層階層，就無法擷取管理員帳戶。只能選取客戶帳戶。
根據預設，已關閉、取消和已停權的帳戶不會傳回。個人中心呼叫 withCondition 即可指定不同的「customer_client.status」的篩選器。

accounts 呼叫會擷取管理員帳戶階層。您可以使用 withLimit 方法 ManagedAccountSelector 類別，限制指令碼擷取的帳戶數量。另一個選項是使用 withIds 方法，根據客戶 ID 選取帳戶：

// Hyphens in the account ID are optional.
const accountSelector = AdsManagerApp.accounts()
    .withIds(['123-456-7890', '234-567-8901', '345-678-9012']);

處理客戶帳戶

擷取客戶帳戶後，您就能使用疊代器 hasNext 和 next 方法。您必須使用 select 方法，將執行內容切換至客戶帳戶。選取客戶帳戶將進一步套用 API 呼叫，直到您明確選取其他帳戶：

// Keep track of the manager account for future reference.
const managerAccount = AdsApp.currentAccount();

// Select your accounts
const accountIterator = AdsManagerApp.accounts()
// ... Write some logic here to select the accounts you want using
// withCondition or withIds

// Iterate through the list of accounts
for (const account of accountIterator) {
  // Select the client account.
  AdsManagerApp.select(account);

  // Select campaigns under the client account
  const campaignIterator = AdsApp.campaigns().get();

  // Operate on client account
  ...
}

同時處理帳戶

Google Ads 指令碼可讓您同時使用 executeInParallel 方法 ManagedAccountSelector 類別executeInParallel 方法具有下列簽章：

function executeInParallel(functionName, optionalCallbackFunctionName, optionalInput);

executeInParallel 方法會在 ManagedAccountSelector 比對的每個 ManagedAccount 上，執行 functionName 指定的函式。一旦所有的帳戶都處理完畢後，回呼函式就會系統會執行一次 optionalCallbackFunctionName 指定的清單，並傳遞清單 / ExecutionResult 物件做為引數，以進行後續處理。以下是常見用途：

function main() {
  const accountSelector = AdsManagerApp.accounts()
      .withLimit(50)
      .withCondition('customer_client.currency_code = "USD"');

  accountSelector.executeInParallel("processClientAccount", "afterProcessAllClientAccounts");
}

function processClientAccount() {
  const clientAccount = AdsApp.currentAccount();

  // Process your client account here.
  ...

  // optionally, return a result, as text.
  return "";
}

function afterProcessAllClientAccounts(results) {
  for (const result of results) {
    // Process the result further
    ...
  }
}

functionName 指定的函式可選擇接受字串引數 (optionalInput)。這個參數可用來傳送額外的參數加到 executeInParallel 呼叫的所有平行方法中：

function main() {
  const accountSelector = AdsManagerApp.accounts().withIds([1234567890, 3456787890]);
  const sharedParameter = "INSERT_SHARED_PARAMETER_HERE";
  accountSelector.executeInParallel("processClientAccount", null, sharedParameter);
}

function processClientAccount(sharedParameter) {
  // Process your client account here.
  ...
}

如果您想傳遞含有帳戶專屬設定的 JavaScript 設定物件，可以先使用 JSON.stringify 方法將其轉換為字串：

function main() {
  ...
  const accountFlags = {
    '1234567890': {
       'label': 'Brand 1 campaigns',
     },
    '3456787890': {
       'label': 'Brand 2 campaigns',
     }
  };
  accountSelector.executeInParallel("processClientAccount", null,
      JSON.stringify(accountFlags));
  ...
}

function processClientAccount(sharedParameter) {
  const accountFlags = JSON.parse(sharedParameter);
  // Process your client account here.
  ...
}

functionName 指定的函式也可以透過 JSON.stringify 傳回字串，而非物件：

function processClientAccount() {
  ...
  const jsonObj = {value: 10, list: [1,2,3,4,5,6], name: "Joe Smith"};
  return JSON.stringify(jsonObj);
}

傳回的值會傳送至 ExecutionResult 如需儲存大量結構化物件建議使用 Cloud Bigtable如果您從函式傳回 JSON 字串，可以使用 JSON.parse 方法將其轉換回 JavaScript 物件：

function callbackFunctionName(results) {
  for (var i = 0; i < results.length; i++) {
    var resultObj = JSON.parse(results[i].getReturnValue());
  }
}

executeInParallel 方法最多可運作 50 個 accounts，因此您必須實作自己的限制，以限制指令碼擷取的帳戶數量。您可以使用 withLimit 或 withIds 方法是 ManagedAccountSelector 類別，限制指令碼擷取的帳戶數量。

執行時間限制

請參閱這個頁面，瞭解進一步瞭解 Ads Manager 指令碼執行時間限制