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 quá trình triển khai phụ thuộc vào chức năng của ứng dụng.

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

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 ứng dụng của bạn được thiết kế để xử lý các tệp trên bộ nhớ dùng chung.

Các ứng dụng đọc hoặc sửa đổi quyền, theo dõi các thay đổi hoặc tìm kiếm trên nhiều tập hợp dữ liệu yêu cầu các tính 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 thiết để thực hiện các tác vụ này.

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

Sử dụng phương thức list trên tài nguyên files để tìm tệp của người dùng trong bộ nhớ dùng chung. Để tìm kiếm bộ nhớ dùng chung, hãy xem Tìm kiếm bộ nhớ dùng chung.

Phương thức list chứa các tham số 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 kiếm.

  • corpora: Nội dung của các mục (tệp hoặc tài liệu) mà truy vấn áp dụng. Các nội dung được hỗ trợ là user, domain, drive và allDrives. Bạn nên dùng user hoặc drive thay vì allDrives để đảm bảo hiệu quả. Theo mặc định, corpora được đặt thành user.

  • includeItemsFromAllDrives: Cho biết có nên đưa cả các mục trong Drive của tôi và 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 trong bộ nhớ dùng chung sẽ không được trả về.

  • supportsAllDrives: Cho biết ứ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.

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

includeItemsFromAllDrives corpora Nội dung 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à Drive của tôi.
true domain Truy vấn các tệp được chia sẻ cho miền, bao gồm cả tệp trong bộ nhớ dùng chung và 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 rằng một số tập hợp dữ liệu không được tìm kiếm cho yêu cầu này.

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

Sử dụng phương thức list trên tài nguyên changes để theo dõi các thay đổi trên bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem Theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.

Phương thức list chứa các tham số truy vấn dành riêng cho bộ nhớ dùng chung sau:

  • driveId: Bộ nhớ dùng chung mà các thay đổi được trả về. Nếu được chỉ định, thì mã nhận dạng thay đổi sẽ đề cập đến các thay đổi đối với các mục trong bộ nhớ dùng chung cung cấp trạng thái hiện tại của tệp. Để tham chiếu đến một thay đổi cụ thể của bộ nhớ dùng chung, cả mã nhận dạng bộ nhớ dùng chung và mã nhận dạng thay đổi đều phải được dùng làm mã nhận dạng.

  • includeItemsFromAllDrives: Cho biết có nên đưa các tệp hoặc thay đổi của bộ nhớ dùng chung vào danh sách thay đổi hay không.

  • supportsAllDrives: Cho biết ứ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ề.

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

includeItemsFromAllDrives driveId Nội dung mô tả truy vấn
true Không Các thay đổi 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ư các 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 xem bài viết Theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.

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 nhớ đánh dấu vào hộp Hỗ trợ bộ nhớ dùng chung trên thẻ Tích hợp giao diện người dùng Drive của Google Drive API trong Google Cloud Console. Để biết thêm thông tin, hãy xem bài viết Định cấu hình tích hợp giao diện người dùng Drive.

Sử dụng Google Picker với bộ nhớ dùng chung

Google Picker 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 trong trình chọn, hãy xem API Google Picker.