使用临时 ID

BatchJobService 的一项强大功能是支持使用临时 ID。

为此，您可以指定新资源的 resource_name 以使用负 ID。例如，假设您创建了一个广告系列，并将其资源名称指定为 customers/<YOUR_CUSTOMER_ID>/campaigns/-1。在后续操作中创建广告组时，您可以使用该资源名称引用该广告组，并且您指定的 -1 将自动替换为所创建广告系列的实际 ID。

使用临时资源名称时，请注意以下事项：

• 临时资源名称只能在资源中定义后使用。在下例的操作列表中，广告组操作必须显示在广告系列操作之后。
• 系统无法跨作业或 mutate 请求记住临时资源名称。如需引用在之前的作业或变异请求中创建的资源，请使用其真实的资源名称。
• 对于单个作业或 mutate 请求，每个临时资源名称都必须使用具有唯一性的负数，即使它们来自不同的资源类型。如果在单个作业或 mutate 请求中重复使用临时 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 则不是必需的，因为没有进一步的操作会引用它。