傳回使用者資訊

Google 雲端硬碟提供兩種收集雲端硬碟使用者資訊的選項：

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

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

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

擷取使用者相關資訊

如要以 about 執行個體的形式傳回雲端硬碟使用者的資訊，請使用 about.get 方法。about.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 雲端硬碟應用程式」一文。

如要傳回使用者已安裝應用程式的完整清單，做為 apps 執行個體，請使用 apps.list 方法 (不含任何參數)。

顯示範例

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

要求

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 的 apps.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。

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