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

Google Drive cung cấp 2 lựa chọn để thu thập thông tin về người dùng Drive:

  • Khi 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 hệ thống của họ.

  • Khi 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, cùng với thông tin về các loại MIME, đuôi tệp được hỗ trợ và các thông tin 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.

Xem thông tin chi tiết về một người dùng

Để trả về thông tin về người dùng Drive dưới dạng một thực thể của about, hãy sử dụng phương thức get. Các giá trị trả về được đo bằng byte.

Bạn phải đặt tham số hệ thống fields trên phương thức get để chỉ định các trường cần trả về trong phản hồi. Trong hầu hết các phương thức Drive, bạn chỉ cần thực hiện thao tác này để trả về các trường không mặc định, nhưng đây là thao tác bắt buộc đối với tài nguyên about. Nếu bạn bỏ qua tham số, phương thức này sẽ trả về lỗi. Để biết thêm thông tin, hãy xem phần Trả về các trường cụ thể.

Mẫu mã sau đây cho biết cách cung cấp nhiều fields dưới dạng một tham số truy vấn trong yêu cầu. Phản hồi này trả về các giá trị 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 của ảnh hồ sơ người dùng.
  • PERMISSION_ID: mã nhận dạng của người dùng trong các tài nguyên Permission.
  • EMAIL_ADDRESS: địa chỉ email của người dùng

Liệt kê các ứng dụng của người dùng

Các ứng dụng 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 một tiện ích bổ sung được dùng trong Tài liệu để ký tài liệu. Để biết thêm thông tin, hãy xem bài viết Sử dụng các ứng dụng của 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 list mà không có bất kỳ tham số nào.

Nếu muốn chỉ định các trường cần trả về trong phản hồi, bạn có thể đặt fields tham số hệ thống. Nếu bạn không chỉ định tham số fields, thì máy chủ sẽ trả về một nhóm trường mặc định. Để biết thêm thông tin, hãy xem phần Trả về các trường cụ thể.

Đoạn mã sau đây cho biết cách trả về danh sách tất cả các ứng dụng đã cài đặt của người dùng trong yêu cầu. Phản hồi này trả về các giá trị 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ã nhận dạng trang thông tin sản phẩm cho ứng dụng này.

Liệt kê các ứng dụng của người dùng bằng 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 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ở các tiện ích tệp được liệt kê sẽ được đưa vào phản hồi. Nếu bạn cũng cung cấp appFilterMimeTypes, thì hệ thống sẽ trả về một danh sách hợp nhất của hai danh sách ứng dụng kết quả. Ví dụ về tiện ích bao gồm docx cho Microsoft Word và pptx cho Microsoft PowerPoint. Để xem thêm ví dụ về phần mở rộng của 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 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 appFilterExtensions cũng được cung cấp, thì một hợp của hai danh sách ứng dụng kết quả 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. Để xem thêm ví dụ về các loại MIME, hãy xem bài viết Các loại MIME được Google Workspace và Google Drive hỗ trợ.

    Đoạn mã mẫu sau đây cho thấy cách cung cấp nhiều loại MIME dưới dạng một 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ã ngôn ngữ hoặc mã ngôn ngữ và quốc gia, theo định nghĩa của BCP 47, với một số tiện ích từ định dạng LDML của Unicode. Ví dụ về mã ngôn ngữ bao gồm en-us cho tiếng Anh (Hoa Kỳ) và fr-ca cho tiếng Pháp (Canada).

    Đoạn 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.

Lấy ứng dụng 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 phiên bản của apps, hãy dùng phương thức get với mã ứng dụng.

Mẫu mã sau đây cho thấy cách cung cấp một appId làm tham số truy vấn trong yêu cầu. Phản hồi này trả về các giá trị 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ã nhận dạng trang thông tin sản phẩm cho ứng dụng này.

Sau đây là một số bước tiếp theo mà bạn có thể thử: