Hạn mức và hạn mức API

API Google Ads thực thi các giới hạn về thao tác API, chẳng hạn như số lượng thao tác có thể được gửi trong một yêu cầu thay đổi duy nhất. Bảng dưới đây tóm tắt một số giới hạn và hạn mức quan trọng cần lưu ý.

Loại yêu cầu, giới hạn và mã lỗi
Yêu cầu được phân trang 10.000 hàng mỗi trang INVALID_PAGE_SIZE
Thao tác có Quyền truy cập cơ bản 15.000 hoạt động API mỗi ngày RESOURCE_EXHAUSTED
Thay đổi yêu cầu 10.000 thao tác trên mỗi yêu cầu TOO_MANY_MUTATE_OPERATIONS
Yêu cầu Dịch vụ lập kế hoạch 1 QPS (số lần truy vấn mỗi giây) RESOURCE_EXHAUSTED
Yêu cầu Dịch vụ tải lượt chuyển đổi lên 2.000 lượt chuyển đổi cho mỗi yêu cầu TOO_MANY_CONVERSIONS_IN_REQUEST
Yêu cầu Dịch vụ ngân sách tài khoản và thanh toán 1 thao tác cho mỗi yêu cầu thay đổi TOO_MANY_MUTATE_OPERATIONS

Giới hạn hoạt động API hằng ngày

Hạn mức sử dụng API hằng ngày dựa trên số lượng API hoạt động được thực hiện theo mã của nhà phát triển. API Toán tử là tổng số yêu cầu get và phép toán thay đổi. Giới hạn cho các hoạt động API hằng ngày tuỳ thuộc vào cấp truy cập của mã của nhà phát triển. Chiến lược phát hành đĩa đơn Hướng dẫn về cấp truy cập và trường hợp sử dụng được phép trình bày các thông tin giới hạn hoạt động cụ thể của API cho từng cấp truy cập.

Những yêu cầu vi phạm những giới hạn này sẽ bị từ chối kèm theo lỗi: RESOURCE_EXHAUSTED.

Các hạn chế của gRPC

Tất cả thư viện ứng dụng của API Google Ads đều sử dụng gRPC để tạo yêu cầu và phản hồi. Theo mặc định, gRPC có kích thước thư là 4 MB, nhưng thư viện ứng dụng khách của chúng tôi đặt kích thước thư tối đa thành 64 MB để tăng tính hiệu quả.

Số lượng câu trả lời không được vượt quá giới hạn này. Ví dụ: yêu cầu tìm kiếm bao gồm nhiều trường có thể tạo ra phản hồi có kích thước vượt quá 64 MB. Người nhận để tránh giới hạn này, bạn có thể giảm số lượng trường được chọn, giảm số lượng trang kích thước hoặc sử dụng tính năng phát trực tuyến. Đối với những người thay đổi, hãy gửi ít hơn thao tác trên mỗi yêu cầu.

Những yêu cầu vi phạm giới hạn này sẽ không tạo ra một GoogleAdsError, nhưng sẽ tạo một 429 Resource Exhausted Lỗi gRPC. Tham khảo danh sách mã lỗi gRPC và tin nhắn.

Thay đổi yêu cầu

Ngoài việc tính vào hạn mức hoạt động hàng ngày của người dùng, có một sự thay đổi yêu cầu không được chứa nhiều hơn 10.000 thao tác trong mỗi yêu cầu.

Những yêu cầu vi phạm giới hạn này sẽ bị từ chối kèm theo lỗi: TOO_MANY_MUTATE_OPERATIONS.

Các giới hạn và lưu ý bổ sung đối với các dịch vụ và loại yêu cầu cụ thể là trình bày bên dưới.

Yêu cầu tìm kiếm

Yêu cầu Search hoặc SearchStream được tính là một thao tác so với yêu cầu của người dùng hạn mức hoạt động hằng ngày. Một yêu cầu SearchStream được tính là một thao tác API bất kể số lượng lô.

Yêu cầu được phân trang

Các yêu cầu được phân trang (ví dụ: các yêu cầu chứa thẻ next_page_token) không được tính vào hạn mức hoạt động hằng ngày của người dùng. Tuy nhiên, các yêu cầu phân trang có chứa mã thông báo trang đã hết hạn hoặc không hợp lệ sẽ tạo ra một ngoại lệ và sẽ được tính vào hạn mức hoạt động hằng ngày.

Yêu cầu được đánh số trang, chẳng hạn như yêu cầu tìm kiếm, cũng phải tuân theo Page size cannot exceed 10,000 rows giới hạn và sẽ bị từ chối nếu vi phạm giới hạn này, kèm theo lỗi: INVALID_PAGE_SIZE.

Để biết thêm thông tin chi tiết về tính năng phân trang, hãy tham khảo bài viết Phân trang kết quả.

Các loại yêu cầu khác

