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

Một tính năng mạnh mẽ của BatchJobService là có 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 phủ định. Ví dụ: nếu bạn tạo một chiến dịch và chỉ định tên tài nguyên của chiến dịch dưới dạng customers/<YOUR_CUSTOMER_ID>/campaigns/-1, thì khi bạn tạo nhóm quảng cáo trong 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 mà bạn đã chỉ định sẽ được thay thế bằng mã thực tế của chiến dịch đã tạo tự động.

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:

• 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 nguồn. Trong ví dụ bên dưới, hoạt động của nhóm quảng cáo sẽ phải xuất hiện sau hoạt động của chiến dịch trong danh sách hoạt động.
• Tên tài nguyên tạm thời không được ghi nhớ trong các công việc hoặc các yêu cầu thay đổi; để tham chiếu một tài nguyên được tạo trong một công việc trước đó hoặc yêu cầu thay đổi, hãy sử dụng tên tài nguyên thực tế.
• Đối với một yêu cầu 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 số âm duy nhất, ngay cả khi chúng từ 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 yêu cầu công việc hoặc yêu cầu thay đổi, sau đó xảy ra lỗi bị trả về.

Ví dụ:

Để có ví dụ cụ thể hơn cho trường hợp nêu trên, giả sử bạn muốn thêm chiến dịch, nhóm quảng cáo và quảng cáo trong một yêu cầu API duy nhất. Bạn sẽ tạo một cấu trúc cho yêu cầu của bạn 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"
        ...
      }
    }
  },
]

Xin lưu ý rằng mã nhận dạng tạm thời mới được sử dụng cho nhóm quảng cáo, vì chúng tôi không thể sử dụng lại -1 mà chúng tôi đã sử dụng cho chiến dịch, đồng thời chúng tôi cũng tham chiếu đến nhóm quảng cáo này khi tạo một 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 tôi được thiết lập cho chiến dịch trong thao tác trước đó trong yêu cầu, trong khi Không cần resource_name trong ad_group_ad_operation vì không có gì khác tham chiếu đến nó.