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

Google Drive cung cấp hai cách để 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 của người dùng trên Drive và các tính năng của hệ thống.

  • 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 và thông tin chi tiết khác được hỗ trợ 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ề 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ị được trả về được đo bằng byte.

Phương thức get() yêu cầu tham số fields để liệt kê các trường cần trả về trong phản hồi. Nếu bạn bỏ qua tham số này, phương thức sẽ trả về lỗi. Để trả về chính xác các trường bạn cần, hãy xem phần Trả về các trường cụ thể.

Hiển thị ví dụ

Mã mẫu sau đây cho biết cách cung cấp nhiều fields làm tham số truy vấn trong yêu cầu. Phản hồi 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 người dùng ở dạng văn bản thuần tuý.
  • PHOTO_LINK: URL của ả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

Liệt kê ứ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 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 bài viết Sử dụng ứng dụng Google Drive.

Để trả về danh sách tất 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ần tham số nào.

Bạn có thể đặt tham số fields để liệt kê các trường cần trả về trong phản hồi. Để trả về chính xác các trường bạn cần, hãy xem phần Trả về các trường cụ thể.

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 đã cài đặt của người dùng trong yêu cầu. Phản hồi 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ã 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 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 danh sách các đ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 đuôi tệp được liệt kê sẽ có trong phản hồi. Nếu bạn cũng cung cấp appFilterMimeTypes, thì hệ thống sẽ trả về kết quả hợp nhất của hai danh sách ứng dụng. Ví dụ về 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 loại MIME cho tài liệu 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 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 bạn cũng cung cấp appFilterExtensions, thì hệ thống sẽ trả về kết quả hợp nhất của hai danh sách ứng dụng. Ví dụ về 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 bài viết Các loại MIME được 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 cách sử dụng mã ngôn ngữ hoặc mã ngôn ngữ, như được xác định bởi 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).

    Mã mẫu sau đây cho biết cách cung cấp nhiều mã ngôn ngữ dưới dạng tham số truy vấn: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Lấy ứ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 get() với mã ứng dụng.

Hiển thị ví dụ

Mẫu mã sau đây cho biết cách cung cấp appId làm tham số truy vấn trong yêu cầu. Phản hồi 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ã 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ử: