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
sẽ cung cấp cách thực hiện nhiều thao tác trên nhiều dịch vụ mà không cần chờ các thao tác hoàn tất một cách đồng bộ.
Không giống như các thao tác thay đổi dành riêng cho dịch vụ, một công việc duy nhất trong BatchJobService
có thể hoạt động dựa trên một tập hợp kết hợp gồm nhiều chiến dịch, nhóm quảng cáo, quảng cáo, tiêu chí, nhãn và mục nguồn cấp dữ liệu.
Các công việc đã gửi sẽ chạy song song và BatchJobService
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 mỗi 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 cách tính hoạt động 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 để có thể gửi các thao tác phụ thuộc trong một tác vụ duy nhất.
Hoạt động tính toán
BatchJobService
hỗ trợ tất cả các thao tác được liệt kê trong MutateOperation
, với một vài ngoại lệ quan trọng.
Vì API Google Ads thực thi tất cả thao tác trong một công việc được bật lỗi một phần, nên nếu một công việc bị huỷ hoặc các 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 khôi phục.
Các thao tác sau trong MutateOperation
phải là nguyên tử, do đó, không hỗ trợ lỗi một phần và không được hỗ trợ trong các công việc hàng loạt. Tránh thêm chúng vào công việc của bạn, đặt partial_failure
thành false
trong yêu cầu và sử dụng phương thức mutate
trong GoogleAdsService
.
Các thao tác không được hỗ trợ trong BatchjobService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation