開発者ガイドの概要

Amazon Ads APIの概要

エラーレスポンスとエラーステータスコード

エラーレスポンス

これはエラーレスポンスオブジェクトの一般的な形式です。

{
    "title": "Error",
    "type": "object",
    "properties": {
       "code": {
           "description": "An enumerated error code for machine use",
           "type": "string"
       },
       "details": {
           "description": "A human-readable description of the error. ",
           "type": "string"
       }
    }
}

ステータスコード

サービスから返される可能性があるエラーコードを次に示します。これらのエラーコードはクライアントで処理する必要があります。

ステータスコード 注記
400 - Bad Request 他のどのカテゴリーにも該当しない一般的なリクエストエラー
401 - Unauthorized ユーザーが認証されていないため、リクエストが失敗しました
401 - No matching advertiser found for scope 指定されたスコープに一致する広告主が見つかりませんでした
401 - Scope header is missing Amazon-Advertising-API-Scopeヘッダーが存在しません
401 - Not authorized to access scope このプロフィールを管理する権限がありません。広告主からの許可と同意を確認してください
403 - Forbidden 指定されたリソースにユーザーがアクセスできないため、リクエストは失敗しました
404 - Not Found リクエストされたリソースが存在しないか、認証されたユーザーには表示可能でないリソースです
422 - Unprocessable Entity リクエストは解釈されましたが、誤ったパラメーターが含まれていました
429 - Too Many Requests リクエストはレート制限を受けました。後で再試行してください。
500 - Internal Error サーバーで問題が発生しました。後で再試行し、問題が解決されない場合はエラーを報告してください。
Amazon Advertising logo