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

Bộ nhớ dùng chung có 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 sẽ phụ thuộc vào chức năng của ứng dụng.

Để bắt đầu, bạn phải 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 sau:

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 tìm kiếm trên nhiều kho dữ liệu cần có thêm các 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 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 một bộ nhớ dùng chung, hãy xem phần 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 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. Theo mặc định, văn bản được đặt thành user.

  • includeItemsFromAllDrives: Liệu cả các mục trong Drive của tôi và bộ nhớ dùng chung có được đưa 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: Ứng dụng yêu cầu có hỗ trợ cả phần "Ổ của tôi" và bộ nhớ dùng chung hay không. Nếu là false, 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 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à tệp trong Drive của tôi.
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.
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.

Theo dõi nội dung 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 bài viết Theo dõi các thay đổi đối với người dùng và ổ đĩa 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à từ đó các thay đổi được trả về. Nếu được chỉ định, 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 một tệp. Để tham chiếu đến một thay đổi cụ thể trên bộ nhớ dùng chung, bạn phải sử dụng cả mã nhận dạng bộ nhớ dùng chung và mã nhận dạng thay đổi.

  • 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 nội dung thay đổi hay không.

  • supportsAllDrives: Liệu ứ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ề.

Sau đây là các chế độ truy vấn 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 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 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à ổ đĩa dùng chung.

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 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 chế độ tích hợp giao diện người dùng Drive.

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

Trình chọn của Google 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, hãy xem Google Picker API.