REST Resource: permissions

{
  "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
}

string

Apenas saída. O ID dessa permissão. Esse é um identificador exclusivo do beneficiário e é publicado nos recursos do usuário como permissionId. Os IDs devem ser tratados como valores opacos.

string

Apenas saída. O nome "bonito" do valor da permissão. Esta é uma lista de exemplos para cada tipo de permissão:

• user: nome completo do usuário, conforme definido para a Conta do Google, como "João Silva".
• group: nome do Grupo do Google, como "Administradores da empresa".
• domain – Nome de domínio da string, como "thecompany.com".
• anyone: não há displayName.

string

O tipo do beneficiário. Os valores válidos são:

• user
• group
• domain
• anyone

Ao criar uma permissão, se type for user ou group, será necessário fornecer um emailAddress para o usuário ou grupo. Quando type for domain, será necessário fornecer um domain. Não há informações extras necessárias para um tipo anyone.

string

Apenas saída. Identifica o tipo de recurso. Valor: a string fixa "drive#permission".

object

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.

string

Apenas saída. O tipo de permissão do usuário. Novos valores podem ser adicionados no futuro, mas no momento é possível:

• file
• member

string

Apenas saída. O ID do item do qual essa permissão é herdada. Este é um campo somente para saída.

string

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:

• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

Apenas saída. Indica se essa permissão é herdada. Esse campo é sempre preenchido. Este é um campo somente para saída.

string

Apenas saída. Um link para a foto do perfil do usuário, se disponível.

string

O endereço de e-mail do usuário ou grupo a que essa permissão se refere.

string

O papel concedido pela permissão. Novos valores podem ser suportados no futuro, mas os seguintes são permitidos no momento:

• owner
• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

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 ou anyone.

string

O domínio a que essa permissão se refere.

string

O horário em que essa permissão vai expirar (data-hora RFC 3339). Os prazos de validade têm as seguintes restrições:

• Elas só podem ser definidas para permissões de usuário e grupo.
• A hora precisa estar no futuro.
• O horário não pode ser mais de um ano no futuro.

object

Apenas saída. Obsoleto: somente saída. Use permissionDetails

string

Obsoleto: somente saída. Use permissionDetails/permissionType

string

Obsoleto: somente saída. Use permissionDetails/inheritedFrom

string

Obsoleto: somente saída. Use permissionDetails/role

boolean

Obsoleto: somente saída. Use permissionDetails/inherited

boolean

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.

string

Indica a visualização dessa permissão. Preenchido apenas para permissões que pertencem a uma vista. "publicado" é o único valor compatível.

boolean

Indica se a conta associada a essa permissão é um proprietário pendente. Preenchido apenas para permissões do tipo user para arquivos que não estão em um drive compartilhado.