このリファレンスでは、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 | 
非公開: files.update({'appProperties':{'key':null}})公開: files.update({'properties':{'key':null}}) | 
properties.get | 
非公開: files.get(fields='appProperties' )公開: files.get(fields='properties') | 
properties.insert | 
非公開: files.update({'appProperties':{'key':'value'}} )公開: files.update({'properties':{'key':'value'}}) | 
properties.list | 
非公開: files.get(fields='appProperties' )公開: files.get(fields='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 | 
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 |