En esta guía, se presentan los métodos principales de solicitud y respuesta que conforman la API de Documentos de Google y cómo puedes actualizar un documento en lotes.
Puedes invocar a la API de Documentos de Google con una solicitud HTTP o con una invocación de método en una biblioteca cliente específica del lenguaje. Son equivalentes en términos generales.
La API de Documentos de Google muestra una respuesta HTTP, que, por lo general, incluye el resultado de la invocación de la solicitud. Cuando usas una biblioteca cliente para realizar solicitudes, las respuestas se muestran en un lenguaje específico.
Métodos de la solicitud
La API de Documentos admite los siguientes métodos:
documents.create: Crea un documento de Documentos de Google en blanco.documents.get: Muestra una instancia completa del documento especificado. Puedes analizar el JSON que se muestra para extraer el contenido, el formato y otras características del documento.documents.batchUpdate: Envía una lista de solicitudes de edición para aplicarlas de forma atómica al documento y muestra una lista de resultados.
Los métodos documents.get y documents.batchUpdate requieren un documentId
como parámetro para especificar el documento de destino. El método documents.create
muestra una instancia del documento creado, desde el que puedes leer
documentId. Para obtener más información sobre documentId, consulta ID del documento.
Actualizaciones por lotes
El método documents.batchUpdate toma una lista de objetos request, cada uno de los cuales especifica una sola solicitud que se realizará. Por ejemplo, da formato a un párrafo y,
luego, agrega una imagen intercalada. Cada solicitud se valida antes de aplicarse y las solicitudes se procesan según el orden en que aparecen en la solicitud por lotes.
Todas las solicitudes de la actualización por lotes se aplican de forma atómica. Es decir, si alguna solicitud no es válida, no se realizará correctamente la actualización y no se aplicará ninguno de los cambios (potencialmente dependientes).
Algunos métodos documents.batchUpdate proporcionan respuestas con información sobre las solicitudes aplicadas. Estos métodos muestran un cuerpo de respuesta que contiene una lista de objetos response. Otras solicitudes no necesitan mostrar información ni mostrar una respuesta vacía. Los objetos de la lista de respuesta ocupan el mismo orden de índice que la solicitud correspondiente.
Un patrón popular para realizar solicitudes por lotes se ve de la siguiente manera:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
Consulta las prácticas recomendadas para las solicitudes por lotes si deseas obtener detalles completos sobre cómo agrupar tus llamadas a la API de Documentos por lotes y la documentación de referencia de documents.batchUpdate para los tipos de solicitud y respuesta.
Operaciones de actualización por lotes
Existen varios tipos de solicitudes de actualización por lotes. A continuación, se muestra un desglose de los tipos de solicitud, agrupados en diferentes categorías.
Temas relacionados
- Estructura de un archivo de Documentos de Google
- Comportamiento y reglas de edición de estructuras
- Solicitudes en lotes