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 tạo một 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 đồng bộ chờ các thao tác hoàn tất.
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 trong BatchJobService có thể hoạt động 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à mục trong nguồn cấp dữ liệu.
Các công việc đã gửi 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 độ. API Google Ads vẫn tính mỗi thao tác vào giới hạn thao tác hằng ngày theo hướng dẫn tính các 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 của mình để 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 thao tác được liệt kê trong MutateOperation, ngoại trừ một vài trường hợp ngoại lệ quan trọng.
Vì API Google Ads thực thi tất cả các thao tác trong một công việc có chế độ một phần lỗi được bật, 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 hoàn tá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 theo lô. Tránh thêm các đối tượng này vào công việc, hãy đặt partial_failure thành false trong các 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
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-03-29 UTC."],[[["`BatchJobService` enables asynchronous execution of multiple operations across various Google Ads services, reducing the need for synchronous waiting."],["It supports a wide range of operations, allowing you to manage campaigns, ad groups, ads, criteria, labels, and feed items within a single job."],["Failed operations due to transient errors like rate limits are automatically retried, ensuring higher reliability."],["Although it minimizes API requests and retries failed operations, using `BatchJobService` does not inherently guarantee improved performance; experimentation is crucial to determine its suitability for specific use cases."],["Certain atomic operations like `CampaignConversionGoalOperation`, `ConversionGoalCampaignConfigOperation`, `CustomConversionGoalOperation`, `CustomerConversionGoalOperation`, and `CustomerOperation` are not supported in batch jobs and should be executed using `GoogleAdsService` instead."]]],[]]
