В этом справочнике представлены все различия в ресурсах между версиями 2 и 3. Общие различия между двумя версиями см. в руководстве по сравнению Drive API v2 и v3 .
Различия методов между v2 и v3
В этой таблице показаны методы версии 2, которые изменились в версии 3.
| Метод v2 | Метод v3 |
|---|---|
children.delete | files.update для дочернего элемента с помощью ?removeParents=parent_id |
children.get | files.list с ?q='parent_id'+in+parents |
children.insert | files.update для дочернего элемента с ?addParents=parent_id |
children.list | files.list с ?q='parent_id'+in+parents |
comments.insert | comments.create |
comments.patch | comments.update |
files.insert | files.create |
files.patch | files.update |
files.touch | files.update с {'modifiedTime':'timestamp'} |
files.trash | files.update с {'trashed':true} |
files.untrash | files.update с {'trashed':false} |
parents.delete | files.update с ?removeParents=parent_id |
parents.get | files.get с ?fields=parents |
parents.insert | files.update с ?addParents=parent_id |
parents.list | files.get с ?fields=parents |
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
В следующей таблице показаны методы, которые одинаковы в версиях 2 и 3, но принимают разные параметры.
| Метод | 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 | files.update с {'viewedByMeTime':'timestamp'} |
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 | files.update с {'viewedByMeTime':'timestamp'} |
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 | н/д |
Различия в полях ресурсов между версиями 2 и 3
В этой таблице показаны поля ресурсов, которые изменились с версии 2 на версию 3.
| Ресурс | 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 | files.get с ?fields=name |
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 | files.get с помощью ?alt=media |
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 | revisions.get с ?alt=media |
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 |