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
フィールドを確認し、それに応じてコードを調整します。
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 フローに誘導します。
403 エラー
これらのエラーは、使用量上限を超えているか、ユーザーに正しい権限がないことを意味します。原因を特定するには、返された JSON の reason
フィールドを評価します。
Drive API の上限については、使用量上限を参照してください。ドライブ フォルダの上限については、ファイルとフォルダの上限をご覧ください。
activeItemCreationLimitExceeded
activeItemCreationLimitExceeded
エラーは、アカウントごとの作成アイテム数が上限を超えると発生します。各ユーザーは、1 つのアカウントで最大 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."
}
}
このエラーを解決するには:
ドライブでは 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.permissionDetails
リソースを取得して、この共有ドライブ アイテムに対する権限が継承されているか、直接適用されているかを確認することもできます。
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."
}
}
このエラーを解決するには:
- アプリがドライブ内のファイルにアクセスすることがドメインによって許可されていないことをユーザーに伝えます。
- ドメイン管理者にアプリのアクセス権をリクエストするようにユーザーに指示します。
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/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/drive/api/guides/handle-errors#nested-folder-levels."
}
}
このエラーを解決するには:
- ドライブでは 100 レベルを超えるフォルダは配置できないことをユーザーに伝えます。
- 別のネストされたフォルダを作成する必要がある場合は、目的の親フォルダの深さを 100 レベル未満に再編成するか、すでに要件を満たしている別の親フォルダを使用するように伝えます。
numChildrenInNonRootLimitExceeded
このエラーは、フォルダの子(フォルダ、ファイル、ショートカット)の数が上限を超えた場合に発生します。フォルダ内に直接格納できるフォルダ、ファイル、ショートカットには、最大 50 万個のアイテムの上限があります。サブフォルダにネストされたアイテムは、この 500,000 アイテムの上限にカウントされません。ドライブ フォルダの上限について詳しくは、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 万個を超えるアイテムを含むフォルダは使用できないことをユーザーに伝えます。
- フォルダ全体にアイテムを追加する必要がある場合は、アイテム数が 500,000 個未満になるようにフォルダを再編成するか、すでにアイテムが少ない同様のフォルダを使用するように伝えます。
rateLimitExceeded
このエラーは、プロジェクトのレート制限に達した場合に発生します。この上限は、リクエストの種類によって異なります。次の JSON サンプルはこのエラーを表しています。
{
"error": {
"errors": [
{
"domain": "usageLimits",
"message": "Rate Limit Exceeded",
"reason": "rateLimitExceeded",
}
],
"code": 403,
"message": "Rate Limit Exceeded"
}
}
このエラーを修正するには、次のいずれかを試してください。
- Google Cloud プロジェクトでユーザーごとの割り当てを増やす。詳細については、割り当ての増加をリクエストしてください。
- バッチ リクエスト: 行う API 呼び出しの数を減らします。
- 指数バックオフを使用してリクエストを再試行します。
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
このエラーは、ユーザーが共有ドライブのアイテムの厳格な上限を超えようとすると発生します。ユーザーの共有ドライブ内の各フォルダには、ファイル、フォルダ、ショートカットを含むアイテム数の上限が 40 万個あります。この上限は、ストレージ使用量ではなくアイテム数に基づいています。詳しくは、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."
}
}
このエラーを修正するには、共有ドライブ内のアイテム数を減らしてください。共有ドライブにファイルが多すぎると、整理と検索が難しい場合があります。
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 サイト内の 1 つのページの権限を更新しようとするなど)が原因で発生することがあります。
5xx エラーは次のとおりです。
- 500 バックエンド エラー
- 502 Bad Gateway(不正なゲートウェイ)
- 503 Service Unavailable(サービス利用不可)
- 504 Gateway Timeout(ゲートウェイ タイムアウト)
このエラーを修正するには、指数バックオフを使用してリクエストを再試行します。