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