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 về API Google Drive v3 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 những thông tin hiển thị trên các trang cụ thể của hướng dẫn về phiên bản 3. Để nắm được ngữ cảnh đầy đủ, mỗi phần phụ đều 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 API Drive phiên bản 2 và v3.
Tải xuống và xuất bản bản sửa đổi tệp
Trên trang Tải xuống và phát hành 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 này 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 bản sửa đổi của một tệp, bạn có thể tải nội dung của mọi bản sửa đổi xuống bằng cách gửi một 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 tạo URL ngắn hạn này khi bạn yêu cầu sửa đổi.
Đừng dựa vào tính năng này để sử dụng sau này.
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:
Bạn có thể truy cập vào các thuộc tính 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ể dùng để lưu trữ mã cơ sở dữ liệu của tệp Drive trên tệp đó.
{
'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ợ bộ nhớ dùng chung, hãy thay thế trường bổ sung này trashedDate
cho phiên bản 2.
Trong mục 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 làm việc với nội dung của 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
Các phương thức changes.get
và changes.list
có một số tham số dành riêng cho bộ nhớ 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 bộ nhớ 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 ý thông tin sau dành riêng cho phiên bản 2:
Nhập vào các loại tài liệu trên 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. Bao gồm tham số truy vấn files.insert
convert
và đặt thuộc tính (workspace_name) mimeType
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 là role
, chỉ định vai trò hiệu quả cho người dùng, nhóm hoặc miền. Trong phiên bản 2, cả trường role
và trường additionalRoles
của một quyền đều phản ánh 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.
Sự khác biệt về cụm từ tìm kiếm đối với phiên bản 2
Trường title
trong v2 là name
trong v3. Để biết ví dụ, hãy xem phần Tìm kiếm tệp và thư mục.
Trường createdDate
trong v2 là createdTime
trong v3. Để biết ví dụ, hãy xem phần Tìm kiếm bộ nhớ dùng chung.
Trường modifiedDate
trong v2 là modifiedTime
trong v3. Trường lastViewedByMeDate
v2 là viewedByMeTime
trong v3. Để biết thêm thông tin chi tiết, hãy xem phần Cụm từ tìm kiếm và toán tử.