傳回使用者資訊

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

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

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

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

取得使用者詳細資料

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

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

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

列出使用者應用程式

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

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

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

• 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。

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

相關主題

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

• 如要在雲端硬碟中建立檔案，請參閱「建立及管理檔案」。

• 如要在建立或更新檔案時上傳檔案資料，請參閱「上傳檔案資料」。

• 如要下載及匯出檔案，請參閱「下載及匯出檔案」。