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

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.getchanges.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ử.