傳回使用者資訊

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

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

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

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

取得使用者詳細資料

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

您必須在 get 方法上設定 fields 系統參數，才能指定要在回應中傳回的欄位。在大多數 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 系統參數。如果您未指定 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。

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