Mặc dù hầu hết dịch vụ đều cung cấp API đồng bộ, đòi hỏi bạn phải đưa ra yêu cầu rồi chờ phản hồi, nhưng BatchJobService cung cấp cách thực hiện hàng loạt thao tác trên nhiều dịch vụ mà không cần đồng bộ chờ các thao tác đó hoàn tất.
Không giống như hoạt động thay đổi theo dịch vụ, một công việc trong BatchJobService có thể hoạt động dựa trên tập hợp hỗn hợp các chiến dịch, nhóm quảng cáo, quảng cáo, tiêu chí, nhãn và mục trong nguồn cấp dữ liệu.
Các công việc đã gửi sẽ chạy song song và BatchJobService sẽ tự động thử lại các thao tác không thành công do lỗi tạm thời, chẳng hạn như lỗi giới hạn số lượng yêu cầu. API Google Ads vẫn
tính từng thao tác vào
giới hạn hoạt động hằng ngày của bạn theo hướng dẫn tính
thao tác API.
Ngoài ra, BatchJobService cho phép bạn sử dụng mã nhận dạng tạm thời trong các yêu cầu để bạn có thể gửi các thao tác phụ thuộc trong một công việc.
Hoạt động tính toán
BatchJobService hỗ trợ tất cả các hoạt động được liệt kê trong MutateOperation, với một số ngoại lệ quan trọng.
Vì API Google Ads thực thi tất cả các hoạt động trong một công việc có lỗi một phần được bật, nên nếu một công việc bị huỷ hoặc một thao tác riêng lẻ không thành công, thì các thao tác thành công sẽ không được hoàn nguyên.
Các toán tử sau đây trong MutateOperation phải không nguyên tử, do đó, không hỗ trợ lỗi một phần và không được hỗ trợ trong các tác vụ hàng loạt. Tránh thêm chúng vào công việc, hãy đặt partial_failure thành false trong các yêu cầu và chuyển sang sử dụng phương thức mutate trong GoogleAdsService.
Các thao tác không được hỗ trợ trong BatchJobService
AssetGroupOperationCampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperation