Method: files.accessproposals.list

Lista os AccessProposals em um arquivo. Observação: apenas os aprovadores podem listar as AccessProposals em um arquivo. Se o usuário não for um aprovador, um erro 403 será retornado.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
fileId

string

Obrigatório. O ID do item em que a solicitação está.

Parâmetros de consulta

Parâmetros
pageToken

string

Opcional. O token de continuação na lista de solicitações de acesso.
pageSize

integer

Opcional. O número de resultados por página

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A resposta a uma solicitação de lista de proposta de acesso.

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

Representação JSON 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Campos
accessProposals[]

object (AccessProposal)

A lista de propostas de acesso. Esse campo só é preenchido na v3 e v3beta.
nextPageToken

string

O token de continuação para a próxima página de resultados. Ele não vai aparecer se o fim da lista de resultados for alcançado. 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.

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.metadata
  • https://www.googleapis.com/auth/drive.metadata.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.

AccessProposal

O recurso de proposta de acesso para propostas de acesso pendentes em um arquivo

Representação JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Campos
fileId

string

O ID do arquivo em que a proposta de acesso está
proposalId

string

O ID da proposta de acesso
requesterEmailAddress

string

O endereço de e-mail do usuário solicitante
recipientEmailAddress

string

O endereço de e-mail do usuário que vai receber as permissões, se aceitas
rolesAndViews[]

object (RoleAndView)

Um wrapper para a função e a visualização de uma proposta de acesso.
requestMessage

string

Mensagem que o solicitante adicionou à proposta
createTime

string (Timestamp format)

A hora da criação

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

RoleAndView

Um wrapper para a função e a visualização de uma proposta de acesso.

Representação JSON 
{
  "role": string,
  "view": string
}
Campos
role

string

O papel proposto pelo solicitante. Novos valores poderão ser adicionados no futuro, mas os seguintes são possíveis no momento: * writer * commenter * reader
view

string

Indica a visualização dessa proposta de acesso. Preenchido apenas para propostas que pertencem a uma visualização. published é o único valor compatível.