Yêu cầu không phải là yêu cầu Get, Mutate, Search hoặc SearchStream sẽ được tính là một thao tác vào hạn mức thao tác hằng ngày của người dùng.

Sau đây là một vài ví dụ về những yêu cầu như vậy:

Yêu cầu trả về ngoại lệ đối với API

Yêu cầu bị từ chối bằng GoogleAdsFailure vẫn được tính vào hạn mức hoạt động hàng ngày của người dùng.

Yêu cầu không thành công nhưng không trả về GoogleAdsFailure, chẳng hạn như từ một lỗi ở ở cấp độ mạng sẽ không được tính vào hạn ngạch hoạt động hàng ngày của người dùng vì các yêu cầu sẽ không bao giờ đến được dịch vụ. Ví dụ: lỗi kết nối mạng.

Dịch vụ lập kế hoạch

Do chi phí và tính phức tạp, nên các phương thức dịch vụ Lập kế hoạch trong danh sách dưới đây sẽ tuân theo các giới hạn riêng biệt với các loại yêu cầu khác.

Xin lưu ý những giới hạn này khi tạo kế hoạch từ khoá.

Đối tượng kế hoạch từ khoá Số tối đa
KeywordPlan cho mỗi tài khoản 10.000
KeywordPlanAdGroup mỗi KeywordPlan 200
KeywordPlanAdGroupKeyword mỗi KeywordPlan 10.000
KeywordPlanCampaignKeyword (từ khoá phủ định) 1.000
KeywordPlanCampaign mỗi KeywordPlan 1

Dịch vụ tải lượt chuyển đổi lên

Dịch vụ tải mức điều chỉnh lượt chuyển đổi lên

Dịch vụ thanh toán và ngân sách tài khoản

  • Bạn chỉ có thể thay đổi các tài khoản được thiết lập để sử dụng phương thức lập hoá đơn hằng tháng.

    Những yêu cầu vi phạm giới hạn này sẽ bị từ chối kèm theo lỗi: MUTATE_NOT_ALLOWED.

  • Bạn chỉ được phép thực hiện thao tác 1 đối với các yêu cầu thay đổi.

    Những yêu cầu vi phạm giới hạn này sẽ bị từ chối kèm theo lỗi: TOO_MANY_MUTATE_OPERATIONS.

  • Bạn nên đợi ít nhất 12 giờ giữa các lần thay đổi ngân sách đặt hàng cùng một tài khoản. Việc thực hiện các thay đổi trước khi 12 giờ trôi qua có thể dẫn đến lỗi không thể khôi phục (chỉ có thể giải quyết bằng tài khoản Google Ads của bạn) của chúng tôi.

Lời mời đến tài khoản khách hàng

Bạn có thể mời người dùng mới vào tài khoản khách hàng hiện có bằng CustomerUserAccessService. Bởi vì chức năng này gửi email mời tới người dùng khác, chức năng này có khả năng bị lạm dụng và do đó có các hạn chế đối với hành vi của mã:

  • Người dùng không thể nhận được nhiều lời mời đang chờ xử lý cho cùng một khách hàng tài khoản. Nếu một yêu cầu tiếp theo được thực hiện để gửi lời mời đến người dùng đã có lời mời đang chờ xử lý, lỗi này sẽ được trả về: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.

  • Tài khoản khách hàng không thể có nhiều hơn 70 lời mời đang chờ xử lý cùng một lúc. Nếu một yêu cầu được gửi khiến giá trị này bị vượt quá, thì lỗi này sẽ trả về: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Dữ liệu người dùng

Bạn có thể quản lý dữ liệu người dùng bằng UserDataService và OfflineUserDataJobService. Trong một thao tác tạo/xoá UserData nhất định, mỗi thao tác tập hợp user_identifiers phải dành riêng cho một người dùng.

Để thực thi việc này, OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS hoặc UserDataError.TOO_MANY_USER_IDENTIFIERS được trả về khi có nhiều hơn 20 user_identifiers trong một Bộ UserData.

Các loại hạn mức khác

Một trường lặp lại, chẳng hạn như danh sách các thao tác, có quá nhiều mục trong một có thể gặp lỗi: REQUEST_SIZE_LIMIT_EXCEEDED. Thông báo lỗi tương tự này cũng có thể là do các vấn đề khác.

Nếu bạn gặp phải hạn chế này và đang thực hiện các yêu cầu sử dụng hàm lặp lại hãy thử giảm số lượng mục trong trường lặp lại bằng cách triển khai một danh sách thao tác trong yêu cầu thay đổi.

Khi tạo một truy vấn GAQL, số mục tối đa trong mệnh đề IN là 20.000. Nếu vượt quá giới hạn đó, FILTER_HAS_TOO_MANY_VALUES sẽ bị trả về lỗi.

Trước
Kiểm tra
Tiếp
Giới hạn của hệ thống