参考資料

エラーとレート制限

REST エラーはこのエンベロープを使用します。サポートのためにリクエスト ID を保持し、API キーをログに記録しないでください。

コードと requestId から始めます

安定したコードはプログラムに何が起こったかを伝えます。人間が読めるメッセージでこのリクエストが説明されます。サポートに連絡するときに requestId を保存します。

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

401 の場合、ヘッダーが Bearer で始まり、その後に 1 つのスペースとアクティブキーが続くことを確認します。 403 の場合は、アカウントプランとキーの作成時に選択されたスコープを確認してください。

409 または 422 の場合は、PUT が完了し、Content-Type が一致し、アップロードされたバイト数が sizeBytes と等しいことを確認します。一時的な URL の有効期限が切れた場合は、新しいアップロードジョブを作成します。

コード	HTTP	意味
BAD_REQUEST	400 / 409	HTTP 400 は、リクエスト本文が無効であることを意味します。 HTTP 409 は、現在の状態ではアップロードを完了できないことを意味します。
UNAUTHORIZED	401	API キーが見つからないか、無効であるか、取り消されています。
PAID_PLAN_REQUIRED	403	アカウントには対象となる有料プランがありません。
INSUFFICIENT_SCOPE	403	API キーには必要なスコープが含まれていません。
NOT_FOUND	404	所有されているアップロード、ファイル、または共有が見つかりませんでした。
UPLOAD_NOT_READY	409	アップロードされたオブジェクトは完了する準備ができていません。
FILE_TOO_LARGE	413	ファイルが該当するサイズ制限を超えています。
OBJECT_VALIDATION_FAILED	422	アップロードされたオブジェクトは検証に失敗しました。
QUOTA_EXCEEDED	429	アップロード割り当てを使い果たしました。
RATE_LIMIT_EXCEEDED	429	API リクエストレートを使い果たしました。
SERVICE_UNAVAILABLE	503	必要なサービスが一時的に利用できなくなりました。

Retry-After の後にのみ 429 を再試行してください。一時的な 503 エラーを指数バックオフで再試行します。無効な 400、401、または 403 リクエストを自動的に再試行しません。