Trả về thông tin người dùng

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ên Permission.
  • 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ếu appFilterMimeTypes 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ồm docx 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ấp appFilterExtensions, 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ồm application/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ồm en-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.

Dưới đây là một vài bước tiếp theo bạn có thể thử: