Method: permissions.list

Lista as permissões de um arquivo ou drive compartilhado. Para mais informações, consulte Compartilhar arquivos, pastas e drives.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo ou drive compartilhado.

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de permissões a serem retornadas. O serviço pode retornar um valor inferior a este.

Se não for especificado, no máximo 100 permissões serão retornadas para drives compartilhados e toda a lista de permissões para drives não compartilhados.

O valor máximo é 100. Valores acima de 100 serão forçados a 100.
pageToken

string

O token para continuar uma solicitação de lista anterior na próxima página. Ele precisa ser definido como o valor de nextPageToken da resposta anterior.
supportsAllDrives

boolean

Indica se o aplicativo solicitante oferece suporte ao Meu Drive e aos drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Descontinuado: use supportsAllDrives.
useDomainAdminAccess

boolean

Emite a solicitação como administrador do domínio.

Se definido como true e se as seguintes condições adicionais forem atendidas, o solicitante receberá acesso:

  1. O parâmetro de ID do arquivo se refere a um drive compartilhado.
  2. O solicitante é um administrador do domínio a que o drive compartilhado pertence.

Para mais informações, consulte Gerenciar drives compartilhados como administradores de domínio.
includePermissionsForView

string

Especifica quais permissões de visualização adicionais incluir na resposta. Somente published é aceito.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de permissões para um arquivo.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Campos
permissions[]

object (Permission)

A lista de permissões. Se nextPageToken estiver preenchido, essa lista poderá estar incompleta e uma página adicional de resultados precisará ser buscada.
nextPageToken

string

O token de página para a próxima página de permissões. Esse campo estará ausente se o final da lista de permissões tiver sido atingido. Se o token for rejeitado por qualquer motivo, ele precisará ser descartado, e a paginação precisará ser reiniciada na primeira página de resultados. O token de página normalmente é válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes.
kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#permissionList".

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app os use. Para mais informações, consulte o guia de autorização.