Method: labels.permissions.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Aggiorna le autorizzazioni di un'etichetta. Se non esiste un'autorizzazione per il principal indicato, viene creata un'autorizzazione per l'etichetta; in caso contrario, l'autorizzazione esistente viene aggiornata. Le autorizzazioni interessano la risorsa etichetta nel suo complesso, non vengono sottoposte a revisione e non richiedono la pubblicazione.
Richiesta HTTP
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
parent |
string
Obbligatorio. Viene creato il nome della risorsa etichetta principale nell'autorizzazione etichetta. Formato: labels/{label} .
|
Parametri di query
Parametri |
useAdminAccess |
boolean
Imposta su true per utilizzare le credenziali di amministratore dell'utente. Prima di consentire l'accesso, il server verificherà che l'utente sia un amministratore dell'etichetta.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di LabelPermission
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di LabelPermission
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-05 UTC.
[null,null,["Ultimo aggiornamento 2025-08-05 UTC."],[],[],null,["# Method: labels.permissions.create\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.\n\n### HTTP request\n\n`POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent label resource name on the label permission is created. Format: `labels/{label}`. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `useAdminAccess` | `boolean` Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. |\n\n### Request body\n\nThe request body contains an instance of [LabelPermission](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [LabelPermission](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission).\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.admin.labels`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]