Method: users.getCapabilities
Stay organized with collections
Save and categorize content based on your preferences.
Gets the user capabilities.
HTTP request
GET https://drivelabels.googleapis.com/v2beta/{name=users/*/capabilities}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. The resource name of the user. Only "users/me/capabilities" is supported.
|
Query parameters
| Parameters |
customer |
string
The customer to scope this request to. For example: "customers/abcd1234". If unset, will return settings within the current customer.
|
Request body
The request body must be empty.
Response body
The capabilities of a user.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"name": string,
"canAccessLabelManager": boolean,
"canAdministrateLabels": boolean,
"canCreateSharedLabels": boolean,
"canCreateAdminLabels": boolean
} |
| Fields |
name |
string
Output only. Resource name for the user capabilities.
|
canAccessLabelManager |
boolean
Output only. Whether the user is allowed access to the label manager.
|
canAdministrateLabels |
boolean
Output only. Whether the user is an administrator for the shared labels feature.
|
canCreateSharedLabels |
boolean
Output only. Whether the user is allowed to create new shared labels.
|
canCreateAdminLabels |
boolean
Output only. Whether the user is allowed to create new admin labels.
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-12 UTC.
[null,null,["Last updated 2025-06-12 UTC."],[],[],null,["# Method: users.getCapabilities\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.UserCapabilities.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets the user capabilities.\n\n### HTTP request\n\n`GET https://drivelabels.googleapis.com/v2beta/{name=users/*/capabilities}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name of the user. Only \"users/me/capabilities\" is supported. |\n\n### Query parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` The customer to scope this request to. For example: \"customers/abcd1234\". If unset, will return settings within the current customer. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe capabilities of a user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"canAccessLabelManager\": boolean, \"canAdministrateLabels\": boolean, \"canCreateSharedLabels\": boolean, \"canCreateAdminLabels\": boolean } ``` |\n\n| Fields ||\n|-------------------------|--------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name for the user capabilities. |\n| `canAccessLabelManager` | `boolean` Output only. Whether the user is allowed access to the label manager. |\n| `canAdministrateLabels` | `boolean` Output only. Whether the user is an administrator for the shared labels feature. |\n| `canCreateSharedLabels` | `boolean` Output only. Whether the user is allowed to create new shared labels. |\n| `canCreateAdminLabels` | `boolean` Output only. Whether the user is allowed to create new admin labels. |\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)."]]
