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

Một tính năng mạnh mẽ của BatchJobService là hỗ trợ 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ột mã nhận dạng âm. 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 là customers/<YOUR_CUSTOMER_ID>/campaigns/-1, thì khi tạo nhóm quảng cáo cho hoạt động sau này, bạn có thể tham chiếu đến nhóm quảng cáo theo tên tài nguyên đó và -1 mà bạn đã chỉ định sẽ được tự động 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 đã xác định tên đó trong một tài nguyên. Trong ví dụ bên dưới, hoạt động nhóm quảng cáo sẽ phải xuất hiện sau hoạt động 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 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ế 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 tên đó thuộc các loại tài nguyên khác nhau. Nếu 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ì hệ thống sẽ trả về một lỗi.

Ví dụ:

Để đưa ra 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 vào 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 mình 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 sẽ được dùng cho nhóm quảng cáo, vì chúng tôi không thể sử dụng lại -1 đã 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 quảng cáo trong nhóm quảng cáo. Bản thân nhóm quảng cáo sẽ tham chiếu đến tên tài nguyên mà chúng tôi đã thiết lập cho chiến dịch ở hoạt động 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ó hoạt động nào khác đang tham chiếu đến tài nguyên đó.