Triển khai tính năng hỗ trợ bộ nhớ dùng chung

Bộ nhớ dùng chung tuân theo các mô hình tổ chức, chia sẻ và quyền sở hữu khác với Drive của tôi. Nếu ứng dụng của bạn sẽ tạo và quản lý tệp trên bộ nhớ dùng chung, thì bạn phải triển khai tính năng hỗ trợ bộ nhớ dùng chung trong ứng dụng. Mức độ phức tạp của việc triển khai phụ thuộc vào chức năng của ứng dụng.

Để bắt đầu, bạn cần thêm tham số truy vấn supportsAllDrives=true vào các yêu cầu khi ứng dụng của bạn thực hiện các thao tác được liệt kê dưới đây:

Drive API phiên bản 3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API phiên bản 2

  • 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

Tham số supportsAllDrives=true thông báo cho Google Drive rằng ứng dụng của bạn được thiết kế để xử lý các tệp trên bộ nhớ dùng chung.

Những ứng dụng đọc hoặc sửa đổi quyền, theo dõi các thay đổi hoặc cần tìm kiếm trên nhiều kho dữ liệu yêu cầu thêm chức năng của bộ nhớ dùng chung. Phần còn lại của tài liệu này nêu bật những thay đổi bổ sung cần thiết để thực hiện các tác vụ này.

Tìm nội dung trên bộ nhớ dùng chung

Sử dụng phương thức files.list để tìm kiếm ổ đĩa dùng chung. Phần này trình bày các trường dành riêng cho bộ nhớ dùng chung trong phương thức files.list. Để tìm bộ nhớ dùng chung, hãy tham khảo phần Tìm tệp và thư mục.

Phương thức files.list chứa các trường và chế độ truy vấn dành riêng cho bộ nhớ dùng chung sau:

  • driveId – Mã nhận dạng của bộ nhớ dùng chung cần tìm.

  • includeItemsFromAllDrives – Có nên đưa các mục trong bộ nhớ dùng chung vào kết quả hay không. Nếu không có hoặc được đặt thành false, thì các mục trên bộ nhớ dùng chung sẽ không được trả về.

  • corpora – Nội dung của các mục (tệp/tài liệu) mà truy vấn áp dụng. Các phần nội dung được hỗ trợ là user, domain, drive và allDrives. Ưu tiên chế độ user hoặc drive hơn chế độ allDrives để tiết kiệm năng lượng.

  • supportsAllDrives – Ứng dụng yêu cầu có hỗ trợ cả Drive của tôi và bộ nhớ dùng chung hay không. Nếu là false, thì các mục trong bộ nhớ dùng chung sẽ không được đưa vào phản hồi.

Sau đây là các chế độ truy vấn dành riêng cho bộ nhớ dùng chung:

includeItemsFromAllDrives corpora Mô tả truy vấn
true user Truy vấn các tệp mà người dùng đã truy cập, bao gồm cả tệp trong bộ nhớ dùng chung và tệp trong Drive của tôi.
true drive Truy vấn tất cả các mục trong bộ nhớ dùng chung được chỉ định. Bạn phải chỉ định driveId trong yêu cầu.
true allDrives Truy vấn các tệp mà người dùng đã truy cập và tất cả bộ nhớ dùng chung mà họ là thành viên. Xin lưu ý rằng phản hồi có thể bao gồm incompleteSearch : true, cho biết một số ngữ liệu không được tìm kiếm cho yêu cầu này.
true domain Truy vấn các tệp được chia sẻ với miền, bao gồm cả tệp trong bộ nhớ dùng chung và tệp trong Drive của tôi.

Theo dõi nội dung thay đổi trên bộ nhớ dùng chung

Sử dụng phương thức changes.list để theo dõi các thay đổi trên bộ nhớ dùng chung. Phần này trình bày các trường dành riêng cho bộ nhớ dùng chung trong phương thức changes.list. Để biết thêm thông tin, hãy tham khảo bài viết Theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung. Phương thức changes.list chứa các trường và chế độ truy vấn dành riêng cho bộ nhớ dùng chung sau:

  • driveId – Bộ nhớ dùng chung mà từ đó các thay đổi được trả về. Nếu được chỉ định, mã thay đổi sẽ đề cập đến các thay đổi trong bộ nhớ dùng chung, chứ không phải các thay đổi đối với tệp mà người dùng nhìn thấy. Để tham chiếu đến một thay đổi cụ thể của bộ nhớ dùng chung, bạn phải sử dụng cả mã bộ nhớ dùng chung và mã thay đổi làm giá trị nhận dạng.
  • supportsAllDrives – Ứng dụng yêu cầu có hỗ trợ bộ nhớ dùng chung hay không. Nếu là false, thì các mục trong bộ nhớ dùng chung (bao gồm cả bộ nhớ dùng chung và tệp trong bộ nhớ dùng chung) sẽ không được trả về.
  • includeItemsFromAllDrives – Có nên đưa các tệp hoặc nội dung thay đổi trong bộ nhớ dùng chung vào danh sách thay đổi hay không.

Sau đây là các chế độ truy vấn dành riêng cho bộ nhớ dùng chung:

includeItemsFromAllDrives driveId Mô tả truy vấn
true Không Các thay đổi này phản ánh những thay đổi đối với tệp bên trong hoặc bên ngoài bộ nhớ dùng chung mà người dùng đã truy cập, cũng như những thay đổi đối với bộ nhớ dùng chung mà người dùng là thành viên.
true Có Các thay đổi này phản ánh những thay đổi đối với bộ nhớ dùng chung cụ thể đã được chỉ định và các mục trong bộ nhớ dùng chung đó.

Để biết thêm thông tin về hành vi của nhật ký thay đổi, hãy tham khảo phần Nhật ký thay đổi.

Bật tính năng hỗ trợ bộ nhớ dùng chung trong giao diện người dùng của Drive

Để truy cập vào nội dung trong bộ nhớ dùng chung bằng giao diện người dùng Drive, hãy đảm bảo bạn đã đánh dấu vào "Hỗ trợ bộ nhớ dùng chung" trong Google API Console. Để biết thêm thông tin, hãy tham khảo bài viết Định cấu hình chế độ tích hợp giao diện người dùng Drive.

Sử dụng trình chọn tệp với bộ nhớ dùng chung

Công cụ chọn tệp hỗ trợ việc chọn các mục trong bộ nhớ dùng chung. Để biết thông tin chi tiết về cách bật tính năng hỗ trợ bộ nhớ dùng chung và thêm chế độ xem bộ nhớ dùng chung vào trình chọn tệp, hãy tham khảo Google Picker API.

Các bước tiếp theo

Tiếp tục xem phần Quản lý bộ nhớ dùng chung để được trợ giúp về cách tạo bộ nhớ dùng chung và quản lý quyền đối với bộ nhớ dùng chung.