En este documento, se explica cómo administrar las aprobaciones en la API de Google Drive.
Puedes encontrar las aprobaciones de tu contenido en Google Drive. La API de Google Drive proporciona el recurso approvals para que puedas obtener y enumerar el estado de tus aprobaciones. Los métodos del recurso approvals funcionan en elementos de Drive, Documentos de Google y otros editores de Google Workspace.
Puedes usar este proceso para ubicar aprobaciones en situaciones de revisión formal, como la revisión de un contrato o un documento oficial antes de su publicación. Una aprobación hace un seguimiento del estado de la revisión (como En curso, Aprobada o Rechazada) y de los revisores involucrados. Las aprobaciones son una excelente manera de validar el contenido y mantener un registro de los revisores.
Para ver las aprobaciones de un archivo, debes tener permiso para leer sus metadatos. Para obtener más información, consulta Roles y permisos.
Usa el parámetro fields
Si deseas especificar los campos que se devolverán en la respuesta, puedes establecer el parámetro del sistema fields con cualquier método del recurso approvals. Si omites el parámetro fields, el servidor devolverá un conjunto predeterminado de campos específicos para el método. Para devolver diferentes campos, consulta Cómo devolver campos específicos.
Cómo obtener una aprobación
Para obtener una aprobación en un archivo, usa el método get en el recurso approvals con los parámetros de ruta de acceso fileId y approvalId. Si no conoces el ID de aprobación, puedes listar las aprobaciones con el método list.
El cuerpo de la respuesta contiene una instancia del recurso approvals.
Enumera las aprobaciones
Para enumerar las aprobaciones de un archivo, llama al método list en el recurso approvals y, luego, incluye el parámetro de ruta de acceso fileId.
El cuerpo de la respuesta consta de una lista de aprobaciones en el archivo. El campo items incluye información sobre cada aprobación en forma de un recurso approvals.
El recurso approvals también incluye un objeto Status que detalla el estado de la aprobación, así como el objeto ReviewerResponse que detalla la respuesta a una aprobación realizada por un revisor específico. La respuesta de este revisor se representa con el objeto Response.
También puedes pasar los siguientes parámetros de consulta para personalizar la paginación o filtrar las aprobaciones:
pageSize: Es la cantidad máxima de aprobaciones que se mostrarán por página. Si no configuraspageSize, el servidor devuelve hasta 100 aprobaciones.pageToken: Es un token de página que se recibió de una llamada a lista anterior. Este token se usa para recuperar la página siguiente. Se debe establecer en el valor denextPageTokende una respuesta anterior.