列出标签。
HTTP 请求
GET https://drivelabels.googleapis.com/v2/labels
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
publishedOnly |
是否仅在结果中包含已发布的标签。
|
customer |
要将此列表请求范围限定的客户。例如:“customers/abcd1234”。如果未设置,将返回当前客户的所有标签。 |
languageCode |
用于评估本地化字段标签的 BCP-47 语言代码。如果未指定,系统会使用默认配置语言中的值。 |
pageSize |
每页返回的标签数上限。默认值:50。最大值:200。 |
pageToken |
要返回的页面的令牌。 |
view |
指定此参数时,系统仅返回属于指定视图的特定字段。 |
联合参数
|
|
useAdminAccess |
设置为 |
minimumRole |
指定用户对返回的标签必须拥有的访问权限级别。用户对标签必须具备的最低角色。默认为 |
请求正文
请求正文必须为空。
响应正文
针对列出标签的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"labels": [
{
object ( |
字段 | |
---|---|
labels[] |
标签。 |
nextPageToken |
响应中下一页的令牌。 |
授权范围
需要以下 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
有关详情,请参阅授权指南。