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

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

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

API Drive 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

API Drive 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 đượ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ính năng tìm kiếm trên nhiều tập sao lục đòi hỏi chức năng bổ sung 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 thực hiện các nhiệm vụ này.

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

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

Phương thức files.list chứa các dữ liệu được chia sẻ sau các trường và chế độ truy vấn dành riêng cho Drive:

  • driveId – Mã bộ nhớ dùng chung cần tìm kiếm.

  • includeItemsFromAllDrives – Liệu có nên đưa các mục trong bộ nhớ dùng chung vào hay không trong kết quả. 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ả lại.

  • corpora — Nội dung của các mục (tệp/tài liệu) để mà cụm từ tìm kiếm áp dụng. Các phần tử được hỗ trợ là user, domain, drive và allDrives. Ưu tiên user hoặc drive thành allDrives để đảm bảo tính hiệu quả.

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

Các chế độ truy vấn sau đây 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 trên 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. Lưu ý rằng phản hồi có thể bao gồm incompleteSearch : true, cho biết rằng một số tập sao lục chưa đượ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 trên Drive của tôi.

Theo dõi các 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 đề cập đến các trường dành riêng cho bộ nhớ dùng chung trong phần changes.list. Để biết thêm thông tin, hãy tham khảo 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 dữ liệu được chia sẻ sau các trường và chế độ truy vấn dành riêng cho Drive:

  • driveId – Bộ nhớ dùng chung mà từ đó các thay đổi được trả về. Nếu đã chỉ định, thì mã thay đổi tham chiếu đến những thay đổi trong bộ nhớ dùng chung, chứ không phải đối với các tệp được hiển thị cho người dùng. Để tham chiếu đến một bộ nhớ dùng chung cụ thể thay đổi, bạn phải 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ợ chế độ được chia sẻ hay không Drive. Nếu giá trị là false, thì các mục trong bộ nhớ dùng chung, bao gồm cả bộ nhớ dùng chung và các tệp trong bộ nhớ dùng chung sẽ không được trả lại.
  • includeItemsFromAllDrives — Liệu các thay đổi hoặc tệp trên bộ nhớ dùng chung có nên được được đưa vào danh sách thay đổi.

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

includeItemsFromAllDrives driveId Mô tả truy vấn
true Không Những thay đổi này phản ánh những thay đổi đối với các 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 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 bên trong bộ nhớ dùng chung đó.

Để biết thêm thông tin chi tiết về hành vi của nhật ký thay đổi, hãy tham khảo 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 Drive

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

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

Bộ chọn tệp hỗ trợ 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à cách thêm chế độ xem bộ nhớ dùng chung trong bộ chọn tệp, hãy tham khảo Google4 API.

Các bước tiếp theo

Tiếp tục Quản lý bộ nhớ dùng chung cho thông tin trợ giúp về cách tạo bộ nhớ dùng chung và quản lý quyền truy cập vào bộ nhớ dùng chung.