مرجع المقارنة بين الإصدارَين 2 و3 من Drive API

يعرض هذا المرجع كل الاختلافات في الموارد بين الإصدارين 2 و3. لمعرفة الاختلافات العالية المستوى بين الإصدارَين، يُرجى الاطّلاع على دليل المقارنة بين الإصدارَين 2 و3 من Drive API.

الاختلافات في الطرق بين الإصدارين 2 و3

يعرض هذا الجدول طُرق الإصدار 2 التي تغيّرت في الإصدار 3.

طريقة الإصدار 2 طريقة الإصدار 3
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 timing fixed in amara
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

الاختلافات في المعلَمات بين الإصدار 2 والإصدار 3

يعرض الجدول التالي طرق متطابقة في الإصدارين 2 و3، ولكنهما تأخذ معلَمات مختلفة.

الطريقة مَعلمة v2 معلمة v3
about.get includeSubscribed timing fixed in amara
about.get maxChangeIdCount timing fixed in amara
about.get startChangeId timing fixed in amara
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 timing fixed in amara
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink timing fixed in amara
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink timing fixed in amara
comments.list items comments
files.copy convert تقديم mimeType المستهدَف في نص المرجع
files.copy ocr تم تفعيل التعرّف البصري على الأحرف تلقائيًا لعمليات استيراد الصور.
files.copy pinned keepRevisionForever
files.copy timedTextLanguage timing fixed in amara
files.copy timedTextTrackName timing fixed in amara
files.copy visibility=DEFAULT ignoreDefaultVisibility=false
files.copy visibility=PRIVATE ignoreDefaultVisibility=true
files.insert convert تقديم mimeType المستهدَف في نص المرجع
files.insert ocr تم تفعيل التعرّف البصري على الأحرف تلقائيًا لعمليات استيراد الصور.
files.insert pinned keepRevisionForever
files.insert timedTextLanguage timing fixed in amara
files.insert timedTextTrackName timing fixed in amara
files.insert visibility=DEFAULT ignoreDefaultVisibility=false
files.insert visibility=PRIVATE ignoreDefaultVisibility=true
files.get projection timing fixed in amara
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 timing fixed in amara
files.list items files
files.list nextLink nextPageToken
files.list selfLink timing fixed in amara
files.update modifiedDateBehavior يتم ضبط التاريخ المعدّل تلقائيًا إذا لم يتم توفيره في نص المورد.
files.update newRevision timing fixed in amara
files.update ocr تم تفعيل التعرّف البصري على الأحرف تلقائيًا لعمليات استيراد الصور.
files.update pinned keepRevisionForever
files.update setModifiedDate timing fixed in amara
files.update timedTextLanguage timing fixed in amara
files.update timedTextTrackName timing fixed in amara
files.update updateViewedDate ‫"files.update" مع "{'viewedByMeTime':'timestamp'}"
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag timing fixed in amara
permissions.list items permissions
permissions.list selfLink timing fixed in amara
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink timing fixed in amara
revisions.list etag timing fixed in amara
revisions.list items revisions
revisions.list selfLink timing fixed in amara

الاختلافات في حقول الموارد بين الإصدار 2 والإصدار 3

يعرض هذا الجدول حقول الموارد التي تم تغييرها من الإصدار 2 إلى الإصدار 3.

المورد v2 Field v3 Field
About additionalRoleInfo timing fixed in amara
About domainSharingPolicy timing fixed in amara
About etag timing fixed in amara
About features timing fixed in amara
About languageCode timing fixed in amara
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizes وmaxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService timing fixed in amara
About quotaType يُشار إليه بوجود storageQuota.limit أو عدمه
About remainingChangeIds timing fixed in amara
About rootFolderId files.get مع fileId=root و?fields=id
About selfLink timing fixed in amara
About isCurrentAppInstalled appInstalled
About quotaBytesTotal storageQuota.limit
About quotaBytesUsed storageQuota.usageInDrive
About quotaBytesUsedAggregate storageQuota.usage
About quotaBytesUsedInTrash storageQuota.usageInDriveTrash
Apps etag timing fixed in amara
Changes deleted removed
Changes id timing fixed in amara
Changes selfLink timing fixed in amara
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId timing fixed in amara
Comments fileTitle ‫"files.get" مع "?fields=name"
Comments modifiedDate modifiedTime
Comments selfLink timing fixed in amara
Comments status resolved
Files alternateLink webViewLink
Files appDataContents spaces
Files copyable capabilities.canCopy
Files createdDate createdTime
Files defaultOpenWithLink timing fixed in amara
Files downloadUrl ‫"files.get" مع "?alt=media"
Files editable capabilities.canEdit
Files embedLink timing fixed in amara
Files etag timing fixed in amara
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 timing fixed in amara
Files ownerNames owners.displayName
Files selfLink timing fixed in amara
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 timing fixed in amara
Permissions additionalRoles role
Permissions authKey timing fixed in amara
Permissions etag timing fixed in amara
Permissions name displayName
Permissions selfLink timing fixed in amara
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 timing fixed in amara
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink timing fixed in amara
Revisions selfLink timing fixed in amara
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink