Method: permissions.list

Lista as permissões de um arquivo ou drive compartilhado.

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 do drive compartilhado.

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de permissões retornadas por página. Quando não for definido para arquivos em um drive compartilhado, no máximo 100 resultados serão retornados. Quando não for definido para arquivos que não estão em um drive compartilhado, a lista inteira será retornada.
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 é compatível com o Meu Drive e com os drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Descontinuado: use supportsAllDrives.
useDomainAdminAccess

boolean

Emitir a solicitação como administrador de domínio. Se definido como "true", o solicitante vai receber acesso se o parâmetro de ID do arquivo se referir a um drive compartilhado e o solicitante for um administrador do domínio a que o drive compartilhado pertence.
includePermissionsForView

string

Especifica quais permissões de visualizações adicionais incluir na resposta. Somente "publicado" é 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 
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Campos
nextPageToken

string

O token de página para a próxima página de permissões. Esse campo não vai aparecer se o final da lista de permissões tiver sido alcançado. Se o token for rejeitado por qualquer motivo, ele será descartado e a paginação será reiniciada na primeira página de resultados. O token da página geralmente é 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".
permissions[]

object (Permission)

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

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 possa usá-los. Para mais informações, consulte o guia de autorização.