En esta guía, se presentan los métodos de solicitud y respuesta principales que conforman la API de Documentos de Google y cómo puedes actualizar un documento por lotes.
Puedes invocar la API de Documentos de Google con una solicitud HTTP o con una invocación de método en una biblioteca cliente específica de un lenguaje. Estos son ampliamente equivalentes.
La API de Documentos de Google muestra una respuesta HTTP, que generalmente incluye el resultado de la invocación de la solicitud. Cuando se usa una biblioteca cliente para realizar solicitudes, las respuestas se muestran de una manera específica para cada idioma.
Métodos de la solicitud
La API de Documentos admite los siguientes métodos:
documents.create
: Crea un documento en blanco de Documentos de Google.documents.get
: Muestra una instancia completa del documento especificado. Puedes analizar el JSON que se muestra para extraer el contenido del documento, el formato y otras funciones.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 la que puedes leer el documentId
. Para obtener más información sobre documentId
, consulta ID de 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 debe 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, toda la actualización falla y no se aplica 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 respuestas 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 para obtener todos los detalles sobre cómo realizar solicitudes por lotes a la API de Documentos y la documentación de referencia de documents.batchUpdate
para los tipos de solicitudes y respuestas.
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 solicitudes, agrupados en distintas categorías.
Temas relacionados
- Estructura de un documento de Documentos de Google
- Reglas y comportamiento de edición estructural
- Solicitudes en lotes