Recurso: permissão
Permissão para um arquivo. A permissão concede a um usuário, grupo, domínio ou ao mundo o acesso a um arquivo ou a 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 "bonito" do valor da permissão. Esta é 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. Detalhes sobre se as permissões neste item do drive compartilhado são herdadas ou diretamente neste item. Este é um campo somente para saída que aparece apenas para os itens dos drives compartilhados. |
permissionDetails[].permissionType |
Apenas saída. O tipo de permissão do usuário. Novos valores podem ser adicionados no futuro, mas no momento é possível:
|
permissionDetails[].inheritedFrom |
Apenas saída. O ID do item do qual essa permissão é herdada. Este é um campo somente para saída. |
permissionDetails[].role |
Apenas saída. A função principal do usuário. Novos valores podem ser adicionados no futuro, mas no momento é possível fazer o seguinte:
|
permissionDetails[].inherited |
Apenas saída. Indica se essa permissão é herdada. Esse campo é sempre preenchido. Este é um campo somente para 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 a que essa permissão se refere. |
role |
O papel concedido pela permissão. Novos valores podem ser suportados no futuro, mas os seguintes são permitidos no momento:
|
allowFileDiscovery |
Define se a permissão permite que o arquivo seja descoberto por meio de pesquisa. Isso só é aplicável a permissões do tipo |
domain |
O domínio a que essa permissão se refere. |
expirationTime |
O horário em que essa permissão vai expirar (data-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. Se a conta associada a essa permissão foi excluída. Esse campo só diz respeito 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 vista. "publicado" é o único valor compatível. |
pendingOwner |
Indica se a conta associada a essa 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. |