Method: users.getCapabilities
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft die Nutzerfunktionen ab.
HTTP-Anfrage
GET https://drivelabels.googleapis.com/v2/{name=users/*/capabilities}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Der Ressourcenname des Nutzers. Nur „users/me/capabilities“ wird unterstützt.
|
Abfrageparameter
| Parameter |
customer |
string
Der Kunde, auf den sich diese Anfrage bezieht. Beispiel: customers/abcd1234. Wenn nicht festgelegt, werden Einstellungen innerhalb des aktuellen Kunden zurückgegeben.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Fähigkeiten eines Nutzers.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"name": string,
"canAccessLabelManager": boolean,
"canAdministrateLabels": boolean,
"canCreateSharedLabels": boolean,
"canCreateAdminLabels": boolean
} |
| Felder |
name |
string
Nur Ausgabe. Ressourcenname für die Nutzerfunktionen.
|
canAccessLabelManager |
boolean
Nur Ausgabe. Gibt an, ob der Nutzer Zugriff auf den Label Manager hat.
|
canAdministrateLabels |
boolean
Nur Ausgabe. Gibt an, ob der Nutzer ein Administrator für die Funktion „Gemeinsame Labels“ ist.
|
canCreateSharedLabels |
boolean
Nur Ausgabe. Gibt an, ob der Nutzer freigegebene Labels erstellen darf.
|
canCreateAdminLabels |
boolean
Nur Ausgabe. Gibt an, ob der Nutzer Administratorlabels erstellen darf.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie im Autorisierungsleitfaden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-05 (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/v2/{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, it 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 shared labels. |\n| `canCreateAdminLabels` | `boolean` Output only. Whether the user is allowed to create 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)."]]
