このリファレンスでは、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 |
files.get を fileId=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=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 |