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}(相当于 labels/{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

有关详情,请参阅授权指南