Method: labels.get

按资源名称获取标签。资源名称可以是以下任一项：

  • labels/{id} - 请参阅 labels/{id}@latest
  • labels/{id}@latest - 获取标签的最新修订版本。
  • labels/{id}@published - 获取标签的当前已发布修订版本。
  • labels/{id}@{revisionId} - 获取指定修订版本 ID 的标签。

HTTP 请求

GET https://drivelabels.googleapis.com/v2/{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

如需了解详情，请参阅授权指南。