使用暫時 ID

BatchJobService 的其中一項強大功能，就是 支援使用臨時 ID

只要將新資源的 resource_name 指定為使用 排除 ID。舉例來說，假設您建立了一個廣告活動並指定其資源名稱 做為 customers/<YOUR_CUSTOMER_ID>/campaigns/-1 傳送，然後在建立 建立廣告群組時，您可以使用該資源名稱 您指定的-1將替換成已建立廣告活動的實際 ID 。

使用臨時資源名稱時，請注意下列事項：

• 臨時資源名稱必須先在 資源。在下列範例中，廣告群組作業必須 列出作業。
• 系統不會記住工作或 Mutate 請求的臨時資源名稱； 來參照先前工作或修改請求中建立的資源，請使用其 實際的資源名稱
• 如果是單一工作或 MCM 請求，每個臨時資源名稱都必須使用 不重複的負數，即使執行個體來自不同的資源類型也一樣。如果 在單一工作或 變更 請求中重複使用一個臨時 ID， 。

範例

為了讓上述情況提供您更具體的範例， 如何透過單一 API 要求新增廣告活動、廣告群組和廣告。個人中心 會為您的要求建立類似以下的結構：

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

請注意，廣告群組會使用新的暫時 ID，因為我們無法重複使用 我們為廣告活動所用的-1；在下列情況中，我們也會參照這個廣告群組 製作廣告群組廣告。廣告群組本身會參照資源名稱 在請求中較早作業的情況下建立的廣告活動，而 ad_group_ad_operation不需要resource_name，因為已無進一步 都會參照這個編號