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+parents で files.list
children.insert ?addParents=parent_id を持つ子どもの files.update
children.list ?q='parent_id'+in+parents で files.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_id と files.update
parents.get ?fields=parents と files.get
parents.insert ?addParents=parent_id と files.update
parents.list ?fields=parents で files.get
permissions.getIdForEmail なし
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete PRIVATE: files.update（{'appProperties':{'key':null}}
）PUBLIC: files.update（{'properties':{'key':null}}）
properties.get 非公開: fields='appProperties'
を含む files.get 公開: fields='properties' を含む files.get
properties.insert 非公開: {'appProperties':{'key':'value'}}
を含む files.update 公開: {'properties':{'key':'value'}} を含む files.update
properties.list 非公開: fields='appProperties'
を含む files.get 公開: fields='properties' を含む files.get
properties.update 非公開: {'appProperties':{'key':'value'}}
を含む files.update 公開: {'properties':{'key':'value'}} を含む files.update
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 maxImportSizes、maxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService なし
About quotaType storageQuota.limit の有無で示されます
About remainingChangeIds なし
About rootFolderId fileId=root と ?fields=id を使用した files.get
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=name で files.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=media で files.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 ownedByMe、capabilities.canEdit、capabilities.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=media で revisions.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