Search Ads 360 API でのレスポンス コード
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Search Ads 360 API へのリクエストが成功すると、API は 200 HTTP ステータス コードとリクエストされたデータを含むレスポンス本文を返します。
リクエストの検証に失敗した場合、API は 400～499 の HTTP ステータス コードと検証エラーの説明を返します。
有効な Report.get() リクエストを送信しても、Search Ads 360 でレポートを生成できない場合、API は以下のいずれかの HTTP ステータス コードを返します。
| コード |
理由 |
説明 |
推奨される対応 |
410 |
reportUnavailableRequestTooLarge |
レポートが大きすぎるため、レポートの処理が停止されています。 |
代わりに、複数の小さなレポートをリクエストしてください。たとえば、1 つの広告主レポートを複数のエンジン アカウント レポートに分割します。または、1 年間のレポートを 12 か月間のレポートに分割することもできます。 |
410 |
reportUnavailableRateLimitExceeded |
デベロッパー プロジェクトから短時間にリクエストされたレポートが多すぎるため、レポートの処理は停止されています。 |
クライアントが意図したよりも頻繁にリクエストを送信していないことを確認します。
クライアントが想定どおりに動作している場合は、検索広告 360 カスタマー サポートにお問い合わせください。デベロッパー プロジェクト ID、この表の行のコードと理由（下の行ではありません）を記載します。
|
410 |
reportUnavailableQuotaExceeded |
デベロッパー プロジェクトから今日リクエストされたデータが多すぎるため、レポートの処理は停止されています。 |
クライアントが意図したよりも大きなリクエストを送信していないことを確認します。割り当て使用量は Google Cloud コンソールで確認できます。
クライアントのパフォーマンスが期待どおりの場合は、検索広告 360 カスタマー サポートにお問い合わせのうえ、割り当ての増加をリクエストしてください。デベロッパー プロジェクト ID、この表の行のコードと理由（上記の行ではなく）を含めます。
料金と使用上限もご覧ください。
|
410 |
reportUnavailableInternalServerError |
予期しない理由により、検索広告 360 でレポートを返したり生成したりできない。 |
検索広告 360 カスタマー サポートにお問い合わせください。レポート ID を記載してください。
|
410 |
reportUnavailableRequestError |
リクエストは検証に合格しましたが、列、フィルタ、セグメンテーションの組み合わせが無効であるため、検索広告 360 でリクエストされたレポートを生成できません。 |
検索広告 360 カスタマー サポートにお問い合わせください。レポート ID を記載してください。 |
400 |
unsupportedApiVersion |
サポートされていないバージョンです。 |
Search Ads 360 Reporting API に移行します。 |
他のすべてのタイプのエラーの場合、API は標準エラー レスポンスを返します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-05 UTC。
[null,null,["最終更新日 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)."]]
