Google Drive API は、次の 2 つのエラー情報を返します。
- HTTP エラーコードとヘッダー メッセージ。
- エラーの処理方法を判断するのに役立つ追加の詳細情報を含むレスポンス本文の JSON オブジェクト。
Google ドライブ アプリは、REST API の使用時に発生する可能性のあるすべてのエラーをキャッチして処理する必要があります。このガイドでは、特定の Drive API エラーを解決する方法について説明します。
HTTP ステータス コードの概要
| エラーコード | 説明 | 
|---|---|
| 200 - OK | リクエストが成功しました(これは、成功した HTTP リクエストの標準レスポンスです)。 | 
| 400 - Bad Request | リクエストのクライアント エラーのため、リクエストを処理できません。 | 
| 401 - Unauthorized | リクエストに無効な認証情報が含まれています。 | 
| 403 - Forbidden | リクエストは受信され、理解されましたが、ユーザーにはリクエストを実行する権限がありません。 | 
| 404 - Not Found | リクエストされたページが見つかりませんでした。 | 
| 429 - Too Many Requests | API へのリクエストが多すぎます。 | 
| 500, 502, 503, 504 - Server Errors | リクエストの処理中に予期しないエラーが発生しました。 | 
400 エラー
これらのエラーは、リクエストが受け入れられなかったことを意味します。多くの場合、必須パラメータが欠落していることが原因です。
badRequest
このエラーは、コード内の次のいずれかの問題が原因で発生する可能性があります。
- 必須のフィールドまたはパラメータが指定されていません。
- 指定された値または指定されたフィールドの組み合わせが無効です。
- 重複する親をドライブ ファイルに追加しようとした。
- ディレクトリ グラフにサイクルを作成する親を追加しようとしました。
次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}
このエラーを修正するには、message フィールドを確認し、それに応じてコードを調整します。
illegalKeepForeverModification
このエラーは、「Keep Forever」とマークされた BLOB ファイルのリビジョンを false に設定しようとしたときに発生します。次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "illegalKeepForeverModification",
    "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
   }
  ],
  "code": 400,
  "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
 }
}
このエラーを修正するには、Blob ファイルのリビジョンを完全に削除して、[永久保存] 設定を削除します。
invalidSharingRequest
このエラーは、いくつかの原因で発生します。原因を特定するには、返された JSON の reason フィールドを評価します。このエラーは通常、次のような場合に発生します。
- 共有は成功しましたが、通知メールが正しく配信されませんでした。
- このユーザーにはアクセス制御リスト(ACL)の変更が許可されていません。
message フィールドは実際のエラーを示します。
共有は成功したが、通知メールが正しく配信されなかった
次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}
このエラーを解決するには、通知メールを宛先のメールアドレスに送信できなかったため、共有できなかったことをユーザー(共有者)に伝えます。ユーザーは、メールアドレスが正しく、メールを受信できることを確認する必要があります。
このユーザーには ACL の変更が許可されていません
次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"ACL change not allowed.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}
このエラーを修正するには、ファイルが属する Google Workspace ドメインの共有設定を確認してください。設定によって、ドメイン外での共有が禁止されているか、共有ドライブの共有が許可されていない可能性があります。
401 エラー
これらのエラーは、リクエストに有効なアクセス トークンが含まれていないことを意味します。
authError
このエラーは、使用しているアクセス トークンが期限切れか無効である場合に発生します。このエラーは、リクエストされたスコープの認可がないことが原因で発生することもあります。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "authError",
        "message": "Invalid Credentials",
        "locationType": "header",
        "location": "Authorization",
      }
    ],
    "code": 401,
    "message": "Invalid Credentials"
  }
}
このエラーを修正するには、有効期間の長い更新トークンを使用してアクセス トークンを更新します。失敗した場合は、Google Drive API スコープを選択するで説明されているように、OAuth フローを通じてユーザーを誘導します。
fileNotDownloadable
このエラーは、Google Workspace ドキュメントで alt=media URL パラメータを使用して revisions.get メソッドを使用しようとしたときに発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileNotDownloadable",
        "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
      }
    ],
    "code": 403,
    "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
  }
}
このエラーを解決するには、次のいずれかをお試しください。
- 特定のリビジョンのメタデータ(MIME タイプなど)を表示する場合は、alt=mediaURL パラメータを削除します。
- files.exportメソッドを使用して、Google Workspace ドキュメントのバイト コンテンツをエクスポートします。詳しくは、Google Workspace ドキュメントのコンテンツをエクスポートするをご覧ください。
403 エラー
これらのエラーは、使用量の上限を超えたか、ユーザーに適切な権限がないことを意味します。原因を特定するには、返された JSON の reason フィールドを評価します。
Drive API の上限については、使用量上限をご覧ください。ドライブのフォルダの上限については、ファイルとフォルダの上限をご覧ください。
activeItemCreationLimitExceeded
activeItemCreationLimitExceeded エラーは、アカウントごとに作成できるアイテム数の上限を超えた場合に発生します。各ユーザーは、アカウントで作成したアイテムを最大 5 億個保持できます。詳細については、ユーザーアイテムの上限をご覧ください。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "activeItemCreationLimitExceeded",
    "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
   }
  ],
  "code": 403,
  "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
 }
}
このエラーを解決するには:
- Google ドライブでは、アカウントで作成できるアイテム数が 5 億個に制限されていることをお客様に伝えます。 
- ユーザーが同じアカウントでアイテムを作成する必要がある場合は、一部のオブジェクトを完全に削除するよう指示します。要件を満たしていない場合は、要件を満たしている別のアカウントを使用できます。 
appNotAuthorizedToFile
このエラーは、アプリがファイルの ACL に登録されていない場合に発生します。このエラーが発生すると、ユーザーはアプリでファイルを開くことができなくなります。次の JSON サンプルは、このエラーを表したものです。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}
このエラーを解決するには、次のいずれかをお試しください。
- Google ドライブ選択ツールを開き、ユーザーにファイルを開くよう促します。
- アプリのドライブ UI の [開く] コンテキスト メニューを使用してファイルを開くようユーザーに指示します。
- files.getメソッドを使用して、- filesリソースの- isAppAuthorizedフィールドをチェックし、アプリがファイルを作成または開いたことを確認します。
cannotModifyInheritedTeamDrivePermission
このエラーは、ユーザーが共有ドライブ内のアイテムの継承された権限を変更しようとした場合に発生します。共有ドライブ内のアイテムから継承された権限を削除することはできません。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "cannotModifyInheritedTeamDrivePermission",
        "message": "Cannot update or delete an inherited permission on a shared drive item."
      }
    ],
    "code": 403,
    "message": "Cannot update or delete an inherited permission on a shared drive item."
  }
}
このエラーを修正するには、ユーザーが権限を継承した直接または間接の親アイテムの権限を調整する必要があります。詳しくは、権限の仕組みをご覧ください。permissions リソースを取得して、この共有ドライブ アイテムの権限が継承されているか、直接適用されているかを確認することもできます。
dailyLimitExceeded
このエラーは、プロジェクトの API 上限に達した場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}
このエラーは、アプリケーションの所有者が特定のリソースの使用量を制限するために割り当て上限を設定した場合に表示されます。このエラーを修正するには、「1 日あたりのクエリ数」の割り当ての使用量上限を削除します。
domainPolicy
このエラーは、ユーザーのドメインのポリシーでアプリによるドライブへのアクセスが許可されていない場合に発生します。次の JSON サンプルは、このエラーを表しています。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "domainPolicy",
        "message": "The domain administrators have disabled Drive apps."
      }
    ],
    "code": 403,
    "message": "The domain administrators have disabled Drive apps."
  }
}
このエラーを解決するには:
- ドメインではアプリによるドライブ内のファイルへのアクセスが許可されていないことをユーザーに伝えます。
- アプリのアクセス権限をリクエストするよう、ドメイン管理者に連絡するようユーザーに指示します。
downloadRestrictedForRevision
このエラーは、ユーザーが BLOB ファイルの改訂版をダウンロードできない場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "download_restricted_for_revision",
        "message": "This revision cannot be downloaded by the authenticated user."
      }
    ],
    "code": 403,
    "message": "This revision cannot be downloaded by the authenticated user."
  }
}
このエラーを修正するには、blob ファイルの版をダウンロードできるのは、[Keep Forever](永久保存)とマークされている場合のみであることをお客様に伝えます。詳細については、自動削除から保存するリビジョンを指定するをご覧ください。
fileOwnerNotMemberOfTeamDrive
このエラーは、ファイルを共有ドライブに移動しようとしたときに、ファイルのオーナーがメンバーではない場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}
このエラーを解決するには:
- role=ownerを使用して、メンバーを共有ドライブに追加します。詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。
- 共有ドライブにファイルを追加します。詳細については、フォルダを作成しデータを入力するをご覧ください。 
fileWriterTeamDriveMoveInDisabled
このエラーは、ドメイン管理者が role=writer のユーザーによる共有ドライブへのアイテムの移動を許可していない場合に発生します。アイテムの移動を試みているユーザーの権限が、移動先の共有ドライブで許可されている権限よりも少ない。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}
このエラーを解決するには、移行元と移行先の両方の共有ドライブで同じ管理者ユーザー アカウントを使用します。
insufficientFilePermissions
このエラーは、ユーザーがファイルへの書き込みアクセス権を持っていないときに、アプリがファイルの変更を試みた場合に発生します。次の JSON サンプルは、このエラーを表しています。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}
このエラーを解決するには、ファイルのオーナーに連絡して編集権限をリクエストするようユーザーに指示します。また、files.get メソッドで取得したメタデータでユーザーのアクセスレベルを確認し、権限がない場合は読み取り専用の UI を表示することもできます。
myDriveHierarchyDepthLimitExceeded
myDriveHierarchyDepthLimitExceeded エラーは、ネストされたフォルダレベルの数の上限を超えた場合に発生します。マイドライブに含められるフォルダ階層は最大 100 レベルです。詳細については、フォルダの深さの上限をご覧ください。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "myDriveHierarchyDepthLimitExceeded",
    "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
   }
  ],
  "code": 403,
  "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
 }
}
このエラーを解決するには:
- ドライブでは、フォルダを 100 階層より深く配置することはできないことをお客様に伝えます。
- 別のネストされたフォルダを作成する必要がある場合は、目的の親フォルダを 100 レベル未満に再編成するか、要件をすでに満たしている別の親フォルダを使用するようお客様に伝えます。
numChildrenInNonRootLimitExceeded
このエラーは、フォルダの子(フォルダ、ファイル、ショートカット)の数の上限を超えた場合に発生します。フォルダに直接保存できるフォルダ、ファイル、ショートカットの数は 50 万個までです。サブフォルダにネストされたアイテムは、この 50 万アイテムの上限にはカウントされません。ドライブ フォルダの制限について詳しくは、Google ドライブのフォルダの制限をご覧ください。
次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}
このエラーを解決するには、次のいずれかをお試しください。
- ドライブでは 50 万個を超えるアイテムを含むフォルダは作成できないことをお客様に伝えます。
- ユーザーがフォルダにアイテムを追加する必要がある場合は、アイテム数が 50 万個未満になるようにフォルダを再編成するか、アイテム数が少ない同様のフォルダを使用するよう指示します。
rateLimitExceeded
このエラーは、プロジェクトのレート上限に達した場合に発生します。この上限はリクエストのタイプによって異なります。次の JSON サンプルは、このエラーを表しています。
{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "message": "Rate Limit Exceeded",
    "reason": "rateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}
このエラーを解決するには、次のいずれかをお試しください。
- Google Cloud プロジェクトでユーザーあたりの割り当てを増やします。詳細については、割り当ての増加をリクエストしてください。
- 複数の API 呼び出しを 1 つの HTTP リクエストにバンドルするバッチ リクエスト。
- 指数バックオフを使用してリクエストを再試行します。
sharingRateLimitExceeded
このエラーは、ユーザーが共有上限に達したときに発生します。多くの場合、メールの上限に関連しています。次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}
このエラーを解決するには:
- 大量のファイルを共有する場合は、メールを送信しないでください。
- 1 人のユーザーが Google Workspace アカウントの多くのユーザーに代わって多数のリクエストを行っている場合は、quotaUserパラメータを使用するドメイン全体の委任を使用したサービス アカウントを検討してください。
storageQuotaExceeded
このエラーは、ユーザーが保存容量の上限に達した場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}
このエラーを解決するには:
- ドライブ アカウントのストレージの上限を確認します。詳しくは、Google Workspace のストレージとアップロードの上限をご覧ください。 
teamDriveFileLimitExceeded
このエラーは、ユーザーが共有ドライブの厳格なアイテム上限を超えようとしたときに発生します。ユーザーの共有ドライブ内の各フォルダに保存できるアイテム数は 50 万個までです。これにはファイル、フォルダ、ショートカットが含まれます。この上限は、ストレージの使用量ではなく、アイテムの数に基づきます。詳しくは、Google ドライブでの共有ドライブの制限をご覧ください。
次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}
このエラーを解決するには、共有ドライブ内のアイテムの数を減らします。共有ドライブに多数のファイルがあると整理や検索がしにくくなるほか、コンテンツを見落とす恐れもあるためです。
teamDriveHierarchyTooDeep
teamDriveHierarchyTooDeep エラーは、共有ドライブのネストされたフォルダレベル数の上限を超えた場合に発生します。ユーザーの共有ドライブに含められるフォルダ階層は最大 100 レベルまでです。詳細については、フォルダの深さの上限をご覧ください。
{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}
このエラーを解決するには:
- 共有ドライブでは、フォルダを 100 レベルより深く配置できないことをお客様に伝えます。
- 別のネストされたフォルダを作成する必要がある場合は、目的の親フォルダを 100 レベル未満に再編成するか、要件をすでに満たしている別の親フォルダを使用するようお客様に伝えます。
teamDriveMembershipRequired
このエラーは、ユーザーがメンバーではない共有ドライブにアクセスしようとした場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveMembershipRequired",
        "message": "The attempted action requires shared drive membership."
      }
    ],
    "code": 403,
    "message": "The attempted action requires shared drive membership."
  }
}
このエラーを解決するには、次のいずれかをお試しください。
- 共有ドライブの管理者に、実行する必要がある操作に適した権限を付与して追加するよう依頼します。 
- ドライブのロールと権限を確認して、共有ドライブにアクセスして管理できるユーザーを確認します。アクセスレベルの詳細については、共有ドライブを作成するもご覧ください。 
teamDrivesFolderMoveInNotSupported
このエラーは、ユーザーがマイドライブから共有ドライブにフォルダを移動しようとしたときに発生します。次の JSON サンプルは、このエラーを表しています。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}
このエラーを解決するには、次のいずれかをお試しください。
- Drive API を使用して、フォルダ内の個々のアイテムを共有ドライブに移動します。 - supportsAllDrives=trueパラメータを設定して、マイドライブと共有ドライブの両方のサポートを示します。
- フォルダを共有ドライブに移動する必要がある場合は、ドライブの UI を使用します。詳しくは、管理者としてフォルダを共有ドライブに移動するをご覧ください。 
teamDrivesParentLimit
このエラーは、ユーザーが共有ドライブ内のアイテムに複数の親を追加しようとした場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}
このエラーを解決するには、ドライブのショートカットを使用して、ファイルに複数のリンクを追加します。ショートカットの親は 1 つのみですが、ショートカット ファイルは別の場所にコピーできます。詳しくは、ドライブ ファイルへのショートカットを作成するをご覧ください。
UrlLeaseLimitExceeded
このエラーは、アプリケーションから Google Play ゲームデータを保存しようとしたときに発生します。次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}
このエラーを修正するには、スナップショットのアップロードを完了するかキャンセルしてから、別のスナップショットを作成します。
userRateLimitExceeded
このエラーは、ユーザーあたりの上限に達した場合に発生します。これは、Google Cloud コンソールの制限またはドライブ バックエンドの制限である可能性があります。次の JSON サンプルは、このエラーの表現です。
{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "userRateLimitExceeded",
    "message": "User Rate Limit Exceeded"
   }
  ],
  "code": 403,
  "message": "User Rate Limit Exceeded"
 }
}
このエラーを解決するには、次のいずれかをお試しください。
- Google Cloud プロジェクトでユーザーあたりの割り当てを増やします。詳細については、割り当ての増加をリクエストしてください。 
- 1 人のユーザーが Google Workspace アカウントの多くのユーザーに代わって多数のリクエストを行っている場合は、 - quotaUserパラメータを使用するドメイン全体の委任を使用したサービス アカウントを検討してください。
- 指数バックオフを使用してリクエストを再試行します。 
Drive API の上限については、使用量上限をご覧ください。
404 エラー
これらのエラーは、リクエストされたリソースにアクセスできないか、リソースが存在しないことを意味します。
notFound
このエラーは、ユーザーにファイルへの読み取りアクセス権がない場合、またはファイルが存在しない場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}
このエラーを解決するには:
- ファイルが共有ドライブにあり、files.getメソッドを使用している場合は、supportsAllDrivesクエリ パラメータがtrueに設定されていることを確認してください。
- ファイルに対する読み取りアクセス権がないか、ファイルが存在しないことをユーザーに伝えます。
- ファイルのオーナーに連絡して、ファイルへのアクセス権をリクエストするようユーザーに指示します。
429 エラー
これらのエラーは、API に送信されたリクエストが多すぎ、送信速度が速すぎることを意味します。
rateLimitExceeded
このエラーは、ユーザーが一定時間内に送信したリクエストが多すぎる場合に発生します。次の JSON サンプルは、このエラーの表現です。
{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}
このエラーを修正するには、指数バックオフを使用してリクエストを再試行します。
500、502、503、504 エラー
このエラーは、リクエストの処理中に予期しないサーバーエラーが発生した場合に発生します。これらのエラーの原因としては、リクエストのタイミングが別のリクエストと重複している、サポートされていないアクションのリクエスト(Google サイトのサイト全体ではなく、単一のページの権限を更新しようとしているなど)など、さまざまな問題が考えられます。
5xx エラーの一覧は次のとおりです。
- 500 バックエンド エラー
- 502 Bad Gateway(不正なゲートウェイ)
- 503 Service Unavailable(サービス利用不可)
- 504 Gateway Timeout(ゲートウェイ タイムアウト)
このエラーを修正するには、指数バックオフを使用してリクエストを再試行します。