Nội dung cập nhật về Chính sách sử dụng tài nguyên của Google Ads API

Thứ Tư, ngày 1 tháng 5 năm 2024

Điều gì sẽ thay đổi?

Chúng tôi sẽ cập nhật chính sách về mức sử dụng tài nguyên của API Google Ads để điều tiết các mẫu truy vấn GoogleAdsService.Search và GoogleAdsService.SearchStream sử dụng quá nhiều tài nguyên API. Nếu một mẫu truy vấn cụ thể bị điều tiết, thì các dịch vụ, phương thức và mẫu truy vấn khác sẽ tiếp tục hoạt động mà không bị ảnh hưởng.

Kể từ tuần bắt đầu từ ngày 17 tháng 6 năm 2024, và chỉ đối với các mẫu truy vấn bị hạn chế, các yêu cầu sẽ bị ảnh hưởng như sau:

  • Nếu sử dụng phiên bản v17 trở xuống của API, bạn sẽ gặp lỗi QuotaError.RESOURCE_EXHAUSTED.
  • Nếu sử dụng API phiên bản 18 trở lên, bạn sẽ nhận được lỗi QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION hoặc QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, tuỳ thuộc vào việc mức tiêu thụ tài nguyên quá mức là trong một khoảng thời gian ngắn (vài phút) hay trong một khoảng thời gian dài.

Để giúp bạn xác định và theo dõi các báo cáo tốn kém, chúng tôi cũng sẽ trả về một chỉ số chi phí cho từng báo cáo. Để xem chi phí cho các báo cáo thành công, hãy xem các trường sau:

Tại sao lại có sự thay đổi này?

Chúng tôi thực hiện thay đổi này để duy trì độ tin cậy và tính ổn định của API.

Việc bạn cần làm

Trước ngày 17 tháng 6 năm 2024, hãy cập nhật ứng dụng của bạn để thực hiện những việc sau:

  • Xử lý mã lỗi mới khi thực hiện lệnh gọi GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Nếu bạn sử dụng phiên bản v17 trở xuống của Google Ads API, hãy xử lý lỗi QuotaError.RESOURCE_EXHAUSTED.
    • Nếu bạn sử dụng phiên bản v18 trở lên của API, hãy xử lý lỗi QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION và QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Nếu một hoặc nhiều mẫu truy vấn báo cáo của bạn bị điều tiết, bạn nên xem xét và khắc phục mẫu truy vấn đó. Sau đây là một số cách để cải thiện hiệu suất truy vấn:
    • Giảm tần suất chạy truy vấn.
    • Sử dụng mẫu truy vấn hoặc chế độ xem ít tốn kém hơn.

Để tìm hiểu thêm về cách tối ưu hoá truy vấn, hãy xem bài viết quản lý hiệu quả dữ liệu.

  • [Không bắt buộc] Kết hợp chỉ số query_resource_consumption mới vào hệ thống giám sát để phát hiện và xử lý các truy vấn tốn kém mới.

Cách yêu cầu trợ giúp

Nếu bạn có câu hỏi về thay đổi này hoặc cần được trợ giúp để tối ưu hoá các mẫu truy vấn cụ thể, hãy xem trang hỗ trợ của Google Ads API để biết các lựa chọn.

– David Stevens, Nhà quản lý sản phẩm Google Ads API

Nhãn: google-ads-api