Method: permissions.list

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

Solicitação HTTP

GET https://www.googleapis.com/drive/v2/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
maxResults

integer

O número máximo de permissões a serem retornadas por página. Quando esse recurso não é definido para arquivos em um drive compartilhado, no máximo 100 resultados são retornados. Quando ela não é definida para arquivos que não estão em um drive compartilhado, a lista inteira é 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 oferece suporte ao Meu Drive e aos drives compartilhados.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.

useDomainAdminAccess

boolean

Emita a solicitação como administrador do domínio. Se ela for definida como verdadeira, o solicitante vai receber acesso se o parâmetro do ID do arquivo se referir a um drive compartilhado e se o solicitante for um administrador do domínio a que esse drive pertence.

includePermissionsForView

string

Especifica quais permissões de visualização adicionais serão incluídas 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 associadas a um arquivo.

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

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

string

O token para a próxima página de permissões. Esse campo não vai aparecer se o fim da lista de permissões for atingido. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação deverá ser reiniciada na primeira página de resultados.

kind

string

É sempre drive#permissionList.

etag

string

A ETag da lista.

items[]

object (Permission)

A lista de permissões.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/docs
  • 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 serem usados pelo app. Para mais informações, consulte o Guia de autorização.