Recurso: permissão
Uma permissão para um arquivo. Uma permissão concede a um usuário, grupo, domínio ou mundo acesso a um arquivo ou uma hierarquia de pastas.
Alguns métodos de recurso (como permissions.update
) exigem um permissionId
. Use o método permissions.list
para recuperar o ID de um arquivo, uma pasta ou um drive compartilhado.
Representação JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Campos | |
---|---|
id |
Apenas saída. O ID dessa permissão. Esse é um identificador exclusivo do beneficiário e publicado nos recursos do usuário como |
displayName |
Apenas saída. O nome "bem" do valor da permissão. Veja a seguir uma lista de exemplos para cada tipo de permissão:
|
type |
O tipo do beneficiário. Os valores válidos são:
Ao criar uma permissão, se |
kind |
Apenas saída. Identifica o tipo de recurso. Valor: a string fixa |
permissionDetails[] |
Apenas saída. Mostra se as permissões neste item do drive compartilhado são herdadas ou estão diretamente nele. Este é um campo de saída apenas para itens do drive compartilhado. |
permissionDetails[].permissionType |
Apenas saída. O tipo de permissão para este usuário. Embora novos valores possam ser adicionados no futuro, é possível fazer o seguinte:
|
permissionDetails[].inheritedFrom |
Apenas saída. Código do item do qual esta permissão é herdada. Este é um campo somente de saída. |
permissionDetails[].role |
Apenas saída. A função principal deste usuário. Embora novos valores possam ser adicionados no futuro, é possível fazer o seguinte:
|
permissionDetails[].inherited |
Apenas saída. Indica se essa permissão é herdada. Esse campo é sempre preenchido. Este é um campo somente de saída. |
photoLink |
Apenas saída. Um link para a foto do perfil do usuário, se disponível. |
emailAddress |
O endereço de e-mail do usuário ou grupo ao qual esta permissão se refere. |
role |
O papel concedido por essa permissão. Embora novos valores possam ser suportados no futuro, os seguintes itens são permitidos:
|
allowFileDiscovery |
Indica se a permissão permite que o arquivo seja descoberto na pesquisa. Isso se aplica apenas a permissões do tipo |
domain |
O domínio ao qual esta permissão se refere. |
expirationTime |
A hora em que esta permissão expirará (data e hora RFC 3339). Os prazos de validade têm as seguintes restrições:
|
teamDrivePermissionDetails[] |
Apenas saída. Obsoleto: somente saída. Use |
teamDrivePermissionDetails[] |
Obsoleto: somente saída. Use |
teamDrivePermissionDetails[] |
Obsoleto: somente saída. Use |
teamDrivePermissionDetails[] |
Obsoleto: somente saída. Use |
teamDrivePermissionDetails[] |
Obsoleto: somente saída. Use |
deleted |
Apenas saída. Indica se a conta associada a essa permissão foi excluída. Este campo refere-se apenas a permissões de usuários e grupos. |
view |
Indica a visualização dessa permissão. Preenchido apenas para permissões que pertencem a uma visualização. "publicado" é o único valor aceito. |
pendingOwner |
Se a conta associada a esta permissão é um proprietário pendente. Preenchido apenas para permissões do tipo |
Métodos |
|
---|---|
|
Cria uma permissão para um arquivo ou drive compartilhado. |
|
Exclui uma permissão. |
|
Recebe uma permissão por ID. |
|
Lista as permissões de um arquivo ou drive compartilhado. |
|
Atualiza uma permissão com semântica de patch. |