傳回使用者資訊

Google 雲端硬碟提供兩種方式，可收集雲端硬碟使用者的相關資訊：

  • 您可以使用 about 資源，擷取使用者、使用者的 Google 雲端硬碟設定和系統功能相關資訊。

  • 您可以使用 apps 資源，擷取使用者已安裝的應用程式清單，並取得每個應用程式支援的 MIME 類型、副檔名和其他詳細資料。

本指南說明如何在 Google 雲端硬碟中擷取使用者資訊。

取得使用者詳細資料

如要將雲端硬碟使用者的資訊做為 about 的例項傳回，請使用 get() 方法。傳回的值是以位元組為單位。

get() 方法需要 fields 參數，才能列出回應中要傳回的欄位。如果省略參數，方法會傳回錯誤。如要傳回所需的確切欄位，請參閱「傳回特定欄位」。

顯示範例

以下程式碼範例說明如何在要求中提供多個 fields 做為查詢參數。回應會傳回要求的欄位值。

要求

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

回應

{
  "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"
  }
}

回應會包含下列值：

  • DISPLAY_NAME：使用者名稱 (純文字)。
  • PHOTO_LINK：使用者個人資料相片的網址。
  • PERMISSION_ID：Permission 資源中的使用者 ID。
  • EMAIL_ADDRESS：使用者的電子郵件地址

列出使用者應用程式

Google 雲端硬碟應用程式會列於 Google Workspace Marketplace 中，用於提升 Google 雲端硬碟的便利性，例如 Google 文件應用程式，或是用於在 Google 文件中簽署文件的外掛程式。詳情請參閱「使用 Google 雲端硬碟應用程式」。

如要傳回使用者已安裝的所有應用程式清單，並做為 apps 的例項，請使用 list() 方法，但不附加任何參數。

您可以設定 fields 參數，列出回應中要傳回的欄位。如要傳回所需的確切欄位，請參閱「傳回特定欄位」一節。

顯示範例

以下程式碼範例說明如何在要求中傳回使用者安裝的所有應用程式清單。回應會傳回要求的欄位值。

要求

GET https://www.googleapis.com/drive/v3/apps

回應

{
  "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"
  ]
}

回應會包含下列值：

  • ID：應用程式 ID。
  • PRODUCT_ID：這個應用程式的產品資訊 ID。

使用查詢參數列出使用者應用程式

如要找出特定應用程式，請使用一或多個選用查詢參數：

  • appFilterExtensions：使用以半形逗號分隔的副檔名清單篩選搜尋結果。回應中會包含應用程式查詢範圍內可開啟所列副檔名的應用程式。如果同時提供 appFilterMimeTypes，系統會傳回兩個產生應用程式清單的聯集。擴充功能的範例包括 Microsoft Word 的 docx 和 Microsoft PowerPoint 的 pptx。如需更多檔案副檔名範例，請參閱「匯出 Google Workspace 文件的 MIME 類型」。

    以下程式碼範例說明如何提供多個檔案副檔名做為查詢參數：GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx。

  • appFilterMimeTypes：使用以半形逗號分隔的 MIME 類型清單篩選搜尋結果。回應中會列出應用程式查詢範圍內可開啟所列 MIME 類型的應用程式。如果同時提供 appFilterExtensions，系統會傳回兩個產生應用程式清單的聯集。MIME 類型的範例包括 Google 表單的 application/vnd.google-apps.form，以及 Google 協作平台的 application/vnd.google-apps.site。如需更多 MIME 類型範例，請參閱「Google Workspace 和 Google 雲端硬碟支援的 MIME 類型」。

    以下程式碼範例說明如何將多個 MIME 類型做為查詢參數提供：GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site。

  • languageCode：使用 BCP 47 定義的語言或語言代碼，搭配 Unicode 的 LDML 格式中的部分擴充功能篩選搜尋結果。語言代碼的範例包括 en-us (英文 (美國)) 和 fr-ca (法文 (加拿大))。

    以下程式碼範例說明如何將多個語言代碼做為查詢參數提供：GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca。

根據 ID 取得使用者應用程式

如要將詳細應用程式資訊下載為 apps 的例項，請使用應用程式 ID 搭配 get() 方法。

顯示範例

以下程式碼範例說明如何在要求中提供 appId 做為查詢參數。回應會傳回要求的欄位值。

要求

GET https://www.googleapis.com/drive/v3/apps/APP_ID

回應

{
  "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"
}

回應會包含下列值：

  • ID：應用程式 ID。
  • PRODUCT_ID：這個應用程式的產品資訊 ID。

以下是您可以嘗試的後續步驟：