Whether to include only published labels in the results.
When true, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (labels/{id}/{revisionId}).
When false, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (labels/{id}).
customer
string
The customer to scope this list request to. For example: "customers/abcd1234". If unset, will return all labels within the current customer.
languageCode
string
The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.
pageSize
integer
Maximum number of labels to return per page. Default: 50. Max: 200.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-12 UTC."],[],[],null,["# Method: labels.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListLabelsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList labels.\n\n### HTTP request\n\n`GET https://drivelabels.googleapis.com/v2beta/labels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `publishedOnly` | `boolean` Whether to include only published labels in the results. - When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revisionId}`). - When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`). |\n| `customer` | `string` The customer to scope this list request to. For example: \"customers/abcd1234\". If unset, will return all labels within the current customer. |\n| `languageCode` | `string` The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used. |\n| `pageSize` | `integer` Maximum number of labels to return per page. Default: 50. Max: 200. |\n| `pageToken` | `string` The token of the page to return. |\n| `view` | `enum (`[LabelView](/workspace/drive/labels/reference/rest/v2beta/LabelView)`)` When specified, only certain fields belonging to the indicated view are returned. |\n| Union parameter `access`. `access` can be only one of the following: ||\n| `useAdminAccess` | `boolean` Set to `true` in order to use the user's admin credentials. This will return all Labels within the customer. |\n| `minimumRole` | `enum (`[LabelRole](/workspace/drive/labels/reference/rest/v2beta/labels.permissions#LabelPermission.LabelRole)`)` 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 `READER`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for listing Labels.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"labels\": [ { object (/workspace/drive/labels/reference/rest/v2beta/labels#Label) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------|\n| `labels[]` | `object (`[Label](/workspace/drive/labels/reference/rest/v2beta/labels#Label)`)` Labels. |\n| `nextPageToken` | `string` The token of the next page in the response. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.labels`\n- `\n https://www.googleapis.com/auth/drive.labels.readonly`\n- `\n https://www.googleapis.com/auth/drive.admin.labels`\n- `\n https://www.googleapis.com/auth/drive.admin.labels.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
