Method: labels.get

依據資源名稱取得標籤。資源名稱可以是下列任一值:

  • labels/{id} - 請參閱 labels/{id}@latest
  • labels/{id}@latest - 取得標籤的最新修訂版本。
  • labels/{id}@published - 取得標籤目前發布的修訂版本。
  • labels/{id}@{revisionId} - 取得指定修訂版本 ID 的標籤。

HTTP 要求

GET https://drivelabels.googleapis.com/v2beta/{name=labels/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。標籤資源名稱。

可以是下列任一值:

  • labels/{id} (相當於標籤/{id}@latest)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

查詢參數

參數
useAdminAccess

boolean

如要使用使用者的管理員憑證,請設為 true。伺服器在授予存取權前,會驗證使用者是否是該標籤的管理員。

languageCode

string

用於評估本地化欄位標籤的 BCP-47 語言代碼。如未指定,系統會使用預設語言的值。

view

enum (LabelView)

如果有指定,系統只會傳回屬於指定檢視畫面的特定欄位。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Label 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

詳情請參閱授權指南