Administra las propuestas de acceso pendientes

Una propuesta de acceso es una propuesta de un solicitante a un aprobador para otorgar a un destinatario acceso a un elemento de Google Drive.

Un aprobador puede revisar todas las propuestas de acceso sin resolver en los archivos de Drive y tomar medidas al respecto. Esto significa que puedes acelerar el proceso de aprobación consultando de forma programática las propuestas de acceso y, luego, resolviéndolas. También permite que un aprobador vea las propuestas de forma agregada.

La API de Google Drive proporciona el accessproposals recurso para que puedas ver y resolver las propuestas de acceso pendientes. Los métodos del recurso accessproposals funcionan en archivos, carpetas y los archivos dentro de una unidad compartida, pero no en la unidad compartida.

Los siguientes términos son específicos de las propuestas de acceso:

  • Solicitante: Es el usuario que inicia la propuesta de acceso a un elemento de Drive.
  • Destinatario: Es el usuario que recibe los permisos adicionales en un archivo si se otorga la propuesta de acceso. Muchas veces, el destinatario es el mismo que el solicitante, pero no siempre.
  • Aprobador: Es el usuario responsable de aprobar (o rechazar) la propuesta de acceso. Por lo general, esto se debe a que es propietario del documento o tiene la capacidad de compartirlo.

Usa el parámetro fields

Si deseas especificar los campos que se mostrarán en la respuesta, puedes configurar el fields parámetro del sistema con cualquier método del recurso accessproposals. Si omites el parámetro fields, el servidor muestra un conjunto predeterminado de campos específicos del método. Para mostrar diferentes campos, consulta Cómo mostrar campos específicos.

Obtén una propuesta de acceso pendiente

Para obtener una propuesta de acceso, usa el get método en el accessproposals recurso con los fileId y proposalId parámetros de ruta de acceso. Si no conoces el ID de la propuesta, puedes enumerar las propuestas de acceso pendientes con el método list.

Enumera las propuestas de acceso pendientes

Para enumerar todas las propuestas de acceso pendientes en un elemento de Drive, llama al list método en el accessproposals recurso e incluye el fileId parámetro de ruta de acceso.

Solo los aprobadores de un archivo pueden enumerar las propuestas pendientes en un archivo. Un aprobador es un usuario con la capacidad can_approve_access_proposals en el archivo. Si el solicitante no es un aprobador, se muestra una lista vacía. Para obtener más información sobre capabilities, consulta Comprende las capacidades de los archivos.

El cuerpo de la respuesta consta de un objeto accessproposals que representa una lista de propuestas de acceso sin resolver en el archivo.

El objeto accessproposals incluye información sobre cada propuesta, como el solicitante, el destinatario y el mensaje que agregó el solicitante. También incluye un RoleAndView objeto que agrupa el role propuesto del solicitante con una view. Dado que role es un campo repetido, pueden existir varios para cada propuesta. Por ejemplo, una propuesta podría tener un objeto RoleAndView de role=reader y view=published, además de un objeto RoleAndView adicional con solo el valor role=writer. Para obtener más información, consulta Vistas.

Pasa los siguientes parámetros de consulta para personalizar la paginación de las propuestas de acceso o filtrarlas:

  • pageToken: Es un token de página que se recibe de una llamada de lista anterior. Proporciona este token para recuperar la página siguiente.

  • pageSize: Es la cantidad máxima de propuestas de acceso que se mostrarán por página.

Resuelve las propuestas de acceso pendientes

Para resolver todas las propuestas de acceso pendientes en un elemento de Drive, llama al resolve método en el recurso accessproposals e incluye los parámetros de ruta de acceso fileId y proposalId.

El método resolve incluye un parámetro de consulta action que indica la acción que se debe realizar en la propuesta. El Action objeto hace un seguimiento del cambio de estado de la propuesta para que sepamos si se acepta o se rechaza.

El método resolve también incluye los parámetros de consulta opcionales de role y view. Los únicos roles admitidos son writer, commenter y reader. Si no se especifica el rol, se establece de forma predeterminada en reader. Para obtener más información, consulta Roles y permisos. Un parámetro de consulta opcional adicional de sendNotification te permite enviar una notificación por correo electrónico al solicitante cuando se acepta o se rechaza la propuesta.

Al igual que con el método list, los usuarios que resuelven la propuesta deben tener la capacidad can_approve_access_proposals en el archivo. Para obtener más información sobre capabilities, consulta Comprende las capacidades de los archivos.

Las propuestas se resuelven con los mismos patrones que se indican en Situaciones para compartir recursos de Drive. Si hay varias propuestas para el mismo usuario, pero con diferentes roles, se aplica lo siguiente:

  • Si se acepta una propuesta y se rechaza otra, el rol aceptado se aplica al elemento de Drive.
  • Si ambas propuestas se aceptan al mismo tiempo, se aplica la propuesta con el permiso más alto (por ejemplo, role=writer en comparación con role=reader). La otra propuesta de acceso se quita del elemento.

Después de enviar una propuesta al método resolve, se completa la acción de uso compartido. La propuesta de acceso resuelta ya no se muestra a través del método list. Una vez que se acepta la propuesta, el usuario debe usar el permissions recurso para actualizar los permisos en un archivo o carpeta. Para obtener más información, consulta Actualiza los permisos.