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 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 v2 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 dành cho v3. Để có đượ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 v2 và v3.

Tải xuống và phát hành bản sửa đổi tệp

Trên trang Tải bản sửa đổi tệp xuống và phát hành, thông tin sau đây dành riêng cho v2 và thay thế các phần sau đây (như trong v3):

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ản sửa đổi đó xuống bằng cách gửi một yêu cầu GET được uỷ quyền đến tài sản []downloadUrl](/drive/api/reference/rest/v2/revisions). Google Drive tạo URL ngắn hạn này khi bạn yêu cầu bản sửa đổi. Không dựa vào nó để 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 chế độ hỗ trợ bộ nhớ dùng chung

Ngoài thông tin trên trang Triển khai dịch vụ hỗ trợ bộ nhớ dùng chung, hãy thay thế trường bổ sung này trashedDate bằng phiên bản 2.

Trong phần Triển khai hỗ trợ bộ nhớ dùng chung, các phương thức sau yêu cầu supportsAllDrives=true khi làm việc với nội dung 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ố thông số dành riêng cho bộ nhớ dùng chung. Để biết danh sách thông 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 ý rằng thông tin này dành riêng cho v2:

Nhập vào các loại 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 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 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ó cả trường roleadditionalRoles của một quyền phản ánh vai trò hiệu quả của người dùng, nhóm hoặc miền đối với một mục nhất định.

Sự khác biệt về cụm từ tìm kiếm phiên bản 2

Trường title của phiên bản 2 là name trong phiên bản 3. Để xem ví dụ, hãy xem bài viết 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. Để biết ví dụ, hãy xem bài viết Tìm bộ nhớ dùng chung.

Trường modifiedDate của phiên bản 2 là modifiedTime trong phiên bản 3. Trường lastViewedByMeDate của v2 là viewedByMeTime trong phiên bản 3. Để 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ử.