Drive API v2 と v3 の比較リファレンス

このリファレンスでは、v2 と v3 のリソースの違いをすべて説明します。2 つのバージョンの大まかな違いについては、Drive API v2 と v3 の比較ガイドをご覧ください。

v2 と v3 のメソッドの違い

次の表に、v3 で変更された v2 メソッドを示します。

v2 のメソッド v3 のメソッド
children.delete ?removeParents=parent_id を持つ子に対する files.update
children.get ?q='parent_id'+in+parentsfiles.list
children.insert ?addParents=parent_id を持つ子に対する files.update
children.list ?q='parent_id'+in+parentsfiles.list
comments.insert comments.create
comments.patch comments.update
files.insert files.create
files.patch files.update
files.touch {'modifiedTime':'timestamp'}files.update
files.trash {'trashed':true}files.update
files.untrash {'trashed':false}files.update
parents.delete ?removeParents=parent_idfiles.update
parents.get ?fields=parentsfiles.get
parents.insert ?addParents=parent_idfiles.update
parents.list ?fields=parentsfiles.get
permissions.getIdForEmail なし
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete 非公開: files.update{'appProperties':{'key':null}}適用):
公開: files.update{'properties':{'key':null}}適用)
properties.get 非公開: files.getfields='appProperties'
公開): files.getfields='properties' 適用)
properties.insert 非公開: files.update{'appProperties':{'key':'value'}}
公開): files.update{'properties':{'key':'value'}} 適用)
properties.list 非公開: files.getfields='appProperties'
公開): files.getfields='properties' 適用)
properties.update 非公開: files.update{'appProperties':{'key':'value'}}
公開): files.update{'properties':{'key':'value'}} 適用)
replies.insert replies.create
replies.patch replies.update
revisions.patch revisions.update

v2 と v3 のパラメータの違い

次の表は、v2 と v3 で同じだが、パラメータが異なるメソッドを示しています。

メソッド v2 パラメータ v3 パラメータ
about.get includeSubscribed なし
about.get maxChangeIdCount なし
about.get startChangeId なし
changes.list includeDeleted includeRemoved
changes.list includeSubscribed=true restrictToMyDrive=false
changes.list includeSubscribed=false restrictToMyDrive=true
changes.list maxResults pageSize
changes.list startChangeId pageToken
changes.list etag なし
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink なし
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink なし
comments.list items comments
files.copy convert リソース本文にターゲット mimeType を指定する
files.copy ocr 画像のインポートで OCR が自動的に有効になります
files.copy pinned keepRevisionForever
files.copy timedTextLanguage なし
files.copy timedTextTrackName なし
files.copy visibility=DEFAULT ignoreDefaultVisibility=false
files.copy visibility=PRIVATE ignoreDefaultVisibility=true
files.insert convert リソース本文にターゲット mimeType を指定する
files.insert ocr 画像のインポートで OCR が自動的に有効になります
files.insert pinned keepRevisionForever
files.insert timedTextLanguage なし
files.insert timedTextTrackName なし
files.insert visibility=DEFAULT ignoreDefaultVisibility=false
files.insert visibility=PRIVATE ignoreDefaultVisibility=true
files.get projection なし
files.get revisionId revisions.get
files.get updateViewedDate {'viewedByMeTime':'timestamp'}files.update
files.generateIds maxResults count
files.list corpora=default corpus=user
files.list corpora=domain corpus=domain
files.list maxResults pageSize
files.list etag なし
files.list items files
files.list nextLink nextPageToken
files.list selfLink なし
files.update modifiedDateBehavior リソース本文で更新日を指定しない場合は、自動的に設定されます。
files.update newRevision なし
files.update ocr 画像のインポートで OCR が自動的に有効になります
files.update pinned keepRevisionForever
files.update setModifiedDate なし
files.update timedTextLanguage なし
files.update timedTextTrackName なし
files.update updateViewedDate {'viewedByMeTime':'timestamp'}files.update
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag なし
permissions.list items permissions
permissions.list selfLink なし
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink なし
revisions.list etag なし
revisions.list items revisions
revisions.list selfLink なし

v2 と v3 のリソース フィールドの違い

次の表に、v2 から v3 に変更されたリソース フィールドを示します。

リソース v2 Field v3 Field
About additionalRoleInfo なし
About domainSharingPolicy なし
About etag なし
About features なし
About languageCode なし
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizesmaxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService なし
About quotaType storageQuota.limit の有無で示されます。
About remainingChangeIds なし
About rootFolderId files.getfileId=root?fields=id を使用)
About selfLink なし
About isCurrentAppInstalled appInstalled
About quotaBytesTotal storageQuota.limit
About quotaBytesUsed storageQuota.usageInDrive
About quotaBytesUsedAggregate storageQuota.usage
About quotaBytesUsedInTrash storageQuota.usageInDriveTrash
Apps etag なし
Changes deleted removed
Changes id なし
Changes selfLink なし
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId なし
Comments fileTitle ?fields=namefiles.get
Comments modifiedDate modifiedTime
Comments selfLink なし
Comments status resolved
Files alternateLink webViewLink
Files appDataContents spaces
Files copyable capabilities.canCopy
Files createdDate createdTime
Files defaultOpenWithLink なし
Files downloadUrl ?alt=mediafiles.get
Files editable capabilities.canEdit
Files embedLink なし
Files etag なし
Files fileSize size
Files imageMediaMetadata.date imageMediaMetadata.time
Files indexableText.text contentHints.indexableText
Files copyRequiresWriterPermission viewersCanCopyContent
Files labels.starred starred
Files labels.trashed trashed
Files labels.viewed viewedByMe
Files lastModifyingUserName lastModifyingUser.displayName
Files lastViewedByMeDate viewedByMeTime
Files modifiedByMeDate modifiedByMeTime
Files modifiedDate modifiedTime
Files openWithLinks なし
Files ownerNames owners.displayName
Files selfLink なし
Files sharedWithMeDate sharedWithMeTime
Files thumbnail.image contentHints.thumbnail.image
Files thumbnail.mimeType contentHints.thumbnail.mimeType
Files title name
Files userPermission ownedByMecapabilities.canEditcapabilities.canComment
Files webViewLink なし
Permissions additionalRoles role
Permissions authKey なし
Permissions etag なし
Permissions name displayName
Permissions selfLink なし
Permissions value emailAddress または domain
Permissions withLink=true allowFileDiscovery=false
Permissions withLink=false allowFileDiscovery=true
Replies createdDate createdTime
Replies modifiedDate modifiedTime
Replies replyId id
Replies verb action
Revisions downloadUrl ?alt=mediarevisions.get
Revisions etag なし
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink なし
Revisions selfLink なし
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink