Nếu bạn sử dụng API Google Drive phiên bản 2, thì hầu hết nội dung trong Hướng dẫn API Google Drive phiên bản 3 cũng liên quan đến phiên bản 2. Phần này chứa tất cả thông tin dành riêng cho phiên bản 2 và khác với thông tin được trình bày trong các trang cụ thể của hướng dẫn phiên bản 3. Để có được toàn bộ ngữ cảnh, mỗi mục phụ chứa đường liên kết đến trang hướng dẫn tương ứng.
Để biết danh sách đầy đủ các điểm khác biệt, hãy xem tài liệu tham khảo so sánh Drive API phiên bản 2 và phiên bản 3.
Tải và phát hành bản sửa đổi tệp
Trên trang Tải xuống và xuất bản bản sửa đổi tệp, thông tin sau đây dành riêng cho phiên bản 2 và thay thế các phần sau đây hiển thị cho phiên bản 3:
Liệt kê và tải từng bản sửa đổi xuống
Sau khi nhận được danh sách các bản sửa đổi của một tệp, bạn có thể tải nội dung của bất kỳ bản sửa đổi nào xuống bằng cách gửi yêu cầu GET
được uỷ quyền đến thuộc tính []downloadUrl
](/drive/api/reference/rest/v2/revisions) của tệp đó.
Google Drive sẽ tạo URL ngắn hạn này khi bạn yêu cầu sửa đổi.
Đừng dựa vào mã này để sử dụng sau.
Bạn cũng có thể xuất bản sửa đổi ở một trong các định dạng được hỗ trợ bằng cách kiểm tra thuộc tính exportLinks
.
Thuộc tính tệp tuỳ chỉnh
Ngoài thông tin trên trang Thêm thuộc tính tệp tuỳ chỉnh, thông tin sau đây dành riêng cho phiên bản 2:
Các thuộc tính được truy cập bằng tài nguyên properties
.
Đây là cấu trúc của một thuộc tính thông thường có thể được dùng để lưu trữ mã nhận dạng cơ sở dữ liệu của tệp trên Drive.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Để biết thêm thông tin về các giới hạn, hãy xem properties
trong tài liệu tham khảo.
Bật tính năng hỗ trợ bộ nhớ dùng chung
Ngoài thông tin trên trang Triển khai tính năng hỗ trợ ổ đĩa dùng chung, hãy thay thế trường bổ sung này
trashedDate
cho phiên bản 2.
Trong phần Triển khai tính năng hỗ trợ bộ nhớ dùng chung, các phương thức sau đây yêu cầu supportsAllDrives=true
khi xử lý nội dung trong bộ nhớ dùng chung:
files.get
files.list
files.insert
files.update
files.patch
files.copy
files.trash
files.untrash
files.delete
files.touch
children.insert
parents.insert
changes.list
changes.getStartPageToken
changes.get
permissions.list
permissions.get
permissions.insert
permissions.update
permissions.patch
permissions.delete
Phương thức changes.get
và changes.list
có một số tham số dành riêng cho các ổ đĩa dùng chung. Để biết danh sách các tham số, hãy xem phần Theo dõi các thay đổi trên một ổ đĩa dùng chung.
Tải tệp lên
Trên trang Tải dữ liệu tệp lên, hãy lưu ý rằng thông tin này chỉ dành cho phiên bản 2:
Các loại tệp có thể nhập vào Google Tài liệu
Khi tạo tệp trong Google Drive, bạn có thể chuyển đổi một số loại tệp thành tài liệu Google Tài liệu, Google Trang tính hoặc Google Trang trình bày. Thêm các tham số truy vấn convert
files.insert
và đặt thuộc tính mimeType
(workspace_name) của tệp. Để biết thêm thông tin, hãy xem bài viết Tải dữ liệu tệp lên.
Chia sẻ tệp, thư mục và ổ đĩa
Lưu ý trên trang Chia sẻ tệp, thư mục và ổ đĩa, trong phiên bản 3, chỉ có một trường role
chỉ định các vai trò hiệu quả cho người dùng, nhóm hoặc miền. Trong phiên bản 2, bạn cần cả trường role
và additionalRoles
của quyền phản ánh các vai trò hiệu quả mà người dùng, nhóm hoặc miền có đối với một mục nhất định.
Điểm khác biệt về cụm từ tìm kiếm cho phiên bản 2
Trường title
của phiên bản 2 là name
trong phiên bản 3. Để biết ví dụ, hãy xem phần Tìm tệp và thư mục.
Trường createdDate
của phiên bản 2 là createdTime
trong phiên bản 3. Để xem ví dụ, hãy xem phần Tìm kiếm
ổ đĩa dùng chung.
Trường modifiedDate
của phiên bản 2 là modifiedTime
trong phiên bản 3. Trường lastViewedByMeDate
v2 là viewedByMeTime
trong v3. Để biết thêm thông tin, hãy xem phần Toán tử và cụm từ tìm kiếm.