Sử dụng mã tạm thời

Một tính năng mạnh mẽ của BatchJobService là hỗ trợ việc sử dụng mã nhận dạng tạm thời.

Bạn có thể thực hiện việc này bằng cách chỉ định resource_name của tài nguyên mới để sử dụng mã nhận dạng âm. Ví dụ: nếu tạo một chiến dịch và chỉ định tên tài nguyên là customers/<YOUR_CUSTOMER_ID>/campaigns/-1, thì khi tạo nhóm quảng cáo trong một thao tác sau này, bạn có thể tham chiếu nhóm quảng cáo đó theo tên tài nguyên đó và -1 bạn chỉ định sẽ tự động được thay thế bằng mã nhận dạng thực tế của chiến dịch đã tạo.

Sau đây là một số điều cần lưu ý khi sử dụng tên tài nguyên tạm thời:

• Bạn chỉ có thể sử dụng tên tài nguyên tạm thời sau khi tên đó được xác định trong tài nguyên. Trong ví dụ bên dưới, thao tác nhóm quảng cáo phải xuất hiện sau thao tác chiến dịch trong danh sách thao tác.
• Tên tài nguyên tạm thời không được ghi nhớ trên các công việc hoặc yêu cầu thay đổi; để tham chiếu đến một tài nguyên được tạo trong một công việc hoặc yêu cầu thay đổi trước đó, hãy sử dụng tên tài nguyên thực tế của tài nguyên đó.
• Đối với một công việc hoặc yêu cầu thay đổi, mỗi tên tài nguyên tạm thời phải sử dụng một số âm duy nhất, ngay cả khi chúng thuộc các loại tài nguyên khác nhau. Nếu một mã nhận dạng tạm thời được sử dụng lại trong một công việc hoặc yêu cầu thay đổi, thì lỗi sẽ được trả về.

Ví dụ:

Để đưa ra ví dụ cụ thể hơn về trường hợp nêu trên, giả sử bạn muốn thêm một chiến dịch, một nhóm quảng cáo và một quảng cáo trong một yêu cầu API. Bạn sẽ tạo một cấu trúc cho yêu cầu tương tự như sau:

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"
        ...
      }
    }
  },
]

Lưu ý rằng một mã tạm thời mới được dùng cho nhóm quảng cáo, vì chúng ta không thể sử dụng lại -1 mà chúng ta đã dùng cho chiến dịch. Chúng ta cũng tham chiếu nhóm quảng cáo này khi tạo quảng cáo nhóm quảng cáo. Bản thân nhóm quảng cáo tham chiếu đến tên tài nguyên mà chúng ta đã thiết lập cho chiến dịch trong một thao tác trước đó trong yêu cầu, trong khi resource_name trong ad_group_ad_operation là không cần thiết vì không có thao tác nào khác tham chiếu đến tên này.