Kody odpowiedzi w interfejsie Search Ads 360 API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Jeśli żądanie do interfejsu Search Ads 360 API zakończy się pomyślnie, interfejs API zwróci kod stanu HTTP 200 wraz z żądanymi danymi w treści odpowiedzi.
Jeśli żądanie nie zostanie zweryfikowane, interfejs API zwróci kod stanu HTTP w zakresie 400–499 wraz z opisem błędu weryfikacji.
Jeśli wyślesz prawidłowe żądanie Report.get(), ale Search Ads 360 nie może wygenerować raportu, interfejs API zwróci jeden z kodów stanu HTTP opisanych poniżej.
| Kod |
Przyczyna |
Opis |
Zalecane działanie |
410 |
reportUnavailableRequestTooLarge |
Raport nie jest już przetwarzany, ponieważ jest za duży. |
Zamiast tego poproś o kilka mniejszych raportów. Możesz np. podzielić raport dotyczący jednego reklamodawcy na raporty dotyczące wielu kont wyszukiwarek. Możesz też podzielić raport roczny na 12 raportów miesięcznych. |
410 |
reportUnavailableRateLimitExceeded |
Raport nie jest już przetwarzany, ponieważ projekt dewelopera w krótkim czasie spowodował zbyt dużą liczbę żądań raportów. |
Upewnij się, że klient nie wysyła żądań częściej niż to konieczne.
Jeśli klient działa zgodnie z oczekiwaniami, skontaktuj się z zespołem pomocy Search Ads 360.
Podaj identyfikator projektu dewelopera oraz kod i przyczynę z tej wiersza tabeli (a nie z wiersza poniżej).
|
410 |
reportUnavailableQuotaExceeded |
Raport nie jest już przetwarzany, ponieważ projekt dewelopera poprosił o zbyt dużą ilość danych. |
Upewnij się, że klient nie wysyła większych zapytań niż to konieczne. Możesz śledzić wykorzystanie limitu w konsoli Google Cloud.
Jeśli klient osiąga oczekiwane wyniki, skontaktuj się z zespołem pomocy Search Ads 360 i poproś o zwiększenie limitu. Podaj identyfikator projektu dewelopera oraz kod i przyczynę z tej właśnie wierszy tabeli (a nie z wiersza powyżej).
Zobacz też Ceny i limity użytkowania.
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 nie może z nieoczekiwanego powodu zwrócić ani wygenerować raportu. |
Skontaktuj się z zespołem pomocy Search Ads 360 Podaj identyfikator zgłoszenia.
|
410 |
reportUnavailableRequestError |
Chociaż żądanie przeszło weryfikację, Search Ads 360 nie może wygenerować żądanego raportu, ponieważ zawiera on nieprawidłową kombinację kolumn, filtrów i podziałów na segmenty. |
Skontaktuj się z zespołem pomocy Search Ads 360 Podaj identyfikator zgłoszenia. |
400 |
unsupportedApiVersion |
Wersja nie jest obsługiwana. |
Przejdź na interfejs Search Ads 360 Reporting API. |
W przypadku wszystkich innych typów błędów interfejs API zwraca standardowe odpowiedzi na błędy.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-12-05 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
