List labels.
HTTP request
GET https://drivelabels.googleapis.com/v2beta/labels
The URL uses gRPC Transcoding syntax.
Query parameters
Parameters | |
---|---|
publishedOnly |
Whether to include only published labels in the results.
|
customer |
The customer to scope this list request to. For example: "customers/abcd1234". If unset, will return all labels within the current customer. |
languageCode |
The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used. |
pageSize |
Maximum number of labels to return per page. Default: 50. Max: 200. |
pageToken |
The token of the page to return. |
view |
When specified, only certain fields belonging to the indicated view are returned. |
Union parameter
|
|
useAdminAccess |
Set to |
minimumRole |
Specifies the level of access the user must have on the returned Labels. The minimum role a user must have on a label. Defaults to |
Request body
The request body must be empty.
Response body
Response for listing Labels.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"labels": [
{
object ( |
Fields | |
---|---|
labels[] |
Labels. |
nextPageToken |
The token of the next page in the response. |
Authorization scopes
Requires one of the following OAuth scopes:
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
For more information, see the Authorization guide.