Solicitud
Una sola actualización que se aplica a un documento.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión request . La solicitud específica que se aplicará. Se requiere exactamente un campo.
request solo puede ser uno de los siguientes:
|
|
replace
|
Reemplaza todas las instancias del texto especificado. |
insert
|
Inserta texto en la ubicación especificada. |
update
|
Actualiza el estilo de texto en el rango especificado. |
create
|
Crea viñetas para los párrafos. |
delete
|
Borra las viñetas de los párrafos. |
create
|
Crea un rango con nombre. |
delete
|
Borra un rango con nombre. |
update
|
Actualiza el estilo de párrafo en el rango especificado. |
delete
|
Borra contenido del documento. |
insert
|
Inserta una imagen intercalada en la ubicación especificada. |
insert
|
Inserta una tabla en la ubicación especificada. |
insert
|
Inserta una fila vacía en una tabla. |
insert
|
Inserta una columna vacía en una tabla. |
delete
|
Borra una fila de una tabla. |
delete
|
Borra una columna de una tabla. |
insert
|
Inserta un salto de página en la ubicación especificada. |
delete
|
Borra un objeto posicionado del documento. |
update
|
Actualiza las propiedades de las columnas de una tabla. |
update
|
Actualiza el estilo de las celdas de la tabla. |
update
|
Actualiza el estilo de fila en una tabla. |
replace
|
Reemplaza una imagen en el documento. |
update
|
Actualiza el estilo del documento. |
merge
|
Combina celdas en una tabla. |
unmerge
|
Descombina celdas en una tabla. |
create
|
Crea un encabezado. |
create
|
Crea un pie de página. |
create
|
Crea una nota al pie. |
replace
|
Reemplaza el contenido en un rango con nombre. |
update
|
Actualiza el estilo de la sección del rango especificado. |
insert
|
Inserta un corte de sección en la ubicación especificada. |
delete
|
Borra un encabezado del documento. |
delete
|
Borra un pie de página del documento. |
pin
|
Actualiza la cantidad de filas de encabezado fijadas en una tabla. |
ReplaceAllTextRequest
Reemplaza todas las instancias de texto que coincidan con un criterio por replace text
.
Representación JSON |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
Campos | |
---|---|
replace
|
Es el texto que reemplazará el texto coincidente. |
tabs
|
Opcional. Son los criterios que se usan para especificar en qué pestañas se produce el reemplazo. Si se omite, el reemplazo se aplica a todas las pestañas. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
Campo de unión criteria . Son los criterios que se usan para hacer coincidir el texto que se reemplazará.
criteria solo puede ser uno de los siguientes:
|
|
contains
|
Busca texto en el documento que coincida con esta subcadena. |
SubstringMatchCriteria
Es un criterio que coincide con una cadena de texto específica en el documento.
Representación JSON |
---|
{ "text": string, "matchCase": boolean } |
Campos | |
---|---|
text
|
Es el texto que se busca en el documento. |
match
|
Indica si la búsqueda debe respetar mayúsculas y minúsculas:
|
TabsCriteria
Es un criterio que especifica en qué pestañas se ejecuta una solicitud.
Representación JSON |
---|
{ "tabIds": [ string ] } |
Campos | |
---|---|
tab
|
La lista de IDs de pestañas en los que se ejecuta la solicitud. |
InsertTextRequest
Inserta texto en la ubicación especificada.
Representación JSON |
---|
{ "text": string, // Union field |
Campos | |
---|---|
text
|
Es el texto que se insertará.
Si insertas un carácter de nueva línea, se creará de forma implícita un Los estilos de texto para el texto insertado se determinarán automáticamente y, por lo general, se conservarán los estilos del texto adyacente. En la mayoría de los casos, el estilo de texto del texto insertado coincidirá con el texto inmediatamente anterior al índice de inserción. Se quitarán del texto insertado algunos caracteres de control (U+0000-U+0008, U+000C-U+001F) y caracteres del área de uso privado del plano multilingüe básico de Unicode (U+E000-U+F8FF). |
Campo de unión insertion_location . La ubicación en la que se insertará el texto.
insertion_location puede ser solo una de las siguientes opciones:
|
|
location
|
Inserta el texto en un índice específico del documento.
El texto debe insertarse dentro de los límites de un |
end
|
Inserta el texto al final de un encabezado, un pie de página, una nota al pie o el cuerpo del documento. |
Ubicación
Una ubicación en particular del documento.
Representación JSON |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
Campos | |
---|---|
segment
|
Es el ID del encabezado, el pie de página o la nota al pie en el que se encuentra la ubicación. Un ID de segmento vacío indica el cuerpo del documento. |
index
|
Es el índice basado en cero, en unidades de código UTF-16.
El índice es relativo al inicio del segmento especificado por |
tab
|
La pestaña en la que se encuentra la ubicación Cuando se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
EndOfSegmentLocation
Ubicación al final de un cuerpo, encabezado, pie de página o nota al pie. La ubicación está inmediatamente antes de la última línea nueva en el segmento del documento.
Representación JSON |
---|
{ "segmentId": string, "tabId": string } |
Campos | |
---|---|
segment
|
Es el ID del encabezado, el pie de página o la nota al pie en el que se encuentra la ubicación. Un ID de segmento vacío indica el cuerpo del documento. |
tab
|
La pestaña en la que se encuentra la ubicación Si se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
UpdateTextStyleRequest
Actualiza el estilo del texto.
Representación JSON |
---|
{ "textStyle": { object ( |
Campos | |
---|---|
text
|
Son los estilos que se establecerán en el texto. Si el valor de un estilo en particular coincide con el del elemento superior, ese estilo se establecerá para heredar.
Algunos cambios en el estilo de texto pueden provocar otras modificaciones para imitar el comportamiento del editor de Documentos. Consulta la documentación de |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. La raíz
Por ejemplo, para actualizar el estilo de texto a negrita, establece Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo. |
Campo de unión insertion_location . Es el tipo de rango que se usa en el que se actualizará el estilo de texto.
insertion_location solo puede ser uno de los siguientes:
|
|
range
|
Es el rango de texto al que se le aplicará estilo. El rango se puede extender para incluir líneas nuevas adyacentes. Si el rango contiene por completo un párrafo que pertenece a una lista, la viñeta del párrafo también se actualiza con el estilo de texto coincidente. No se pueden insertar rangos dentro de un UpdateTextStyleRequest relativo. |
CreateParagraphBulletsRequest
Crea viñetas para todos los párrafos que se superponen con el rango determinado.
El nivel de anidación de cada párrafo se determinará contando las tabulaciones iniciales que se encuentran al principio de cada párrafo. Para evitar el exceso de espacio entre la viñeta y el párrafo correspondiente, esta solicitud quita estas tabulaciones iniciales. Esto puede cambiar los índices de partes del texto.
Si el párrafo que se encuentra justo antes de que se actualicen está en una lista con un ajuste predeterminado correspondiente, los párrafos que se actualizan se agregan a la lista anterior.
Representación JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range
|
Es el rango al que se aplicará el ajuste predeterminado de viñetas. |
bullet
|
Los tipos de glifos de viñeta que se usarán. |
BulletGlyphPreset
Patrones preestablecidos de glifos de viñetas para listas.
Estos patrones usan estos tipos de viñetas:
-
ARROW
: Una flecha que corresponde a un punto de código Unicode U+2794 -
ARROW3D
: Una flecha con sombreado en 3D, que corresponde a un punto de código Unicode U+27a2 -
CHECKBOX
: Un cuadrado vacío que corresponde a un punto de código Unicode U+274f -
CIRCLE
: Un círculo hueco, que corresponde a un punto de código Unicode U+25cb -
DIAMOND
: Un diamante sólido que corresponde a un punto de código Unicode U+25c6 -
DIAMONDX
: Un diamante con una "x", que corresponde a un punto de código Unicode U+2756 -
HOLLOWDIAMOND
: un diamante vacío, que corresponde a un punto de código Unicode U+25c7. -
DISC
: Un círculo sólido que corresponde a un punto de código Unicode U+25cf -
SQUARE
: Un cuadrado sólido, que corresponde a un punto de código Unicode U+25a0 -
STAR
: Es una estrella que corresponde a un punto de código Unicode U+2605. -
ALPHA
: Una letra minúscula, como "a", "b" o "c". -
UPPERALPHA
: Una letra mayúscula, como "A", "B" o "C". -
DECIMAL
: Es un número, como “1”, “2” o “3”. -
ZERODECIMAL
: Es un número en el que los números de un solo dígito tienen un prefijo de cero, como “01”, “02” o “03”. Los números con más de un dígito no tienen un cero como prefijo. -
ROMAN
: Un número romano en minúsculas, como "i", "ii" o "iii". -
UPPERROMAN
: Un número romano en mayúsculas, como “I”, “II” o “III”. -
LEFTTRIANGLE
: Un triángulo que apunta a la izquierda, que corresponde a un punto de código Unicode U+25c4
Enumeraciones | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
No se especificó el valor predeterminado del glifo de viñeta. |
BULLET_DISC_CIRCLE_SQUARE
|
Una lista con viñetas con un glifo de viñeta DISC , CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Una lista con viñetas con un glifo de viñeta DIAMONDX , ARROW3D y SQUARE para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_CHECKBOX
|
Una lista con viñetas con glifos de viñeta CHECKBOX para todos los niveles de anidación de listas.
|
BULLET_ARROW_DIAMOND_DISC
|
Una lista con viñetas con un glifo de viñeta ARROW , DIAMOND y DISC para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_STAR_CIRCLE_SQUARE
|
Una lista con viñetas con un glifo de viñeta STAR , CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Una lista con viñetas con un glifo de viñetas ARROW3D , CIRCLE y SQUARE para los primeros 3 niveles de anidación de listas
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Una lista con viñetas con un glifo de viñeta LEFTTRIANGLE , DIAMOND y DISC para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Una lista con viñetas con un glifo de viñeta DIAMONDX , HOLLOWDIAMOND y SQUARE para los primeros 3 niveles de anidamiento de la lista.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Una lista con viñetas con un glifo de viñetas DIAMOND , CIRCLE y SQUARE para los primeros 3 niveles de anidación de listas
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
Una lista numerada con glifos numéricos DECIMAL , ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Una lista numerada con glifos numéricos DECIMAL , ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de paréntesis.
|
NUMBERED_DECIMAL_NESTED
|
Una lista numerada con glifos numéricos DECIMAL separados por puntos, en la que cada nivel de anidación usa el glifo del nivel de anidación anterior como prefijo. Por ejemplo: "1.", '1.1.', '2.', '2.2.'
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Una lista numerada con glifos numéricos UPPERALPHA , ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Una lista numerada con glifos numéricos UPPERROMAN , UPPERALPHA y DECIMAL para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Una lista numerada con glifos numéricos ZERODECIMAL , ALPHA y ROMAN para los primeros 3 niveles de anidamiento de listas, seguidos de puntos.
|
DeleteParagraphBulletsRequest
Borra las viñetas de todos los párrafos que se superponen con el rango determinado.
El nivel de anidación de cada párrafo se conservará visualmente si se agrega sangría al principio del párrafo correspondiente.
Representación JSON |
---|
{
"range": {
object ( |
Campos | |
---|---|
range
|
Es el rango del que se borrarán las viñetas. |
CreateNamedRangeRequest
Crea un NamedRange
que hace referencia al rango determinado.
Representación JSON |
---|
{
"name": string,
"range": {
object ( |
Campos | |
---|---|
name
|
Es el nombre del NamedRange. No es necesario que los nombres sean únicos. Los nombres deben tener al menos 1 carácter y no más de 256 caracteres, medidos en unidades de código UTF-16. |
range
|
El rango al que se le aplicará el nombre. |
DeleteNamedRangeRequest
Borra un NamedRange
.
Representación JSON |
---|
{ "tabsCriteria": { object ( |
Campos | |
---|---|
tabs
|
Opcional. Los criterios que se usan para especificar en qué pestañas debe ocurrir la eliminación del rango. Si se omite, la eliminación del rango se aplica a todas las pestañas. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
Campo de unión named_range_reference . Es el valor que determina qué rangos se borrarán. Se debe establecer exactamente uno.
named_range_reference solo puede ser uno de los siguientes:
|
|
named
|
El ID del rango con nombre que se borrará. |
name
|
Es el nombre de los rangos que se borrarán. Se borrarán todos los rangos con nombre que tengan el nombre especificado. |
UpdateParagraphStyleRequest
Actualiza el diseño de todos los párrafos que se superponen con el rango determinado.
Representación JSON |
---|
{ "paragraphStyle": { object ( |
Campos | |
---|---|
paragraph
|
Los estilos que se establecerán en los párrafos.
Es posible que ciertos cambios en el estilo de párrafo provoquen otros cambios para reflejar el comportamiento del editor de Documentos. Consulta la documentación de |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. La raíz
Por ejemplo, para actualizar la propiedad de alineación del estilo de párrafo, establece Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero deja el campo sin definir. |
Campo de unión insertion_location . Es el tipo de rango que se usa en el que se actualizará el estilo de párrafo.
insertion_location puede ser solo una de las siguientes opciones:
|
|
range
|
El rango que se superpone con los párrafos a los que se les aplicará el diseño. |
DeleteContentRangeRequest
Borra el contenido del documento.
Representación JSON |
---|
{
"range": {
object ( |
Campos | |
---|---|
range
|
El rango de contenido que se borrará. Si borras texto que cruza el límite de un párrafo, es posible que se produzcan cambios en los estilos de párrafo, las listas, los objetos posicionados y los marcadores a medida que se fusionan los dos párrafos. Si intentas borrar ciertos rangos, es posible que se genere una estructura de documento no válida, en cuyo caso se muestra un error de solicitud incorrecta 400. Estos son algunos ejemplos de solicitudes de eliminación no válidas:
|
InsertInlineImageRequest
Inserta un InlineObject
que contiene una imagen en la ubicación especificada.
Representación JSON |
---|
{ "uri": string, "objectSize": { object ( |
Campos | |
---|---|
uri
|
El URI de la imagen. La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla dentro del documento. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
El URI proporcionado debe ser de acceso público y tener una longitud máxima de 2 KB. El URI se guarda con la imagen y se expone a través del campo |
object
|
Es el tamaño en el que debe aparecer la imagen en el documento. Esta propiedad es opcional y el tamaño final de la imagen en el documento se determina con las siguientes reglas: * Si no se especifica el ancho ni la altura, se calcula un tamaño predeterminado de la imagen en función de su resolución. * Si se especifica una dimensión, la otra se calcula para conservar la relación de aspecto de la imagen. * Si se especifican el ancho y la altura, la imagen se ajusta para que se ajuste a las dimensiones proporcionadas y, al mismo tiempo, se mantiene su relación de aspecto. |
Campo de unión insertion_location . La ubicación en la que se insertará la imagen.
insertion_location puede ser solo una de las siguientes opciones:
|
|
location
|
Inserta la imagen en un índice específico del documento.
La imagen se debe insertar dentro de los límites de un Las imágenes intercaladas no se pueden insertar dentro de una nota al pie o una ecuación. |
end
|
Inserta el texto al final de un encabezado, un pie de página o el cuerpo del documento. No se pueden insertar imágenes intercaladas dentro de una nota al pie. |
InsertTableRequest
Inserta una tabla en la ubicación especificada.
Se insertará un carácter de salto de línea antes de la tabla insertada.
Representación JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
Campos | |
---|---|
rows
|
Es la cantidad de filas en la tabla. |
columns
|
La cantidad de columnas de la tabla. |
Campo de unión insertion_location . La ubicación en la que se insertará la tabla.
insertion_location puede ser solo una de las siguientes opciones:
|
|
location
|
Inserta la tabla en un índice de modelo específico. Se insertará un carácter de nueva línea antes de la tabla insertada, por lo que el índice de inicio de la tabla estará en el índice de ubicación especificado + 1.
La tabla debe insertarse dentro de los límites de un No se pueden insertar tablas en una nota al pie ni en una ecuación. |
end
|
Inserta la tabla al final del encabezado, el pie de página o el cuerpo del documento especificados. Se insertará un carácter de salto de línea antes de la tabla insertada. No se pueden insertar tablas en una nota al pie. |
InsertTableRowRequest
Inserta una fila vacía en una tabla.
Representación JSON |
---|
{
"tableCellLocation": {
object ( |
Campos | |
---|---|
table
|
Es la ubicación de la celda de la tabla de referencia desde la que se insertarán las filas. Se insertará una fila nueva arriba (o debajo) de la fila en la que se encuentra la celda de referencia. Si la celda de referencia es una celda combinada, se insertará una fila nueva arriba (o debajo) de la celda combinada. |
insert
|
Indica si se debe insertar una fila nueva debajo de la ubicación de la celda de referencia.
|
TableCellLocation
Es la ubicación de una sola celda dentro de una tabla.
Representación JSON |
---|
{
"tableStartLocation": {
object ( |
Campos | |
---|---|
table
|
Es la ubicación en la que comienza la tabla en el documento. |
row
|
Es el índice de filas basado en cero. Por ejemplo, la segunda fila de la tabla tiene un índice de fila de 1. |
column
|
El índice de columna basado en cero. Por ejemplo, la segunda columna de la tabla tiene un índice de columna de 1. |
InsertTableColumnRequest
Inserta una columna vacía en una tabla.
Representación JSON |
---|
{
"tableCellLocation": {
object ( |
Campos | |
---|---|
table
|
La ubicación de la celda de la tabla de referencia desde la que se insertarán las columnas. Se insertará una columna nueva a la izquierda (o derecha) de la columna en la que se encuentra la celda de referencia. Si la celda de referencia es una celda combinada, se insertará una columna nueva a la izquierda (o derecha) de la celda combinada. |
insert
|
Indica si se debe insertar una columna nueva a la derecha de la ubicación de la celda de referencia.
|
DeleteTableRowRequest
Borra una fila de una tabla.
Representación JSON |
---|
{
"tableCellLocation": {
object ( |
Campos | |
---|---|
table
|
Es la ubicación de la celda de la tabla de referencia desde la que se borrará la fila. Se borrará la fila que abarca esta celda. Si se trata de una celda combinada que abarca varias filas, se borrarán todas las filas que abarca la celda. Si no queda ninguna fila en la tabla después de esta eliminación, se borrará toda la tabla. |
DeleteTableColumnRequest
Borra una columna de una tabla.
Representación JSON |
---|
{
"tableCellLocation": {
object ( |
Campos | |
---|---|
table
|
La ubicación de la celda de la tabla de referencia de la que se borrará la columna. Se borrará la columna que abarca esta celda. Si se trata de una celda combinada que abarca varias columnas, se borrarán todas las columnas que abarca. Si no queda ninguna columna en la tabla después de esta eliminación, se borrará toda la tabla. |
InsertPageBreakRequest
Inserta un salto de página seguido de una línea nueva en la ubicación especificada.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión insertion_location . Es la ubicación en la que se insertará el salto de página.
insertion_location solo puede ser uno de los siguientes:
|
|
location
|
Inserta el salto de página en un índice específico del documento.
El salto de página se debe insertar dentro de los límites de un
No se pueden insertar saltos de página dentro de una tabla, ecuación, nota al pie, encabezado o pie de página. Dado que los saltos de página solo se pueden insertar dentro del cuerpo, el campo |
end
|
Inserta el salto de página al final del cuerpo del documento.
No se pueden insertar saltos de página dentro de una nota al pie, un encabezado o un pie de página. Dado que los saltos de página solo se pueden insertar dentro del cuerpo, el campo |
DeletePositionedObjectRequest
Borra un elemento PositionedObject
del documento.
Representación JSON |
---|
{ "objectId": string, "tabId": string } |
Campos | |
---|---|
object
|
El ID del objeto posicionado que se borrará. |
tab
|
La pestaña en la que se encuentra el objeto posicionado que se borrará. Si se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
UpdateTableColumnPropertiesRequest
Actualiza el TableColumnProperties
de las columnas de una tabla.
Representación JSON |
---|
{ "tableStartLocation": { object ( |
Campos | |
---|---|
table
|
Es la ubicación en la que comienza la tabla en el documento. |
column
|
Es la lista de índices de columnas basados en cero cuya propiedad se debe actualizar. Si no se especifican índices, se actualizarán todas las columnas. |
table
|
Las propiedades de la columna de la tabla que se actualizarán.
Si el valor de |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. El
Por ejemplo, para actualizar el ancho de la columna, establece |
UpdateTableCellStyleRequest
Actualiza el estilo de un rango de celdas de tabla.
Representación JSON |
---|
{ "tableCellStyle": { object ( |
Campos | |
---|---|
table
|
Es el estilo que se debe establecer en las celdas de la tabla. Cuando se actualizan los bordes, si una celda comparte un borde con una celda adyacente, también se actualiza la propiedad de borde correspondiente de la celda adyacente. No se actualizan los bordes que están combinados y son invisibles. Dado que actualizar un borde compartido por celdas adyacentes en la misma solicitud puede causar actualizaciones de borde en conflicto, las actualizaciones de borde se aplican en el siguiente orden:
|
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. El
Por ejemplo, para actualizar el color de fondo de la celda de la tabla, establece Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero deja el campo sin definir. |
Campo de unión cells . Las celdas que se actualizarán.
cells solo puede ser uno de los siguientes:
|
|
table
|
Es el rango de la tabla que representa el subconjunto de la tabla al que se aplican las actualizaciones. |
table
|
La ubicación donde comienza la tabla en el documento. Cuando se especifica, las actualizaciones se aplican a todas las celdas de la tabla. |
TableRange
Un rango de tabla representa una referencia a un subconjunto de una tabla.
Es importante tener en cuenta que las celdas especificadas por un rango de tabla no forman necesariamente un rectángulo. Por ejemplo, supongamos que tenemos una tabla de 3 × 3 en la que todas las celdas de la última fila están combinadas. La tabla tiene el siguiente aspecto:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Un rango de tabla con la ubicación de la celda de la tabla = (tableStartLocation, fila = 0, columna = 0), el intervalo de filas = 3 y el intervalo de columnas = 2 especifica las siguientes celdas:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Representación JSON |
---|
{
"tableCellLocation": {
object ( |
Campos | |
---|---|
table
|
Es la ubicación de la celda donde comienza el rango de la tabla. |
row
|
Es el intervalo de filas del rango de la tabla. |
column
|
El intervalo de columnas del rango de la tabla. |
UpdateTableRowStyleRequest
Actualiza el TableRowStyle
de las filas de una tabla.
Representación JSON |
---|
{ "tableStartLocation": { object ( |
Campos | |
---|---|
table
|
Es la ubicación en la que comienza la tabla en el documento. |
row
|
Es la lista de índices de filas basados en cero cuyo diseño se debe actualizar. Si no se especifican índices, se actualizarán todas las filas. |
table
|
Los estilos que se configurarán en las filas. |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. El
Por ejemplo, para actualizar la altura mínima de la fila, establece |
ReplaceImageRequest
Reemplaza una imagen existente por una nueva.
Cuando se reemplaza una imagen, se quitan algunos
image effects
de la imagen existente para duplicar el comportamiento del editor de Documentos.
Representación JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum ( |
Campos | |
---|---|
image
|
Es el ID de la imagen existente que se reemplazará. El ID se puede recuperar a partir de la respuesta de una solicitud get. |
uri
|
El URI de la imagen nueva. La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla dentro del documento. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
El URI proporcionado no puede superar los 2 KB de longitud. El URI se guarda con la imagen y se expone a través del campo |
image
|
El método de reemplazo |
tab
|
Es la pestaña en la que se encuentra la imagen que se reemplazará. Si se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
ImageReplaceMethod
Es el método de reemplazo de imágenes.
Enumeraciones | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
No se especificó el método de reemplazo de imágenes. No se debe usar este valor. |
CENTER_CROP
|
Escala y centra la imagen para que ocupe los límites de la imagen original. Es posible que se recorte la imagen para llenar los límites de la imagen original. El tamaño renderizado de la imagen será el mismo que el de la imagen original. |
UpdateDocumentStyleRequest
Actualiza DocumentStyle
.
Representación JSON |
---|
{
"documentStyle": {
object ( |
Campos | |
---|---|
document
|
Son los estilos que se configurarán en el documento.
Es posible que ciertos cambios en el estilo del documento provoquen otros cambios para reflejar el comportamiento del editor de Documentos. Consulta la documentación de |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. La raíz
Por ejemplo, para actualizar el fondo, establece |
tab
|
La pestaña que contiene el diseño que se actualizará. Cuando se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
MergeTableCellsRequest
Combina celdas en un Table
.
Representación JSON |
---|
{
"tableRange": {
object ( |
Campos | |
---|---|
table
|
El rango de la tabla que especifica qué celdas de la tabla se combinarán. Cualquier texto de las celdas que se combinen se concatenará y almacenará en la celda “principal” del rango. Esta es la celda superior izquierda del rango cuando la dirección del contenido es de izquierda a derecha y la celda superior derecha del rango en caso contrario. Si el rango no es rectangular (lo que puede ocurrir en algunos casos en los que el rango abarca celdas que ya están combinadas o cuando la tabla no es rectangular), se muestra un error de solicitud incorrecta 400. |
UnmergeTableCellsRequest
Separa celdas en un Table
.
Representación JSON |
---|
{
"tableRange": {
object ( |
Campos | |
---|---|
table
|
Es el rango de la tabla que especifica qué celdas de la tabla se deben combinar. Se separarán todas las celdas combinadas en este rango, pero las celdas que ya no se combinaron no se verán afectadas. Si el rango no tiene celdas combinadas, la solicitud no hará nada. Si hay texto en alguna de las celdas combinadas, este permanecerá en la celda “principal” del bloque resultante de celdas no combinadas. La celda "head" es la celda superior izquierda cuando la dirección del contenido es de izquierda a derecha y la superior derecha en caso contrario. |
CreateHeaderRequest
Crea un Header
. El encabezado nuevo se aplica a SectionStyle
en la ubicación de SectionBreak
si se especifica; de lo contrario, se aplica a DocumentStyle
.
Si ya existe un encabezado del tipo especificado, se muestra un error de solicitud incorrecta 400.
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type
|
Es el tipo de encabezado que se creará. |
section
|
Es la ubicación del |
CreateFootnoteRequest
Crea un segmento Footnote
y le inserta un FootnoteReference
nuevo en la ubicación determinada.
El nuevo segmento Footnote
contendrá un espacio seguido de un carácter de línea nueva.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión footnote_reference_location . Es la ubicación en la que se insertará la referencia de la nota al pie.
footnote_reference_location puede ser solo una de las siguientes opciones:
|
|
location
|
Inserta la referencia de la nota al pie en un índice específico del documento.
La referencia de la nota al pie debe insertarse dentro de los límites de un
Las referencias de notas al pie no se pueden insertar dentro de una ecuación, un encabezado, un pie de página ni una nota al pie. Dado que las referencias de notas al pie solo se pueden insertar en el cuerpo, el campo |
end
|
Inserta la referencia de la nota al pie al final del cuerpo del documento.
Las referencias de nota al pie no se pueden insertar dentro de un encabezado, un pie de página ni una nota al pie. Dado que las referencias de notas al pie solo se pueden insertar en el cuerpo, el campo |
ReplaceNamedRangeContentRequest
Reemplaza el contenido de NamedRange
o NamedRanges
especificado por el contenido de reemplazo determinado.
Ten en cuenta que un objeto NamedRange
individual puede constar de varios ranges
discontinuos. En este caso, solo se reemplazará el contenido del primer rango. Se borrarán los otros rangos y su contenido.
En los casos en que reemplazar o borrar cualquier rango genere una estructura de documento no válida, se muestra un error de solicitud incorrecta 400.
Representación JSON |
---|
{ "tabsCriteria": { object ( |
Campos | |
---|---|
tabs
|
Opcional. Son los criterios que se usan para especificar en qué pestañas se produce el reemplazo. Si se omite, el reemplazo se aplica a todas las pestañas. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
Campo de unión replacement_content . El contenido con el que se reemplazará el contenido existente del rango con nombre.
replacement_content solo puede ser uno de los siguientes:
|
|
text
|
Reemplaza el contenido de los rangos con nombre especificados por el texto determinado. |
Campo de unión named_range_reference . Es una referencia a los rangos con nombre cuyo contenido se reemplazará.
named_range_reference puede ser solo una de las siguientes opciones:
|
|
named
|
Es el ID del rango con nombre cuyo contenido se reemplazará. Si no hay un rango con el ID determinado, se muestra un error de solicitud incorrecta 400. |
named
|
Es el nombre del
Si hay varios |
UpdateSectionStyleRequest
Actualiza la SectionStyle
.
Representación JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range
|
El rango que se superpone con las secciones a las que se les aplicará un diseño.
Debido a que los saltos de sección solo se pueden insertar dentro del cuerpo, el campo |
section
|
Son los estilos que se establecerán en la sección.
Es posible que ciertos cambios en el estilo de la sección provoquen otros cambios para reflejar el comportamiento del editor de Documentos. Consulta la documentación de |
fields
|
Los campos que se deben actualizar.
Se debe especificar al menos un campo. La raíz
Por ejemplo, para actualizar el margen izquierdo, establece |
InsertSectionBreakRequest
Inserta un salto de sección en la ubicación especificada.
Se insertará un carácter de salto de línea antes de la pausa de sección.
Representación JSON |
---|
{ "sectionType": enum ( |
Campos | |
---|---|
section
|
Es el tipo de sección que se insertará. |
Campo de unión insertion_location . Es la ubicación donde se insertará la pausa.
insertion_location solo puede ser uno de los siguientes:
|
|
location
|
Inserta un salto de línea y un salto de sección en un índice específico del documento.
La pausa de sección se debe insertar dentro de los límites de un
No se pueden insertar saltos de sección dentro de una tabla, ecuación, nota al pie, encabezado o pie de página. Dado que los saltos de sección solo se pueden insertar dentro del cuerpo, el campo |
end
|
Inserta una línea nueva y un corte de sección al final del cuerpo del documento.
No se pueden insertar saltos de sección dentro de una nota al pie, un encabezado o un pie de página. Debido a que los saltos de sección solo se pueden insertar dentro del cuerpo, el campo |
DeleteHeaderRequest
Borra un elemento Header
del documento.
Representación JSON |
---|
{ "headerId": string, "tabId": string } |
Campos | |
---|---|
header
|
El ID del encabezado que se borrará. Si este encabezado se define en |
tab
|
La pestaña que contiene el encabezado que se borrará. Si se omite, la solicitud se aplica a la primera pestaña. En un documento que contiene una sola pestaña:
En un documento que contiene varias pestañas:
|
PinTableHeaderRowsRequest
Actualiza la cantidad de filas de encabezado de tabla fijadas en una tabla.
Representación JSON |
---|
{
"tableStartLocation": {
object ( |
Campos | |
---|---|
table
|
La ubicación donde comienza la tabla en el documento. |
pinned
|
La cantidad de filas de la tabla que se fijarán, donde 0 implica que todas las filas no están fijadas. |