Mã phản hồi trong API Search Ads 360
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nếu một yêu cầu gửi đến API Search Ads 360 thành công, thì API sẽ trả về một mã trạng thái HTTP 200 cùng với dữ liệu được yêu cầu trong phần nội dung của phản hồi.
Nếu một yêu cầu không xác thực được, API sẽ trả về một mã trạng thái HTTP từ 400 đến 499 cùng với nội dung mô tả lỗi xác thực.
Nếu bạn gửi một yêu cầu Report.get() hợp lệ nhưng Search Ads 360 không thể tạo báo cáo, thì API sẽ trả về một trong các mã trạng thái HTTP được mô tả bên dưới.
| Mã |
Lý do |
Mô tả |
Hành động được đề xuất |
410 |
reportUnavailableRequestTooLarge |
Báo cáo này không còn được xử lý nữa vì quá lớn. |
Thay vào đó, hãy yêu cầu nhiều báo cáo nhỏ hơn. Ví dụ: chia một báo cáo nhà quảng cáo thành nhiều báo cáo tài khoản công cụ. Hoặc chia một báo cáo dài một năm thành các báo cáo dài 12 tháng. |
410 |
reportUnavailableRateLimitExceeded |
Báo cáo này không còn được xử lý nữa vì dự án của nhà phát triển đã yêu cầu quá nhiều báo cáo trong một khoảng thời gian ngắn. |
Đảm bảo rằng ứng dụng của bạn không gửi yêu cầu thường xuyên hơn dự kiến.
Nếu khách hàng của bạn đang hoạt động như mong đợi, hãy liên hệ với bộ phận hỗ trợ khách hàng của Search Ads 360.
Cung cấp mã dự án của nhà phát triển, Mã và Lý do trong hàng bảng này (chứ không phải hàng bên dưới).
|
410 |
reportUnavailableQuotaExceeded |
Báo cáo này không còn được xử lý nữa vì dự án nhà phát triển đã yêu cầu quá nhiều dữ liệu hôm nay. |
Đảm bảo rằng ứng dụng của bạn không gửi các yêu cầu lớn hơn dự kiến. Bạn có thể theo dõi mức sử dụng hạn mức trong Google Cloud Console.
Nếu khách hàng của bạn đang hoạt động như mong đợi, hãy liên hệ với nhóm hỗ trợ khách hàng của Search Ads 360 để yêu cầu tăng hạn mức. Cung cấp mã dự án của nhà phát triển, Mã và Lý do trong hàng bảng này (chứ không phải hàng ở trên).
Ngoài ra, hãy xem phần Giá và giới hạn sử dụng.
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 không thể trả về hoặc tạo báo cáo vì một số lý do ngoài dự kiến. |
Liên hệ với nhóm hỗ trợ khách hàng của Search Ads 360. Cung cấp mã báo cáo của bạn.
|
410 |
reportUnavailableRequestError |
Mặc dù yêu cầu đã được xác thực, nhưng Search Ads 360 không thể tạo báo cáo được yêu cầu vì báo cáo đó chứa tổ hợp cột, bộ lọc và phân đoạn không hợp lệ. |
Liên hệ với bộ phận hỗ trợ khách hàng của Search Ads 360. Cung cấp mã báo cáo của bạn. |
400 |
unsupportedApiVersion |
Phiên bản không được hỗ trợ. |
Di chuyển sang Search Ads 360 Reporting API. |
Đối với tất cả các loại lỗi khác, API sẽ trả về Phản hồi lỗi tiêu chuẩn.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-12-05 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-12-05 UTC."],[[["\u003cp\u003eSearch Ads 360 API returns a \u003ccode\u003e200\u003c/code\u003e HTTP status code for successful requests and a status code between \u003ccode\u003e400\u003c/code\u003e and \u003ccode\u003e499\u003c/code\u003e for validation failures.\u003c/p\u003e\n"],["\u003cp\u003eIf a valid report request cannot be generated, the API returns a \u003ccode\u003e410\u003c/code\u003e status code with a specific reason, such as the report being too large, rate limit exceeded, or internal server error.\u003c/p\u003e\n"],["\u003cp\u003eFor report generation failures, recommended actions include requesting smaller reports, checking client request frequency, contacting support for quota increases, or reviewing report configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides detailed descriptions and recommended actions for each type of report generation failure, helping users troubleshoot and resolve issues effectively.\u003c/p\u003e\n"],["\u003cp\u003eFor other errors, refer to the Standard Error Responses documentation for guidance.\u003c/p\u003e\n"]]],["Successful Search Ads 360 API requests return a `200` status code. Validation failures result in `400-499` codes, with error descriptions. If report generation fails, `410` codes indicate issues like excessive size, rate limits, quota overages, internal errors, or invalid report specifications; each with specific resolution steps. A `400` error indicates an unsupported API version. Other errors follow standard error responses.\n"],null,["# Response Codes in the Search Ads 360 API\n\nIf a request to the Search Ads 360 API is **successful** , the API returns\na `200` HTTP status code along with the requested data in the body of the response.\n\nIf a request **fails to validate** , the API returns an HTTP status code between\n`400` and `499` along with a description of the validation error.\n\nIf you send a valid [`Report.get()`](/search-ads/v2/reference/reports/get)\nrequest but Search Ads 360 is **unable to generate a report**, the API returns\none of the HTTP status codes described below.\n\n| Code | Reason | Description | Recommended action |\n|------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 410 | reportUnavailableRequestTooLarge | The report is no longer being processed because the report is too large. | Request multiple smaller reports instead. For example, break a single advertiser report into multiple engine account reports. Or break a year-long report into 12 month long reports. |\n| 410 | reportUnavailableRateLimitExceeded | The report is no longer being processed because too many reports were requested by the developer project in a short amount of time. | Make sure your client isn't sending requests more frequently than you intend. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/3280641). Include your developer project ID, and the Code and Reason from this table row (and not the one below). |\n| 410 | reportUnavailableQuotaExceeded | The report is no longer being processed because too much data has been requested by the developer project today. | Make sure your client isn't sending larger requests than you intend. You can keep track of your quota usage in Google Cloud Console. If your client is performing as expected, [contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876) and ask for a quota increase. Include your developer project ID, and the Code and Reason from this table row (and not the one above). Also see [Pricing and Usage Limits](/pricing). |\n| 410 | reportUnavailableInternalServerError | Search Ads 360 is unable to return or generate the report for some unexpected reason. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 410 | reportUnavailableRequestError | Even though the request passed validation, Search Ads 360 cannot generate the requested report because it contains an invalid combination of columns, filters, and segmentations. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 400 | unsupportedApiVersion | Version not supported. | Migrate to the Search Ads 360 Reporting API. |\n\nFor all other types of errors, the API returns\n[Standard Error Responses](/search-ads/v2/standard-error-responses)."]]
