Hướng dẫn về API Drive phiên bản 2

Nếu bạn sử dụng Google Drive API phiên bản 2, thì hầu hết nội dung trong Hướng dẫn về Google Drive API phiên bản 3 cũng áp dụng cho 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 xuất hiện trong các trang cụ thể của hướng dẫn về phiên bản 3. Để có được bối 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.

Để xem 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 xuống và xuất bản các bản sửa đổi tệp

Trên trang Tải xuống và xuất bản các 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 xuất hiện 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 phiên bản của một tệp, bạn có thể tải nội dung của bất kỳ phiên bản nào 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](/workspace/drive/api/reference/rest/v2/revisions) của phiên bản đó. Google Drive tạo URL tồn tại trong thời gian ngắn này khi bạn yêu cầu xem bản sửa đổi. Đừng dựa vào thông tin 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 tuỳ chỉnh của tệp

Ngoài thông tin trên trang Thêm thuộc tính tuỳ chỉnh cho tệp, 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 cách sử dụng tài nguyên properties.

Đây là cấu trúc của một thuộc tính điển hình 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 chế độ 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 làm việc với 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.getchanges.list có một số tham số dành riêng cho ổ đĩa dùng chung. Để xem danh sách các thông số, hãy xem phần Theo dõi các thay đổi trên ổ đĩ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 dành riêng cho phiên bản 2:

Nhập vào các loại tệp Google Tài liệu

Khi tạo một 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 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

Thông báo 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 vai trò có hiệu lực đối với người dùng, nhóm hoặc miền. Trong phiên bản 2, bạn cần cả trường roleadditionalRoles của một quyền để phản ánh các vai trò có hiệu lực 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 đối với 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 kiế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 tham khảo bài viết Tì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 bài viết Các điều khoản và toán tử trong cụm từ tìm kiếm.