Google Drive cung cấp hai tuỳ chọn để thu thập thông tin về người dùng Drive:
Bằng cách sử dụng tài nguyên
about
, bạn có thể truy xuất thông tin về người dùng, chế độ cài đặt Drive của người dùng và các chức năng của hệ thống.Bằng cách sử dụng tài nguyên
apps
, bạn có thể truy xuất danh sách các ứng dụng đã cài đặt của người dùng, kèm theo thông tin về các loại MIME được hỗ trợ, đuôi tệp và các thông tin chi tiết khác của từng ứng dụng.
Hướng dẫn này giải thích cách bạn có thể truy xuất thông tin người dùng trong Drive.
Tìm nạp thông tin về người dùng
Để trả về thông tin về người dùng Drive dưới dạng thực thể của about
, hãy sử dụng phương thức about.get
. Phương thức about.get
yêu cầu tham số truy vấn fields
trong lệnh gọi phương thức. Các giá trị trả về được đo bằng byte. Để biết thêm thông tin, hãy xem phần Trả về các trường cụ thể cho một tệp.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách cung cấp nhiều fields
dưới dạng tham số truy vấn trong yêu cầu. Phản hồi này sẽ trả về các giá trị của trường cho yêu cầu.
Yêu cầu
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Đáp
{ "kind": "drive#about", "user": { "kind": "drive#user", "displayName": "DISPLAY_NAME", "photoLink": "PHOTO_LINK", "me": true, "permissionId": "PERMISSION_ID", "emailAddress": "EMAIL_ADDRESS" }, "storageQuota": { "usage": "10845031958", "usageInDrive": "2222008387", "usageInDriveTrash": "91566" } }
Phản hồi bao gồm các giá trị sau:
DISPLAY_NAME
: tên của người dùng ở dạng văn bản thuần tuý.PHOTO_LINK
: URL ảnh hồ sơ của người dùng.PERMISSION_ID
: mã nhận dạng của người dùng trong tài nguyênPermission
.EMAIL_ADDRESS
: địa chỉ email của người dùng
Tìm nạp thông tin về ứng dụng của người dùng
Các ứng dụng dành cho Google Drive được liệt kê trong Google Workspace Marketplace và được dùng để giúp Drive trở nên thuận tiện hơn, chẳng hạn như ứng dụng Google Tài liệu hoặc tiện ích bổ sung dùng trong Tài liệu để ký tài liệu. Để biết thêm thông tin, hãy xem phần Sử dụng các ứng dụng Google Drive.
Để trả về danh sách tất cả các ứng dụng đã cài đặt của người dùng dưới dạng một thực thể của apps
, hãy sử dụng phương thức apps.list
không có bất kỳ tham số nào.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách trả về danh sách tất cả ứng dụng mà người dùng đã cài đặt trong yêu cầu. Phản hồi này sẽ trả về các giá trị của trường cho yêu cầu.
Yêu cầu
GET https://www.googleapis.com/drive/v3/apps
Đáp
{ "kind": "drive#appList", "selfLink": "https://www.googleapis.com/drive/v3/apps", "items": [ { "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" } ], "defaultAppIds": [ "ID" ] }
Phản hồi bao gồm các giá trị sau:
ID
: mã ứng dụng.PRODUCT_ID
: mã trang thông tin sản phẩm của ứng dụng này.
Liệt kê các ứng dụng của người dùng có tham số truy vấn
Để tìm một ứng dụng cụ thể, hãy sử dụng một hoặc nhiều tham số truy vấn không bắt buộc:
appFilterExtensions
: Lọc kết quả tìm kiếm bằng cách sử dụng danh sách đuôi tệp được phân tách bằng dấu phẩy. Các ứng dụng trong phạm vi truy vấn ứng dụng có thể mở đuôi tệp được liệt kê sẽ được đưa vào phản hồi. NếuappFilterMimeTypes
cũng được cung cấp, kết hợp của hai danh sách ứng dụng thu được sẽ được trả về. Ví dụ về các tiện ích bao gồmdocx
cho Microsoft Word vàpptx
cho Microsoft PowerPoint. Để biết thêm ví dụ về đuôi tệp, hãy xem bài viết Xuất các loại MIME cho tài liệu trên Google Workspace.Mã mẫu sau đây cho biết cách cung cấp nhiều đuôi tệp dưới dạng một tham số truy vấn:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: Lọc kết quả tìm kiếm bằng cách sử dụng danh sách các loại MIME được phân tách bằng dấu phẩy. Các ứng dụng trong phạm vi truy vấn ứng dụng có thể mở các loại MIME được liệt kê sẽ được đưa vào phản hồi. Nếu cũng cung cấpappFilterExtensions
, kết quả kết hợp của hai danh sách ứng dụng thu được sẽ được trả về. Ví dụ về các loại MIME bao gồmapplication/vnd.google-apps.form
cho Google Biểu mẫu vàapplication/vnd.google-apps.site
cho Google Sites. Để biết thêm ví dụ về các loại MIME, hãy xem Các loại MIME mà Google Workspace và Google Drive hỗ trợ.Mã mẫu sau đây cho biết cách cung cấp nhiều loại MIME dưới dạng tham số truy vấn:
GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site
.languageCode
: Lọc kết quả tìm kiếm bằng một ngôn ngữ hoặc mã ngôn ngữ (theo BCP 47) xác định với một số phần mở rộng ở định dạng LDML của Unicode. Ví dụ về mã ngôn ngữ bao gồmen-us
cho tiếng Anh (Mỹ) vàfr-ca
cho tiếng Pháp (Canada).Mã mẫu sau đây cho biết cách cung cấp nhiều mã ngôn ngữ dưới dạng một tham số truy vấn:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Tải ứng dụng của người dùng theo mã nhận dạng
Để tải thông tin chi tiết về ứng dụng xuống dưới dạng một thực thể của apps
, hãy sử dụng phương thức apps.get
với mã ứng dụng.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách cung cấp appId
dưới dạng tham số truy vấn trong yêu cầu. Phản hồi này sẽ trả về các giá trị của trường cho yêu cầu.
Yêu cầu
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Đáp
{ "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" }
Phản hồi bao gồm các giá trị sau:
ID
: mã ứng dụng.PRODUCT_ID
: mã trang thông tin sản phẩm của ứng dụng này.
Chủ đề có liên quan
Dưới đây là một vài bước tiếp theo bạn có thể thử:
Để tạo tệp trong Drive, hãy xem phần Tạo tệp.
Để tải dữ liệu tệp lên khi bạn tạo hoặc cập nhật tệp, hãy xem bài viết Tải dữ liệu tệp lên.
Để tải xuống và xuất tệp, hãy xem bài viết Tải xuống và xuất tệp.