Mặc dù hầu hết các dịch vụ đều cung cấp API đồng bộ yêu cầu bạn đưa ra yêu cầu rồi chờ phản hồi, nhưng BatchJobService cung cấp một 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 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 biến đổ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 hỗn hợp gồm các chiến dịch, nhóm quảng cáo, quảng cáo, tiêu chí, nhãn và thành phần. 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 tốc độ. Google Ads API vẫn tính từng thao tác vào giới hạn thao tác hằng ngày của bạn, theo hướng dẫn đếm thao tác API.
BatchJobService cũng 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 công việc duy nhất.
Vận hành
BatchJobService hỗ trợ tất cả các thao tác được liệt kê trong MutateOperation mà dịch vụ cơ bản hỗ trợ lỗi một phần, cũng như AssetGroupOperation và AssetGroupListingGroupFilterOperation. Các thao tác này được miễn trừ rõ ràng và được thực thi (cùng với các thao tác phụ thuộc lẫn nhau có liên quan) trong các lô con nguyên tử.
Vì API Google Ads thực thi các thao tác tiêu chuẩn trong một công việc có bật lỗi một phần (ngoại trừ trong các lô con riêng lẻ), 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 đây trong MutateOperation phải là nguyên tử và không hỗ trợ lỗi một phần, vì vậy, các thao tác này không được hỗ trợ trong các công việc hàng loạt. Việc thêm bất kỳ thao tác nào trong số này vào một công việc hàng loạt sẽ trả về lỗi MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (hoặc InternalError.INTERNAL_ERROR cho BookCampaignsOperation và QuoteCampaignsOperation). Thay vào đó, hãy thực thi các thao tác này bằng cách sử dụng GoogleAdsService.Mutate với partial_failure được đặt thành false (và validate_only được đặt thành true cho QuoteCampaignsOperation).
Các thao tác không được hỗ trợ trong BatchJobService
BookCampaignsOperation(có trongMutateOperationtừ phiên bản 23)CampaignConversionGoalOperationConversionGoalCampaignConfigOperationCustomConversionGoalOperationCustomerConversionGoalOperationCustomerOperationQuoteCampaignsOperation(có trongMutateOperationkể từ phiên bản 23; yêu cầu bạn đặtvalidate_onlythànhtrue)