Google Ads API áp dụng các giới hạn đối với các 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 đột biến duy nhất. Bảng sau đây tóm tắt một số hạn mức và giới hạn quan trọng mà bạn cần lưu ý.
| Loại yêu cầu, hạn chế và mã lỗi | ||
|---|---|---|
| Các thao tác ở cấp truy cập cơ bản | 15.000 thao tác API mỗi ngày |
RESOURCE_EXHAUSTED
|
| Yêu cầu thay đổi | 10.000 thao tác cho mỗi yêu cầu |
TOO_MANY_MUTATE_OPERATIONS
|
| Yêu cầu về 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 về 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 về dịch vụ lập hoá đơn và ngân sách tài khoản | 1 thao tác cho mỗi yêu cầu biến đổi |
TOO_MANY_MUTATE_OPERATIONS
|
Hạn mức thao tác API hằng ngày
Giới hạn sử dụng API hằng ngày dựa trên số lượng thao tác API được thực hiện trên mỗi mã thông báo nhà phát triển. Các thao tác API là tổng số yêu cầu nhận và thao tác biến đổi. Giới hạn cho các thao tác API hằng ngày phụ thuộc vào cấp độ truy cập của mã thông báo nhà phát triển. Hướng dẫn về cấp truy cập và việc sử dụng được phép nêu rõ 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 các giới hạn này sẽ bị từ chối và báo lỗi: RESOURCE_EXHAUSTED.
Giới hạn của gRPC
Tất cả thư viện ứng dụng Google Ads API đề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ông báo là 4 MB, nhưng các thư viện ứng dụng của chúng tôi đặt kích thước thông báo tối đa là 64 MB để tăng hiệu quả.
Các phản hồi không được vượt quá giới hạn này. Ví dụ: một yêu cầu tìm kiếm có nhiều trường có thể tạo ra một phản hồi có kích thước vượt quá 64 MB. Để tránh giới hạn này, bạn có thể giảm số lượng trường đã chọn hoặc sử dụng truyền trực tuyến. Đối với các thao tác biến đổi, hãy gửi ít thao tác hơn 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 GoogleAdsError mà sẽ tạo ra lỗi 429 Resource Exhausted gRPC. Tham khảo danh sách mã lỗi và thông báo gRPC.
Yêu cầu thay đổi
Ngoài việc được tính vào hạn mức thao tác hằng ngày của người dùng, một yêu cầu mutate không được chứa quá 10.000 thao tác cho 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 và báo lỗi: TOO_MANY_MUTATE_OPERATIONS.
Các giới hạn và điểm cần cân nhắc khác đối với một số dịch vụ và loại yêu cầu cụ thể sẽ được trình bày tiếp theo.
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 trong hạn mức thao tác hằng ngày của người dùng. 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 phân trang
Các yêu cầu được phân trang (ví dụ: các yêu cầu chứa một next_page_token hợp lệ) 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 chứa mã thông báo trang không hợp lệ hoặc đã hết hạn sẽ tạo ra một ngoại lệ và được tính vào hạn mức hoạt động hằng ngày.
Để biết thêm thông tin về việc phân trang, hãy tham khảo phần Phân trang qua kết quả.
Các loại yêu cầu khác
Một 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 trong hạn mức thao tác hằng ngày của người dùng.
Sau đây là một số ví dụ về những yêu cầu như vậy:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Các yêu cầu trả về ngoại lệ API
Các yêu cầu bị từ chối bằng GoogleAdsFailure vẫn được tính vào hạn mức thao tác hằng ngày của người dùng.
Những yêu cầu không thành công nhưng không trả về GoogleAdsFailure, chẳng hạn như do lỗi ở cấp mạng, sẽ không được tính vào hạn mức thao tác 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ụ về trường hợp này là lỗi kết nối mạng.
Dịch vụ lập kế hoạch từ khoá
Do chi phí và độ phức tạp, các phương thức sau đây của dịch vụ Lập kế hoạch từ khoá phải tuân theo các hạn mức riêng biệt so với các loại yêu cầu khác.
Giới hạn ở 1 yêu cầu mỗi giây cho mỗi CID:
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
Những yêu cầu vi phạm các giới hạn này sẽ bị từ chối và báo lỗi:
RESOURCE_EXHAUSTED.1 QPS được tính là 60 yêu cầu trong 60 giây.
Giới hạn ở mức 2 yêu cầu mỗi giây cho mỗi mã khách hàng:
Hãy lưu ý những hạn mức này khi tạo kế hoạch từ khoá.
| Đối tượng Kế hoạch từ khoá | Số lượng 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ụ thông tin chi tiết về đối tượng
Các phương thức sau đây trong các phương thức AudienceInsightsService phải tuân theo hạn mức cụ thể.
Giới hạn khoảng 200 yêu cầu mỗi ngày cho mỗi CID:
Giới hạn ở 2 yêu cầu mỗi giây cho mỗi mã thông báo của nhà phát triển:
Dịch vụ tải lượt chuyển đổi lên
Giới hạn 2.000 lượt chuyển đổi cuộc gọi hoặc lượt nhấp cho mỗi yêu cầu:
Những yêu cầu vi phạm các giới hạn này sẽ bị từ chối và báo lỗi:
TOO_MANY_CONVERSIONS_IN_REQUEST.
Dịch vụ tải mức điều chỉnh cho lượt chuyển đổi lên
Giới hạn 2.000 mức điều chỉnh lượt chuyển đổi cho mỗi yêu cầu:
Những yêu cầu vi phạm các giới hạn này sẽ bị từ chối và báo lỗi:
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Dịch vụ thanh toán và ngân sách tài khoản
Bạn chỉ có thể thực hiện các thao tác biến đổi đối với những tài khoản được thiết lập để 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 và báo lỗi:
MUTATE_NOT_ALLOWED.Bạn chỉ được phép thực hiện 1 thao tác cho các yêu cầu biến đổi.
Những yêu cầu vi phạm giới hạn này sẽ bị từ chối và báo lỗi:
TOO_MANY_MUTATE_OPERATIONS.Bạn nên đợi ít nhất 12 giờ giữa các lần thay đổi đơn đặt hàng ngân sách cho cùng một tài khoản. Nếu bạn thực hiện thay đổi trước khi hết 12 giờ, thì có thể xảy ra lỗi không thể khắc phục. Bạn chỉ có thể giải quyết lỗi này bằng cách liên hệ với người đại diện tài khoản Google Ads của mình.
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 cách sử dụng biểu tượng CustomerUserAccessService. Vì tính năng này gửi email mời đến những người dùng khác, nên có khả năng bị sử dụng sai. Do đó, có những hạn chế đối với hành vi của tính năng này:
Người dùng không thể nhận nhiều lời mời đang chờ xử lý cho cùng một tài khoản khách hàng. Nếu một yêu cầu tiếp theo được thực hiện để gửi lời mời đến một người dùng đã có lời mời đang chờ xử lý, thì 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 bạn gửi một yêu cầu khiến giá trị này bị vượt quá, thì lỗi này sẽ được trả về:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Dữ liệu người dùng
Dữ liệu người dùng được quản lý bằng UserDataService và OfflineUserDataJobService.
Trong một thao tác tạo hoặc xoá UserData nhất định, mỗi tập hợp user_identifiers phải dành riêng cho một người dùng.
Để thực thi điều này, lỗi OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS hoặc UserDataError.TOO_MANY_USER_IDENTIFIERS sẽ được trả về khi có hơn 20 user_identifiers trong một tập hợp UserData.
Bạn được phép có tối đa 100.000 mã nhận dạng người dùng,bất kể số lượng thao tác.
Các loại giới hạn 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 yêu cầu có thể gây ra lỗi: REQUEST_SIZE_LIMIT_EXCEEDED.
Thông báo lỗi này cũng có thể do các vấn đề khác gây ra.
Nếu bạn gặp phải giới hạn này và đang đưa ra các yêu cầu sử dụng một trường 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 danh sách các thao tác trong một yêu cầu biến đổi.
Khi thực hiện một truy vấn GAQL, số lượng mục tối đa trong một mệnh đề IN là 20.000. Nếu vượt quá giới hạn đó, một lỗi FILTER_HAS_TOO_MANY_VALUES sẽ được trả về.