Porównanie interfejsu Drive API v2 i v3

Ten przewodnik zawiera wszystkie różnice między wersjami 2 i 3. Informacje o różnicach między tymi wersjami znajdziesz w przewodniku po różnicach między interfejsem Drive API w wersji 2 a 3.

Różnice między metodami w wersji 2 i 3

Ta tabela zawiera metody z wersji 2, które zostały zmienione w wersji 3.

Metoda 2 Metoda v3
children.delete files.update na koncie dziecka ?removeParents=parent_id
children.get files.list?q='parent_id'+in+parents
children.insert files.update na koncie dziecka ?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 nie dotyczy
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete PRYWATNE: files.update{'appProperties':{'key':null}}
PUBLICZNE: files.update{'properties':{'key':null}}
properties.get PRYWATNE: files.getfields='appProperties'
PUBLICZNE: files.getfields='properties'
properties.insert PRYWATNE: files.update{'appProperties':{'key':'value'}}
PUBLICZNE: files.update{'properties':{'key':'value'}}
properties.list PRYWATNE: files.getfields='appProperties'
PUBLICZNE: files.getfields='properties'
properties.update PRYWATNE: files.update{'appProperties':{'key':'value'}}
PUBLICZNE: files.update{'properties':{'key':'value'}}
replies.insert replies.create
replies.patch replies.update
revisions.patch revisions.update

Różnice między wersjami 2 i 3 w przypadku parametrów

Tabela poniżej zawiera metody, które są takie same w wersji 2 i 3, ale mają różne parametry.

Metoda Parametr v2 Parametr v3
about.get includeSubscribed nie dotyczy
about.get maxChangeIdCount nie dotyczy
about.get startChangeId nie dotyczy
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 nie dotyczy
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink nie dotyczy
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink nie dotyczy
comments.list items comments
files.copy convert Podaj docelową wartość mimeType w treści zasobu
files.copy ocr Optyczne rozpoznawanie znaków jest włączane automatycznie w przypadku importowania obrazów.
files.copy pinned keepRevisionForever
files.copy timedTextLanguage nie dotyczy
files.copy timedTextTrackName nie dotyczy
files.copy visibility=DEFAULT ignoreDefaultVisibility=false
files.copy visibility=PRIVATE ignoreDefaultVisibility=true
files.insert convert Podaj docelową wartość mimeType w treści zasobu
files.insert ocr Optyczne rozpoznawanie znaków jest włączane automatycznie w przypadku importowania obrazów.
files.insert pinned keepRevisionForever
files.insert timedTextLanguage nie dotyczy
files.insert timedTextTrackName nie dotyczy
files.insert visibility=DEFAULT ignoreDefaultVisibility=false
files.insert visibility=PRIVATE ignoreDefaultVisibility=true
files.get projection nie dotyczy
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 nie dotyczy
files.list items files
files.list nextLink nextPageToken
files.list selfLink nie dotyczy
files.update modifiedDateBehavior Jeśli data modyfikacji nie została podana w ciele zasobu, zostanie ustawiona automatycznie.
files.update newRevision nie dotyczy
files.update ocr Optyczne rozpoznawanie znaków jest automatycznie włączane w przypadku importowania obrazów
files.update pinned keepRevisionForever
files.update setModifiedDate nie dotyczy
files.update timedTextLanguage nie dotyczy
files.update timedTextTrackName nie dotyczy
files.update updateViewedDate files.update{'viewedByMeTime':'timestamp'}
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag nie dotyczy
permissions.list items permissions
permissions.list selfLink nie dotyczy
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink nie dotyczy
revisions.list etag nie dotyczy
revisions.list items revisions
revisions.list selfLink nie dotyczy

Różnice między polami zasobu w wersji 2 i 3

Ta tabela pokazuje pola zasobów, które zmieniły się z wersji 2 na wersję 3.

Zasób v2 Field v3 Field
About additionalRoleInfo nie dotyczy
About domainSharingPolicy nie dotyczy
About etag nie dotyczy
About features nie dotyczy
About languageCode nie dotyczy
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizesmaxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService nie dotyczy
About quotaType Wskazuje obecność lub brak tagu storageQuota.limit
About remainingChangeIds nie dotyczy
About rootFolderId files.getfileId=root?fields=id
About selfLink nie dotyczy
About isCurrentAppInstalled appInstalled
About quotaBytesTotal storageQuota.limit
About quotaBytesUsed storageQuota.usageInDrive
About quotaBytesUsedAggregate storageQuota.usage
About quotaBytesUsedInTrash storageQuota.usageInDriveTrash
Apps etag nie dotyczy
Changes deleted removed
Changes id nie dotyczy
Changes selfLink nie dotyczy
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId nie dotyczy
Comments fileTitle files.get?fields=name
Comments modifiedDate modifiedTime
Comments selfLink nie dotyczy
Comments status resolved
Files alternateLink webViewLink
Files appDataContents spaces
Files copyable capabilities.canCopy
Files createdDate createdTime
Files defaultOpenWithLink nie dotyczy
Files downloadUrl files.get?alt=media
Files editable capabilities.canEdit
Files embedLink nie dotyczy
Files etag nie dotyczy
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 nie dotyczy
Files ownerNames owners.displayName
Files selfLink nie dotyczy
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 nie dotyczy
Permissions additionalRoles role
Permissions authKey nie dotyczy
Permissions etag nie dotyczy
Permissions name displayName
Permissions selfLink nie dotyczy
Permissions value emailAddress lub 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 nie dotyczy
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink nie dotyczy
Revisions selfLink nie dotyczy
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink