傳回使用者資訊

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

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

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

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

取得使用者詳細資料

如要以 about 的執行個體形式傳回雲端硬碟使用者資訊，請使用 get 方法。傳回值以位元組為單位。

您必須在 get 方法中設定 fields system 參數，指定要在回應中傳回的欄位。在大多數 Google 雲端硬碟方法中，這項動作僅用於傳回非預設欄位，但對於 about 資源而言，這項動作是必要步驟。如果省略參數，這個方法會傳回錯誤。詳情請參閱「傳回特定欄位」。

以下程式碼範例說明如何在要求中以查詢參數的形式提供多個 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 雲端硬碟應用程式」。

如要以 apps 執行個體的形式，傳回使用者安裝的所有應用程式清單，請使用 list 方法，且不帶任何參數。

如要指定要在回應中傳回的欄位，請設定 fields system 參數。如未指定 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 的執行個體形式下載詳細應用程式資訊，請使用 get 方法和應用程式 ID。

以下程式碼範例說明如何在要求中以查詢參數的形式提供 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。

建議您採取下列後續步驟：