Method: files.accessproposals.list

Enumera los AccessProposals en un archivo. Nota: Solo los revisores pueden enumerar AccessProposals en un archivo. Si el usuario no es un aprobador, se muestra un 403.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
fileId

string

Obligatorio. Es el ID del elemento en el que se encuentra la solicitud.

Parámetros de consulta

Parámetros
pageToken

string

Opcional. El token de Continuation de la lista de solicitudes de acceso.
pageSize

integer

Opcional. La cantidad de resultados por página

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta a una solicitud de lista de propuestas de acceso.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Campos
accessProposals[]

object (AccessProposal)

La lista de propuestas de acceso Este campo solo se propaga en las versiones 3 y 3beta.
nextPageToken

string

El token de continuación para la página siguiente de resultados. Este campo no se mostrará si se llega al final de la lista de resultados. Si el token se rechaza por algún motivo, se debe descartar y se debe reiniciar la paginación desde la primera página de resultados.

Alcances de autorización

Se necesita uno de los siguientes permisos de 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

Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la Guía de autorización.

AccessProposal

El recurso de propuesta de acceso para las propuestas de acceso pendientes en un archivo

Representación JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Campos
fileId

string

El ID del archivo en el que se encuentra la propuesta de acceso
proposalId

string

El ID de la propuesta de acceso
requesterEmailAddress

string

La dirección de correo electrónico del usuario solicitante
recipientEmailAddress

string

La dirección de correo electrónico del usuario que recibirá los permisos si se aceptan
rolesAndViews[]

object (RoleAndView)

Un wrapper para el rol y la vista de una propuesta de acceso.
requestMessage

string

El mensaje que el solicitante agregó a la propuesta
createTime

string (Timestamp format)

La hora de creación

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

RoleAndView

Es un wrapper para el rol y la vista de una propuesta de acceso.

Representación JSON 
{
  "role": string,
  "view": string
}
Campos
role

string

El rol que propuso el solicitante. Es posible que se agreguen valores nuevos en el futuro, pero actualmente se pueden usar los siguientes: * writer * commenter * reader
view

string

Indica la vista de esta propuesta de acceso. Solo se completa para las propuestas que pertenecen a una vista. published es el único valor admitido.