- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Solicitar
- ReplaceAllTextRequest
- SubstringMatchCriterios
- InsertTextRequest
- Ubicación
- EndOfSegmentLocation
- UpdateTextStyleRequest
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- DeleteParagraphBulletsRequest
- CreateNamedRangeRequest
- DeleteNamedRangeRequest
- UpdateParagraphStyleRequest
- DeleteContentRangeRequest
- InsertInlineImageRequest
- InsertTableRequest.
- InsertTableRowRequest
- TableCellLocation
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- InsertPageBreakRequest
- DeletePositionedObjectRequest
- UpdateTableColumnPropertiesRequest
- UpdateTableCellStyleRequest
- TableRange
- UpdateTableRowStyleRequest
- ReplaceImageRequest
- ImageReplaceMethod;
- UpdateDocumentStyleRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- CreateHeaderRequest
- HeaderfooterType
- CreatefooterRequest
- CreateFootnoteRequest
- ReplaceNamedRangeContentRequest
- UpdateSectionStyleRequest
- InsertSectionBreakRequest
- DeleteHeaderRequest
- DeletefooterRequest
- PinTableHeaderRowsRequest
- WriteControl
- Respuesta
- ReplaceAllTextResponse
- CreateNamedRangeResponse
- InsertInlineImageResponse
- InsertInlineSheetsChartResponse
- CreateHeaderResponse
- CreatefooterResponse
- CreateFootnoteResponse
- Pruébala
Aplica una o más actualizaciones al documento.
Cada request
se valida antes de aplicarse. Si alguna solicitud no es válida, la solicitud fallará y no se aplicará nada.
Algunas solicitudes tienen replies
para brindarte información sobre cómo se aplican. Otras solicitudes no necesitan mostrar información; cada una muestra una respuesta vacía. El orden de las respuestas coincide con el de las solicitudes.
Por ejemplo, supongamos que llamas a TFRecord con cuatro actualizaciones, y solo la tercera muestra información. La respuesta tendría dos respuestas vacías, la respuesta a la tercera solicitud y otra respuesta vacía, en ese orden.
Dado que otros usuarios podrían estar editando el documento, es posible que este no refleje exactamente los cambios: es posible que se modifiquen tus cambios con respecto a los cambios de los colaboradores. Si no hay colaboradores, el documento debe reflejar los cambios. En cualquier caso, se garantiza que las actualizaciones en tu solicitud se apliquen de forma atómica.
Solicitud HTTP
POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
documentId |
El ID del documento que se actualizará. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "requests": [ { object ( |
Campos | |
---|---|
requests[] |
Es una lista de las actualizaciones que se aplicarán al documento. |
writeControl |
Proporciona control sobre cómo se ejecutan las solicitudes de escritura. |
Cuerpo de la respuesta
Mensaje de respuesta de una solicitud documents.batchUpdate
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "documentId": string, "replies": [ { object ( |
Campos | |
---|---|
documentId |
Es el ID del documento al que se aplicaron las actualizaciones. |
replies[] |
Es la respuesta de las actualizaciones. Esto se asigna de forma individual con las actualizaciones, aunque las respuestas a algunas solicitudes pueden estar vacías. |
writeControl |
El control de escritura actualizado después de aplicar la solicitud. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Para obtener más información, consulta la Guía de autorización.
Control de escritura
Proporciona control sobre cómo se ejecutan las solicitudes de escritura.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión control . Determina la revisión del documento en el que se debe escribir y cómo debe comportarse la solicitud si esa revisión no es la revisión actual del documento. Si no se especifica ninguno de los campos, las actualizaciones se aplican a la revisión más reciente. Las direcciones (control ) solo pueden ser una de las siguientes opciones: |
|
requiredRevisionId |
El Cuando se muestra un ID de revisión obligatorio en una respuesta, este indica el ID de revisión del documento después de aplicar la solicitud. |
targetRevisionId |
El destino opcional Si se realizaron cambios de colaboradores después de leer el documento con la API, los cambios que generó esta solicitud de escritura se aplican a los de colaborador. El resultado es una revisión nueva del documento que incorpora los cambios del colaborador y de la solicitud, y el servidor de Documentos resuelve los cambios en conflicto. Cuando se usa el ID de revisión de destino, el cliente de la API puede considerarse otro colaborador del documento. El ID de revisión de destino solo se puede usar para escribir en versiones recientes de un documento. Si la revisión de destino está muy retrasada con respecto a la última revisión, la solicitud no se procesa y muestra un error 400 de solicitud incorrecta. La solicitud se debe volver a intentar después de recuperar la versión más reciente del documento. Por lo general, el ID de una revisión se mantiene válido para usarse como revisión de destino durante varios minutos después de su lectura, pero en el caso de documentos editados con frecuencia, esta ventana puede ser más corta. |