使用暫時 ID

BatchJobService 的強大功能在於支援使用暫時 ID。

如要這麼做，請指定新資源的 resource_name，使用負數 ID。舉例來說，假設您建立廣告活動，並將其資源名稱指定為 customers/<YOUR_CUSTOMER_ID>/campaigns/-1。您在後續作業中建立廣告群組時，可以透過該資源名稱參照廣告群組，系統會自動將您指定的 -1 替換為所建立廣告活動的實際 ID。

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

• 臨時資源名稱只能在資源中定義後使用。在下列範例中，廣告群組作業必須出現在作業清單中的廣告活動作業之後。
• 系統不會在工作或變更要求中記住臨時資源名稱。 如要參照先前作業或變更要求中建立的資源，請使用該資源的實際名稱。
• 如果是單一工作或變動要求，即使臨時資源名稱來自不同資源類型，也必須使用不重複的負數。如果單一工作或變動要求重複使用臨時 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"
        ...
      }
    }
  },
]

由於我們無法重複使用廣告活動的 -1，因此廣告群組會使用新的臨時 ID。建立廣告群組廣告時，我們也會參考這個廣告群組。廣告群組本身會參照我們在要求中較早作業為廣告活動建立的資源名稱，而 resource_name 則不需要，因為沒有其他作業會參照該名稱。ad_group_ad_operation