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

Tên tài nguyên tạm thời

BatchJobService hỗ trợ tên tài nguyên tạm thời có thể được tham chiếu trong các thao tác tiếp theo trong cùng một lô công việc, bao gồm cả trên nhiều yêu cầu AddBatchJobOperations tuần tự được tải lên bằng một sequence_token. Điều này cho phép bạn tạo một chiến dịch và các nhóm quảng cáo, quảng cáo và tiêu chí phụ thuộc của chiến dịch đó trong một công việc hàng loạt duy nhất trước khi mã nhận dạng phía máy chủ được chỉ định. Trong các quy tắc chung và ví dụ sau đây, một yêu cầu duy nhất đề cập đến toàn bộ BatchJob trên tất cả nội dung tải lên AddBatchJobOperations.

Bạn có thể làm 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ụ: giả sử 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. Khi tạo nhóm quảng cáo trong một thao tác sau đó, 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ẽ 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 một tài nguyên. Trong ví dụ sau, thao tác nhóm quảng cáo sẽ 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 lưu lại trên các yêu cầu về công việc hoặc yêu cầu biến đổi. Để tham chiếu một tài nguyên được tạo trong công việc hoặc yêu cầu thay đổi tài nguyên 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 yêu cầu đơn lẻ về công việc hoặc yêu cầu thay đổi tài nguyên, mỗi tên tài nguyên tạm thời phải sử dụng một số âm riêng biệt, ngay cả khi chúng thuộc các loại tài nguyên khác nhau. Nếu một mã tạm thời được dùng lại trong một yêu cầu đơn lẻ hoặc yêu cầu thay đổi tài nguyên, thì sẽ có lỗi trả về.

Ví dụ

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

Một mã tạm thời mới được 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 đã dùng cho chiến dịch. Chúng tôi 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 nhóm quảng cáo đó.

Xử lý lỗi trong các lô công việc

Vì các thao tác tiêu chuẩn trong một tác vụ hàng loạt sẽ thực thi khi bật lỗi một phần (ngoại trừ trong các lô con nguyên tử), nên nếu một tài nguyên mẹ có mã tạm thời không xác thực được, thì mọi thao tác con phụ thuộc tham chiếu đến mã tạm thời đó sẽ không thành công với NewResourceCreationError.TEMP_ID_RESOURCE_HAD_ERRORS. Việc sử dụng lại cùng một mã nhận dạng âm trên nhiều thao tác create trong cùng một lô công việc sẽ trả về NewResourceCreationError.DUPLICATE_TEMP_IDS. Mã tạm thời chỉ hợp lệ khi tạo tài nguyên (create) hoặc tham chiếu đến tài nguyên mẹ mới tạo; ví dụ: truyền mã tạm thời âm trong AdGroupCriterionOperation.remove khi gọi AddBatchJobOperations sẽ trả về RequestError.RESOURCE_NAME_MALFORMED.