Requests

Solicitud

Un solo tipo de actualización para aplicar a una presentación.

Representación JSON
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
Campos
Campo de unión kind. El tipo de actualización Se requiere exactamente un campo. kind solo puede ser uno de los siguientes:
createSlide

object (CreateSlideRequest)

Crea una diapositiva nueva.

createShape

object (CreateShapeRequest)

Crea una forma nueva.

createTable

object (CreateTableRequest)

Crea una nueva tabla.

insertText

object (InsertTextRequest)

Inserta texto en una forma o celda de tabla.

insertTableRows

object (InsertTableRowsRequest)

Inserta filas en una tabla.

insertTableColumns

object (InsertTableColumnsRequest)

Inserta columnas en una tabla.

deleteTableRow

object (DeleteTableRowRequest)

Borra una fila de una tabla.

deleteTableColumn

object (DeleteTableColumnRequest)

Borra una columna de una tabla.

replaceAllText

object (ReplaceAllTextRequest)

Reemplaza todas las instancias del texto especificado.

deleteObject

object (DeleteObjectRequest)

Borra una página o un elemento de la página de la presentación.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Actualiza la transformación de un elemento de página.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Actualiza la posición de un conjunto de diapositivas en la presentación.

deleteText

object (DeleteTextRequest)

Borra el texto de una forma o una celda de tabla.

createImage

object (CreateImageRequest)

Crea una imagen.

createVideo

object (CreateVideoRequest)

Crea un video.

createSheetsChart

object (CreateSheetsChartRequest)

Crea un gráfico de Hojas de cálculo de Google incorporado.

createLine

object (CreateLineRequest)

Crea una línea.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Actualiza un gráfico de Hojas de cálculo de Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Actualiza las propiedades de un Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Actualiza las propiedades de un Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Actualiza las propiedades de un Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Actualiza las propiedades de un Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Actualiza las propiedades de un TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Actualiza las propiedades de un Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Crea viñetas para los párrafos.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Reemplaza todas las formas que coincidan con algunos criterios por una imagen.

duplicateObject

object (DuplicateObjectRequest)

Duplica una diapositiva o un elemento de página.

updateTextStyle

object (UpdateTextStyleRequest)

Actualiza el estilo del texto dentro de un elemento Shape o Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Reemplaza todas las formas que coincidan con algunos criterios por un gráfico de Hojas de cálculo de Google.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Borra los viñetas de los párrafos.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Actualiza el diseño de los párrafos dentro de un Shape o Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Actualiza las propiedades de los bordes de la tabla en un Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Actualiza las propiedades de una columna Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Actualiza las propiedades de una fila Table.

mergeTableCells

object (MergeTableCellsRequest)

Combina celdas en un Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Separa las celdas en un Table.

groupObjects

object (GroupObjectsRequest)

Agrupa objetos, como elementos de página.

ungroupObjects

object (UngroupObjectsRequest)

Desagrupa objetos, como groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Actualiza el título o la descripción del texto alternativo de un page element.

replaceImage

object (ReplaceImageRequest)

Reemplaza una imagen existente por una nueva.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Actualiza las propiedades de una diapositiva.

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Actualiza el orden en Z de page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Actualiza la categoría de un line.

rerouteLine

object (RerouteLineRequest)

Vuelve a enrutar un line de modo que esté conectado en los dos sitios de conexión más cercanos en los elementos de página conectados.

CreateSlideRequest

Crea una diapositiva.

Representación JSON
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos caracteres, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID debe ser de entre 5 y 50 caracteres inclusive.

Si no especificas un ID, se generará uno único.

insertionIndex

integer

Es el índice opcional basado en cero que indica dónde insertar las diapositivas.

Si no especificas un índice, la diapositiva se creará al final.

slideLayoutReference

object (LayoutReference)

Es la referencia de diseño de la diapositiva que se insertará, según el principal actual, que es una de las siguientes opciones:

  • Es el elemento principal del índice de la diapositiva anterior.
  • El elemento principal de la primera diapositiva, si el valor de insertionIndex es cero.
  • El primer elemento maestro de la presentación, si no hay diapositivas

Si no se encuentra el elemento LayoutReference en el elemento principal actual, se muestra un error de solicitud incorrecta 400.

Si no especificas una referencia de diseño, la diapositiva usará el diseño predefinido BLANK.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Es una lista opcional de asignaciones de ID de objetos de los placeholder en el diseño a los marcadores de posición que se crean en la diapositiva desde el diseño especificado. Solo se puede usar cuando se especifica slideLayoutReference.

LayoutReference

Referencia del diseño de la diapositiva. Puede hacer referencia a lo siguiente:

  • Un diseño predefinido
  • Uno de los diseños de la presentación.
Representación JSON
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
Campos
Campo de unión kind. Es el tipo de LayoutReference. kind solo puede ser uno de los siguientes:
predefinedLayout

enum (PredefinedLayout)

Diseño predefinido.

layoutId

string

ID de diseño: Es el ID del objeto de uno de los diseños de la presentación.

PredefinedLayout

Son los tipos de diseño predefinidos. Estos son diseños que se suelen encontrar en las presentaciones. Sin embargo, no hay garantía de que estos diseños estén presentes en el maestro actual, ya que podrían haberse borrado o no ser parte del tema utilizado. Además, es posible que se hayan cambiado los marcadores de posición de cada diseño.

Enumeraciones
PREDEFINED_LAYOUT_UNSPECIFIED Es un diseño no especificado.
BLANK Diseño en blanco, sin marcadores de posición.
CAPTION_ONLY Diseño con un subtítulo en la parte inferior.
TITLE Diseño con un título y un subtítulo.
TITLE_AND_BODY Diseño con un título y un cuerpo.
TITLE_AND_TWO_COLUMNS Diseño con un título y dos columnas.
TITLE_ONLY Diseño con solo un título.
SECTION_HEADER Diseño con un título de sección.
SECTION_TITLE_AND_DESCRIPTION Diseño con un título y un subtítulo en un lado y una descripción en el otro.
ONE_COLUMN_TEXT Diseño con un título y un cuerpo, organizados en una sola columna.
MAIN_POINT Diseño con un punto principal.
BIG_NUMBER Diseño con un encabezado de número grande.

LayoutPlaceholderIdMapping

La asignación de ID especificada por el usuario para un marcador de posición que se creará en una diapositiva a partir de un diseño especificado.

Representación JSON
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
Campos
objectId

string

Es un ID de objeto proporcionado por el usuario para el marcador de posición identificado anteriormente que se creará en una diapositiva.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

Campo de unión kind. Es el tipo para identificar un marcador de posición en un diseño. kind solo puede ser uno de los siguientes:
layoutPlaceholder

object (Placeholder)

Es el marcador de posición en un diseño que se aplicará a una diapositiva. Solo se necesitan type y index. Por ejemplo, un diseño TITLE_AND_BODY predefinido suele tener un marcador de posición TITLE con el índice 0 y un marcador de posición BODY con el índice 0.

layoutPlaceholderObjectId

string

Es el ID del objeto del marcador de posición en un diseño que se aplicará a una diapositiva.

CreateShapeRequest

Crea una forma nueva.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50. Si está vacío, se generará un identificador único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento para la forma.

shapeType

enum (Type)

Es el tipo de forma.

PageElementProperties

Son propiedades comunes para un elemento de página.

Nota: Cuando creas un PageElement inicialmente, la API puede modificar los valores de size y transform, pero el tamaño visual no cambiará.

Representación JSON
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Campos
pageObjectId

string

Es el ID del objeto de la página en la que se encuentra el elemento.

size

object (Size)

Es el tamaño del elemento.

transform

object (AffineTransform)

Es la transformación del elemento.

CreateTableRequest

Crea una nueva tabla.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

elementProperties

object (PageElementProperties)

Son las propiedades del elemento de la tabla.

La tabla se creará con el tamaño proporcionado, sujeto a un tamaño mínimo. Si no se proporciona un tamaño, la tabla se ajustará automáticamente.

Las transformaciones de tablas deben tener una escala de 1 y no tener componentes de corte. Si no se proporciona ninguna transformación, la tabla se centrará en la página.

rows

integer

Cantidad de filas en la tabla.

columns

integer

Cantidad de columnas en la tabla.

InsertTextRequest

Inserta texto en una forma o una celda de tabla.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Campos
objectId

string

El ID del objeto de la forma o la tabla en la que se insertará el texto.

cellLocation

object (TableCellLocation)

Es la ubicación opcional de la celda de la tabla si el texto se va a insertar en una celda de la tabla. Si está presente, el objectId debe hacer referencia a una tabla.

text

string

Es el texto que se insertará.

Si insertas un carácter de salto de línea, se creará implícitamente un ParagraphMarker nuevo en ese índice. El estilo de párrafo del párrafo nuevo se copiará del párrafo en el índice de inserción actual, incluidas las listas y los viñetas.

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 texto se agregará al TextRun que existe en el í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).

insertionIndex

integer

Es el índice en el que se insertará el texto, en unidades de código Unicode, según los índices TextElement.

El índice se basa en cero y se calcula desde el principio de la cadena. El índice se puede ajustar para evitar inserciones dentro de los clústeres de grafemas Unicode. En estos casos, el texto se insertará inmediatamente después del clúster de grafemas.

InsertTableRowsRequest

Inserta filas en una tabla.

Representación JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Campos
tableObjectId

string

Es la tabla en la que se insertarán las filas.

cellLocation

object (TableCellLocation)

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.

insertBelow

boolean

Indica si se deben insertar filas nuevas debajo de la ubicación de la celda de referencia.

  • True : Se inserta debajo de la celda.
  • False : Se inserta sobre la celda.
number

integer

Es la cantidad de filas que se insertarán. Máximo de 20 por solicitud.

InsertTableColumnsRequest

Inserta columnas en una tabla.

El tamaño de las otras columnas de la tabla se ajustará para adaptarse a la nueva columna.

Representación JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Campos
tableObjectId

string

Es la tabla en la que se insertarán las columnas.

cellLocation

object (TableCellLocation)

Es 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.

insertRight

boolean

Indica si se deben insertar columnas nuevas a la derecha de la ubicación de la celda de referencia.

  • True : Inserta a la derecha.
  • False : Inserta a la izquierda.
number

integer

Es la cantidad de columnas que se insertarán. Máximo de 20 por solicitud.

DeleteTableRowRequest

Borra una fila de una tabla.

Representación JSON
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Campos
tableObjectId

string

La tabla de la que se borrarán las filas.

cellLocation

object (TableCellLocation)

Es la ubicación de la celda de la tabla de referencia desde la que se borrará una fila.

Se borrará la fila que abarca esta celda. Si se trata de una celda combinada, se borrarán varias filas. 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
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Campos
tableObjectId

string

La tabla de la que se borrarán las columnas.

cellLocation

object (TableCellLocation)

Es la ubicación de la celda de la tabla de referencia desde la que se borrará una columna.

Se borrará la columna que abarca esta celda. Si se trata de una celda combinada, se borrarán varias columnas. Si no queda ninguna columna en la tabla después de esta eliminación, se borrará toda la tabla.

ReplaceAllTextRequest

Reemplaza todas las instancias de texto que coincidan con un criterio por replace text.

Representación JSON
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Campos
replaceText

string

Es el texto que reemplazará el texto coincidente.

pageObjectIds[]

string

Si no está vacío, limita las coincidencias a los elementos de página solo en las páginas determinadas.

Muestra un error de solicitud incorrecta 400 si se le proporciona el ID de objeto de página de un notes master o si no existe una página con ese ID de objeto en la presentación.

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:
containsText

object (SubstringMatchCriteria)

Busca texto en una forma que coincida con esta subcadena.

SubstringMatchCriteria

Es un criterio que coincide con una cadena de texto específica en una forma o tabla.

Representación JSON
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Campos
text

string

Es el texto que se busca en la forma o la tabla.

matchCase

boolean

Indica si la búsqueda debe respetar mayúsculas y minúsculas:

  • True : La búsqueda distingue mayúsculas de minúsculas.
  • False : La búsqueda no distingue mayúsculas de minúsculas.
searchByRegex

boolean

Opcional. Es verdadero si el valor de búsqueda se debe tratar como una expresión regular. Se deben escapar las barras invertidas del patrón.

  • True: El texto de búsqueda se trata como una expresión regular.
  • False: El texto de búsqueda se considera una subcadena para la coincidencia.

DeleteObjectRequest

Borra un objeto, ya sea pages o page elements, de la presentación.

Representación JSON
{
  "objectId": string
}
Campos
objectId

string

Es el ID del objeto de la página o el elemento de página que se borrará.

Si después de una operación de eliminación un group solo contiene 1 elemento de página o ninguno, el grupo también se borra.

Si se borra un marcador de posición en un diseño, también se borran los marcadores de posición de herencia vacíos.

UpdatePageElementTransformRequest

Actualiza la transformación de un elemento de página.

Si actualizas la transformación de un grupo, se cambiará la transformación absoluta de los elementos de la página en ese grupo, lo que puede cambiar su apariencia visual. Consulta la documentación de PageElement.transform para obtener más detalles.

Representación JSON
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Campos
objectId

string

Es el ID del objeto del elemento de página que se actualizará.

transform

object (AffineTransform)

Es la matriz de transformación de entrada que se usa para actualizar el elemento de página.

applyMode

enum (ApplyMode)

Es el modo de aplicación de la actualización de transformación.

ApplyMode

Los modos de aplicación de la actualización de transformación

Enumeraciones
APPLY_MODE_UNSPECIFIED Modo sin especificar.
RELATIVE Aplica la nueva matriz AffineTransform a la existente y la reemplaza con la concatenación resultante.
ABSOLUTE Reemplaza la matriz AffineTransform existente por la nueva.

UpdateSlidesPositionRequest

Actualiza la posición de las diapositivas en la presentación.

Representación JSON
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Campos
slideObjectIds[]

string

Los IDs de las diapositivas de la presentación que se deben mover Las diapositivas de esta lista deben estar en el orden de presentación existente, sin duplicados.

insertionIndex

integer

Es el índice en el que se deben insertar las diapositivas, según la disposición de las diapositivas antes de que se realice el movimiento. Debe estar entre cero y la cantidad de diapositivas de la presentación inclusive.

DeleteTextRequest

Borra el texto de una forma o una celda de tabla.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Campos
objectId

string

El ID del objeto de la forma o la tabla de la que se borrará el texto.

cellLocation

object (TableCellLocation)

Es la ubicación opcional de la celda de la tabla si se va a borrar el texto de una celda de la tabla. Si está presente, el objectId debe hacer referencia a una tabla.

textRange

object (Range)

Es el rango de texto que se borrará, según los índices TextElement.

Siempre hay un carácter de línea nueva implícito al final del texto de una forma o una celda de tabla que no se puede borrar. Range.Type.ALL usará los límites correctos, pero se debe tener cuidado cuando se especifiquen límites explícitos para los tipos de rangos FROM_START_INDEX y FIXED_RANGE. Por ejemplo, si el texto es "ABC", seguido de una línea nueva implícita, el valor máximo es 2 para textRange.start_index y 3 para textRange.end_index.

Si borras texto que cruza el límite de un párrafo, es posible que se produzcan cambios en los estilos de párrafo y las listas a medida que se combinan los dos párrafos.

Los rangos que incluyen solo una unidad de código de un par de sustitutos se expanden para incluir ambas unidades de código.

Rango

Especifica un rango contiguo de una colección indexada, como caracteres en texto.

Representación JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Campos
startIndex

integer

El índice opcional basado en cero del comienzo de la colección. Obligatorio para los rangos FIXED_RANGE y FROM_START_INDEX.

endIndex

integer

El índice opcional basado en cero del final de la colección. Obligatorio para los rangos FIXED_RANGE.

type

enum (Type)

Es el tipo de rango.

Tipo

Los tipos de rangos

Enumeraciones
RANGE_TYPE_UNSPECIFIED Tipo de intervalo no especificado. No se debe usar este valor.
FIXED_RANGE Es un rango fijo. Se deben especificar startIndex y endIndex.
FROM_START_INDEX Inicia el rango en startIndex y continúa hasta el final de la colección. No se debe especificar endIndex.
ALL Establece el rango como la longitud total de la colección. No se deben especificar startIndex ni endIndex.

CreateImageRequest

Crea una imagen.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

elementProperties

object (PageElementProperties)

Son las propiedades del elemento para la imagen.

Cuando la relación de aspecto del tamaño proporcionado no coincide con la relación de aspecto de la imagen, esta se ajusta y se centra en función del tamaño para mantener la relación de aspecto. La transformación proporcionada se aplica después de esta operación.

La propiedad PageElementProperties.size es opcional. Si no especificas el tamaño, se usa el tamaño predeterminado de la imagen.

La propiedad PageElementProperties.transform es opcional. Si no especificas una transformación, la imagen se colocará en la esquina superior izquierda de la página.

Campo de unión image_source. Es el tipo de fuente de imagen. image_source solo puede ser uno de los siguientes:
url

string

Es la URL de la imagen.

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en uno de los formatos PNG, JPEG o GIF.

La URL proporcionada debe ser de acceso público y tener una longitud de hasta 2 KB. La URL se guarda con la imagen y se expone a través del campo Image.source_url.

CreateVideoRequest

Crea un video.

NOTA: Para crear un video desde Google Drive, la app solicitante debe tener, al menos, uno de los permisos de OAuth de drive, drive.readonly o drive.file.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento del video

La propiedad PageElementProperties.size es opcional. Si no especificas un tamaño, el servidor elegirá uno predeterminado.

La propiedad PageElementProperties.transform es opcional. La transformación no debe tener componentes de corte. Si no especificas una transformación, el video se colocará en la esquina superior izquierda de la página.

source

enum (Source)

Es la fuente del video.

id

string

Es el identificador único de la fuente de video para este video.

p.ej., para el video de YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, el ID es 7U3axjORYZ0. Para un video de Google Drive, https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q, el ID es 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Para acceder a un archivo de video de Google Drive, es posible que debas agregar una clave de recurso al encabezado HTTP de un subconjunto de archivos antiguos. Para obtener más información, consulta Cómo acceder a archivos compartidos con vínculos usando claves de recursos.

CreateSheetsChartRequest

Crea un gráfico de Hojas de cálculo de Google incorporado.

NOTA: La creación de gráficos requiere al menos uno de los permisos de OAuth de spreadsheets.readonly, spreadsheets, drive.readonly, drive.file o drive.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si se especifica, el ID debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter de palabra [a-zA-Z0-9_] y, luego, debe ir seguido de cualquier cantidad de los siguientes caracteres [a-zA-Z0-9_-:]. La longitud del ID no debe ser inferior a 5 ni superior a 50. Si está vacío, se generará un identificador único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento para el gráfico.

Cuando la relación de aspecto del tamaño proporcionado no coincide con la del gráfico, este se ajusta y se centra en función del tamaño para mantener la relación de aspecto. La transformación proporcionada se aplica después de esta operación.

spreadsheetId

string

El ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico.

Es posible que debas agregar una clave de recurso al encabezado HTTP para un subconjunto de archivos antiguos. Para obtener más información, consulta Cómo acceder a archivos compartidos con vínculos usando claves de recursos.

chartId

integer

El ID del gráfico específico en la hoja de cálculo de Hojas de cálculo de Google.

linkingMode

enum (LinkingMode)

Es el modo con el que el gráfico está vinculado a la hoja de cálculo de origen. Si no se especifica, el gráfico será una imagen que no estará vinculada.

LinkingMode

Es el modo con el que el gráfico está vinculado a la hoja de cálculo de origen.

Enumeraciones
NOT_LINKED_IMAGE El gráfico no está asociado con la hoja de cálculo de origen y no se puede actualizar. Un gráfico que no esté vinculado se insertará como imagen.
LINKED Si vinculas el gráfico, podrás actualizarlo, y los demás colaboradores verán un vínculo a la hoja de cálculo.

CreateLineRequest

Crea una línea.

Representación JSON
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Campos
objectId

string

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento para la línea.

lineCategory
(deprecated)

enum (Category)

Es la categoría de la línea que se creará.

Obsoleto : Usa category en su lugar.

El line type exacto que se crea se determina en función de la categoría y de cómo se enruta para conectarse a otros elementos de la página.

Si especificas category y lineCategory, category tendrá prioridad.

category

enum (LineCategory)

Es la categoría de la línea que se creará.

El line type exacto que se crea se determina en función de la categoría y de cómo se enruta para conectarse a otros elementos de la página.

Si especificas category y lineCategory, category tendrá prioridad.

Si no especificas un valor para category, pero sí para lineCategory, se usa el valor especificado para lineCategory.

Si no especificas ninguno, se usa STRAIGHT.

Categoría

Las categorías de línea

Enumeraciones
STRAIGHT Conectores rectos, incluido el conector recto 1 Esta es la categoría predeterminada cuando no se especifica una.
BENT Conectores doblados, incluidos los conectores doblados del 2 al 5
CURVED Conectores curvos, incluidos los conectores curvos del 2 al 5

RefreshSheetsChartRequest

Actualiza un gráfico incorporado de Hojas de cálculo de Google reemplazándolo por la versión más reciente del gráfico de Hojas de cálculo de Google.

NOTA: Para actualizar los gráficos, se requiere al menos uno de los permisos de OAuth de spreadsheets.readonly, spreadsheets, drive.readonly o drive.

Representación JSON
{
  "objectId": string
}
Campos
objectId

string

Es el ID del objeto del gráfico que se actualizará.

UpdateShapePropertiesRequest

Actualiza las propiedades de un Shape.

Representación JSON
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto a la que se aplican las actualizaciones.

shapeProperties

object (ShapeProperties)

Las propiedades de forma que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El shapeProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color de relleno sólido del fondo de la forma, establece fields en "shapeBackgroundFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdateImagePropertiesRequest

Actualiza las propiedades de un Image.

Representación JSON
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto a la que se aplican las actualizaciones.

imageProperties

object (ImageProperties)

Las propiedades de la imagen que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El imageProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color del contorno de la imagen, establece fields en "outline.outlineFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdateVideoPropertiesRequest

Actualiza las propiedades de un Video.

Representación JSON
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto del video al que se aplican las actualizaciones.

videoProperties

object (VideoProperties)

Las propiedades de video que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El videoProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color del contorno del video, configura fields como "outline.outlineFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdatePagePropertiesRequest

Actualiza las propiedades de un Page.

Representación JSON
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto de la página a la que se aplica la actualización.

pageProperties

object (PageProperties)

Las propiedades de la página que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El pageProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color de relleno sólido del fondo de la página, establece fields en "pageBackgroundFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdateTableCellPropertiesRequest

Actualiza las propiedades de un TableCell.

Representación JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

Es el rango de la tabla que representa el subconjunto de la tabla al que se aplican las actualizaciones. Si no se especifica un rango de tablas, las actualizaciones se aplicarán a toda la tabla.

tableCellProperties

object (TableCellProperties)

Las propiedades de las celdas de la tabla que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El tableCellProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color de relleno sólido del fondo de la celda de la tabla, establece fields en "tableCellBackgroundFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

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 se ve de la siguiente manera:

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Un rango de tabla con ubicación = (0, 0), intervalo de filas = 3 y intervalo de columnas = 2 especifica las siguientes celdas:

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Representación JSON
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Campos
location

object (TableCellLocation)

Es la ubicación de inicio del rango de la tabla.

rowSpan

integer

Es el intervalo de filas del rango de la tabla.

columnSpan

integer

El intervalo de columnas del rango de la tabla.

UpdateLinePropertiesRequest

Actualiza las propiedades de un Line.

Representación JSON
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto a la línea a la que se aplica la actualización.

lineProperties

object (LineProperties)

Las propiedades de línea que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El lineProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color de relleno sólido de la línea, establece fields en "lineFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

CreateParagraphBulletsRequest

Crea viñetas para todos los párrafos que se superponen con el rango de índice de texto 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 inmediatamente anterior a los párrafos que se actualizarán está en una lista con un parámetro predeterminado coincidente, los párrafos que se actualizarán se agregarán a esa lista anterior.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Campos
objectId

string

El ID del objeto de la forma o la tabla que contiene el texto al que se agregarán viñetas.

cellLocation

object (TableCellLocation)

Es la ubicación opcional de la celda de la tabla si el texto que se va a modificar está en una celda de la tabla. Si está presente, el objectId debe hacer referencia a una tabla.

textRange

object (Range)

Es el rango de texto al que se aplicarán los ajustes predeterminados de viñetas, según los índices de TextElement.

bulletPreset

enum (BulletGlyphPreset)

Los tipos de glifos de viñeta que se usarán. El valor predeterminado es el preajuste BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Patrones predeterminados de glifos de viñetas para listas en el texto.

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 U+2756 de Unicode
  • HOLLOWDIAMOND : Un diamante hueco 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 : 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".
  • DIGIT : Es un número, como “1”, “2” o “3”.
  • ZERODIGIT : Es un número en el que los números de un solo dígito tienen un cero como prefijo, 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_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ñeta ARROW3D, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
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ñeta DIAMOND, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
NUMBERED_DIGIT_ALPHA_ROMAN Una lista numerada con glifos numéricos DIGIT, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Una lista numerada con glifos numéricos DIGIT, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de paréntesis.
NUMBERED_DIGIT_NESTED Una lista numerada con glifos numéricos DIGIT 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_DIGIT Una lista numerada con glifos numéricos UPPERROMAN, UPPERALPHA y DIGIT para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Una lista numerada con glifos numéricos ZERODIGIT, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.

ReplaceAllShapesWithImageRequest

Reemplaza todas las formas que coincidan con los criterios determinados por la imagen proporcionada.

Las imágenes que reemplazan las formas son rectangulares después de insertarse en la presentación y no adoptan la forma de las formas.

Representación JSON
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
Campos
replaceMethod
(deprecated)

enum (ReplaceMethod)

El método replace.

Obsoleto : Usa imageReplaceMethod en su lugar.

Si especificas un replaceMethod y un imageReplaceMethod, imageReplaceMethod tendrá prioridad.

imageReplaceMethod

enum (ImageReplaceMethod)

Es el método de reemplazo de imágenes.

Si especificas replaceMethod y imageReplaceMethod, imageReplaceMethod tendrá prioridad.

Si no especificas un valor para imageReplaceMethod, pero sí para replaceMethod, se usará el valor especificado para replaceMethod.

Si no especificas ninguno, se usa CENTER_INSIDE.

pageObjectIds[]

string

Si no está vacío, limita las coincidencias a los elementos de página solo en las páginas determinadas.

Muestra un error de solicitud incorrecta 400 si se proporciona el ID de objeto de página de un notes page o un notes master, o si no existe una página con ese ID de objeto en la presentación.

Campo de unión criteria. Son los criterios que deben coincidir las formas para que se reemplacen. criteria solo puede ser uno de los siguientes:
containsText

object (SubstringMatchCriteria)

Si se establece, esta solicitud reemplazará todas las formas que contengan el texto determinado.

Campo de unión image_source. Es el tipo de fuente de imagen. image_source solo puede ser uno de los siguientes:
imageUrl

string

Es la URL de la imagen.

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla en la presentación. 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.

La URL proporcionada puede tener una longitud máxima de 2 KB. La URL se guarda con la imagen y se expone a través del campo Image.source_url.

ReplaceMethod

El método replace.

Enumeraciones
CENTER_INSIDE Escala y centra la imagen para que se ajuste a los límites de la forma original y mantiene la relación de aspecto de la imagen. Es posible que el tamaño renderizado de la imagen sea menor que el tamaño de la forma. Este es el método predeterminado cuando no se especifica uno.
CENTER_CROP Escala y centra la imagen para que ocupe los límites de la forma original. Es posible que la imagen se recorte para cubrir la forma. El tamaño renderizado de la imagen será el mismo que el de la forma original.

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_INSIDE Escala y centra la imagen para que se ajuste a los límites de la forma original y mantiene la relación de aspecto de la imagen. Es posible que el tamaño renderizado de la imagen sea menor que el tamaño de la forma. Este es el método predeterminado cuando no se especifica uno.
CENTER_CROP Escala y centra la imagen para que ocupe los límites de la forma original. Es posible que la imagen se recorte para cubrir la forma. El tamaño renderizado de la imagen será el mismo que la forma original.

DuplicateObjectRequest

Duplica una diapositiva o un elemento de página.

Cuando se duplica una diapositiva, la copia se crea inmediatamente después de la diapositiva especificada. Cuando se duplica un elemento de página, el duplicado se coloca en la misma página y en la misma posición que el original.

Representación JSON
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Campos
objectId

string

Es el ID del objeto que se duplicará.

objectIds

map (key: string, value: string)

El objeto que se duplica puede contener otros objetos, por ejemplo, cuando se duplica una diapositiva o un elemento de página de grupo. Este mapa define cómo se generan los IDs de los objetos duplicados: las claves son los IDs de los objetos originales y sus valores son los IDs que se asignarán al objeto duplicado correspondiente. El ID del duplicado del objeto fuente también se puede especificar en este mapa, con el mismo valor del campo objectId como clave y el ID deseado como valor.

Todas las claves deben corresponder a IDs existentes en la presentación. Todos los valores deben ser únicos en la presentación y deben comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID nuevo no debe ser inferior a 5 ni superior a 50.

Si se omite algún ID de los objetos de origen del mapa, se asignará un ID aleatorio nuevo. Si el mapa está vacío o no está establecido, todos los objetos duplicados recibirán un nuevo ID aleatorio.

UpdateTextStyleRequest

Actualiza el diseño del texto en un Shape o Table.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Campos
objectId

string

El ID del objeto de la forma o la tabla con el texto al que se le aplicará el diseño.

cellLocation

object (TableCellLocation)

Es la ubicación de la celda en la tabla que contiene el texto al que se le aplicará un estilo. Si objectId hace referencia a una tabla, cellLocation debe tener un valor. De lo contrario, no debe hacerlo.

style

object (TextStyle)

Son los estilos que se deben configurar 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 del texto pueden provocar otros cambios que tienen como objetivo reflejar el comportamiento del editor de Presentaciones. Consulta la documentación de TextStyle para obtener más información.

textRange

object (Range)

Es el rango de texto al que se le aplicará el 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.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El style raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el estilo de texto a negrita, establece fields en "bold".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

ReplaceAllShapesWithSheetsChartRequest

Reemplaza todas las formas que coincidan con los criterios determinados por el gráfico de Hojas de cálculo de Google proporcionado. El gráfico se ajustará y centrará para que se ajuste a los límites de la forma original.

NOTA: Para reemplazar formas por un gráfico, se requiere al menos uno de los permisos de OAuth de spreadsheets.readonly, spreadsheets, drive.readonly o drive.

Representación JSON
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Campos
containsText

object (SubstringMatchCriteria)

Son los criterios que deben coincidir las formas para que se reemplacen. La solicitud reemplazará todas las formas que contengan el texto determinado.

spreadsheetId

string

El ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico.

chartId

integer

Es el ID del gráfico específico en la hoja de cálculo de Hojas de cálculo de Google.

linkingMode

enum (LinkingMode)

Es el modo con el que el gráfico está vinculado a la hoja de cálculo de origen. Si no se especifica, el gráfico será una imagen que no estará vinculada.

pageObjectIds[]

string

Si no está vacío, limita las coincidencias a los elementos de página solo en las páginas determinadas.

Muestra un error de solicitud incorrecta 400 si se proporciona el ID de objeto de página de un notes page o un notes master, o si no existe una página con ese ID de objeto en la presentación.

LinkingMode

Es el modo con el que el gráfico está vinculado a la hoja de cálculo de origen.

Enumeraciones
NOT_LINKED_IMAGE El gráfico no está asociado con la hoja de cálculo de origen y no se puede actualizar. Un gráfico que no esté vinculado se insertará como imagen.
LINKED Si vinculas el gráfico, podrás actualizarlo, y los demás colaboradores verán un vínculo a la hoja de cálculo.

DeleteParagraphBulletsRequest

Borra los viñetas de todos los párrafos que se superponen con el índice de texto determinado range.

El nivel de anidamiento de cada párrafo se conservará visualmente si se agrega sangría al principio del párrafo correspondiente.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Campos
objectId

string

Es el ID del objeto de la forma o la tabla que contiene el texto del que se deben borrar las viñetas.

cellLocation

object (TableCellLocation)

Es la ubicación opcional de la celda de la tabla si el texto que se va a modificar está en una celda de la tabla. Si está presente, el objectId debe hacer referencia a una tabla.

textRange

object (Range)

Es el rango de texto del que se deben borrar las viñetas, según los índices TextElement.

UpdateParagraphStyleRequest

Actualiza el diseño de todos los párrafos dentro de un Shape o Table que se superponen con el rango de índice de texto determinado.

Representación JSON
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Campos
objectId

string

El ID del objeto de la forma o la tabla con el texto al que se le aplicará el diseño.

cellLocation

object (TableCellLocation)

Es la ubicación de la celda en la tabla que contiene los párrafos a los que se les aplicará un estilo. Si objectId hace referencia a una tabla, cellLocation debe tener un valor. De lo contrario, no debe hacerlo.

style

object (ParagraphStyle)

Es el estilo del párrafo.

textRange

object (Range)

Es el rango de texto que contiene los párrafos a los que se les aplicará un estilo.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El style raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar la alineación del párrafo, establece fields en "alignment".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdateTableBorderPropertiesRequest

Actualiza las propiedades de los bordes de la tabla en un Table.

Representación JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

Es el rango de la tabla que representa el subconjunto de la tabla al que se aplican las actualizaciones. Si no se especifica un rango de tablas, las actualizaciones se aplicarán a toda la tabla.

borderPosition

enum (BorderPosition)

Es la posición del borde en el rango de la tabla al que se deben aplicar las actualizaciones. Si no se especifica una posición de borde, las actualizaciones se aplicarán a todos los bordes del rango de la tabla.

tableBorderProperties

object (TableBorderProperties)

Son las propiedades del borde de la tabla que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El tableBorderProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el color de relleno sólido del borde de la tabla, establece fields en "tableBorderFill.solidFill.color".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

BorderPosition

La posición del borde de la tabla.

Enumeraciones
ALL Todos los bordes del rango
BOTTOM Bordes en la parte inferior del rango.
INNER Bordes dentro del rango.
INNER_HORIZONTAL Bordes horizontales dentro del rango.
INNER_VERTICAL Bordes verticales dentro del rango
LEFT Bordes a la izquierda del rango.
OUTER Bordes alrededor del rango
RIGHT Bordes a la derecha del rango
TOP Bordes en la parte superior del rango.

UpdateTableColumnPropertiesRequest

Actualiza las propiedades de una columna Table.

Representación JSON
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto de la tabla.

columnIndices[]

integer

Es la lista de índices basados en cero que especifican qué columnas se deben actualizar. Si no se proporcionan índices, se actualizarán todas las columnas de la tabla.

tableColumnProperties

object (TableColumnProperties)

Las propiedades de la columna de la tabla que se actualizarán.

Si el valor de tableColumnProperties#columnWidth en la solicitud es inferior a 406,400 EMU (32 puntos), se muestra un error de solicitud incorrecta 400.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El tableColumnProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar el ancho de la columna, establece fields en "columnWidth".

Si se incluye "columnWidth" en la máscara de campo, pero no se establece la propiedad, el ancho de la columna será de 406,400 EMU (32 puntos) de forma predeterminada.

UpdateTableRowPropertiesRequest

Actualiza las propiedades de una fila Table.

Representación JSON
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto de la tabla.

rowIndices[]

integer

Es la lista de índices basados en cero que especifican qué filas se deben actualizar. Si no se proporcionan índices, se actualizarán todas las filas de la tabla.

tableRowProperties

object (TableRowProperties)

Las propiedades de la fila de la tabla que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El tableRowProperties raíz se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar la altura mínima de la fila, establece fields en "minRowHeight".

Si se incluye "minRowHeight" en la máscara de campo, pero no se establece la propiedad, la altura mínima de la fila será de 0 de forma predeterminada.

MergeTableCellsRequest

Combina celdas en un Table.

Representación JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Campos
objectId

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

Es 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 superior izquierda ("cabecera") del rango. 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), se muestra un error 400 de solicitud incorrecta.

UnmergeTableCellsRequest

Separa las celdas de un Table.

Representación JSON
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Campos
objectId

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

Es el rango de la tabla que especifica qué celdas de la tabla se deben combinar.

Se desunirán todas las celdas combinadas de este rango, y las celdas que ya no estén combinadas 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 superior izquierda ("principal") del bloque resultante de celdas no combinadas.

GroupObjectsRequest

Agrupa objetos para crear un grupo de objetos. Por ejemplo, agrupa PageElements para crear un Group en la misma página que todos los elementos secundarios.

Representación JSON
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Campos
groupObjectId

string

Un ID de objeto proporcionado por el usuario para el grupo que se creará.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

Si no especificas un ID, se generará uno único.

childrenObjectIds[]

string

Los IDs de los objetos que se agruparán.

Solo se pueden agrupar los elementos de la página. Debe haber al menos dos elementos de página en la misma página que no estén en otro grupo. No se pueden agrupar algunos elementos de la página, como videos, tables y placeholders.

UngroupObjectsRequest

Desagrupa objetos, como groups.

Representación JSON
{
  "objectIds": [
    string
  ]
}
Campos
objectIds[]

string

Los IDs de los objetos que se desgruparán

Solo se pueden desagrupar los groups que no están dentro de otros groups. Todos los grupos deben estar en la misma página. Se borra el grupo. Se conservan los tamaños y las posiciones visuales de todos los elementos secundarios.

UpdatePageElementAltTextRequest

Actualiza el título o la descripción del texto alternativo de un page element.

Representación JSON
{
  "objectId": string,
  "title": string,
  "description": string
}
Campos
objectId

string

Es el ID del objeto al que se aplican las actualizaciones.

title

string

Es el título del texto alternativo actualizado del elemento de página. Si no se establece, se mantendrá el valor existente. El título se expone a los lectores de pantalla y a otras interfaces de accesibilidad. Usa solo valores legibles por humanos relacionados con el contenido del elemento de página.

description

string

La descripción actualizada del texto alternativo del elemento de la página. Si no se establece, se mantendrá el valor existente. La descripción se expone a los lectores de pantalla y a otras interfaces de accesibilidad. Usa solo valores legibles por humanos relacionados con el contenido del elemento de página.

ReplaceImageRequest

Reemplaza una imagen existente por una nueva.

Si reemplazas una imagen, se quitarán algunos image effects de la imagen existente.

Representación JSON
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Campos
imageObjectId

string

Es el ID de la imagen existente que se reemplazará. El ID se puede recuperar de la respuesta de una solicitud GET.

imageReplaceMethod

enum (ImageReplaceMethod)

El método de reemplazo

Campo de unión image_source. Es el tipo de fuente de imagen. image_source solo puede ser uno de los siguientes:
url

string

Es la URL de la imagen.

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla en la presentación. 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.

La URL proporcionada no puede superar los 2 KB de longitud. La URL se guarda con la imagen y se expone a través del campo Image.source_url.

UpdateSlidePropertiesRequest

Actualiza las propiedades de una diapositiva.

Representación JSON
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Campos
objectId

string

Es el ID del objeto a la que se aplica la actualización.

slideProperties

object (SlideProperties)

Las propiedades de la diapositiva que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. El elemento raíz "slideProperties" se da por sentado y no se debe especificar. Se puede usar un solo "*" como abreviatura para enumerar todos los campos.

Por ejemplo, para actualizar si se omite una diapositiva, establece fields en "isSkipped".

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero no configures el campo.

UpdatePageElementsZOrderRequest

Actualiza el orden en Z de los elementos de la página. El orden en Z es un orden de los elementos de la página de atrás hacia adelante. El elemento de página en la parte frontal puede cubrir los elementos que están detrás de él.

Representación JSON
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Campos
pageElementObjectIds[]

string

Los IDs de los objetos de los elementos de la página que se actualizarán.

Todos los elementos de la página deben estar en la misma página y no deben estar agrupados.

operation

enum (ZOrderOperation)

Es la operación de orden en Z que se aplicará a los elementos de la página.

Cuando se aplica la operación a varios elementos de página, se mantienen los órdenes en Z relativos dentro de estos elementos de página antes de la operación.

ZOrderOperation

Es la operación para actualizar el orden en Z de un elemento de página.

Enumeraciones
Z_ORDER_OPERATION_UNSPECIFIED Operación no especificada.
BRING_TO_FRONT Coloca los elementos de la página en la parte frontal.
BRING_FORWARD Avanza los elementos de la página en uno en relación con el más avanzado de los elementos de página especificados.
SEND_BACKWARD Envía los elementos de la página hacia atrás en la página por un elemento en relación con el más alejado en los elementos de página especificados.
SEND_TO_BACK Envía los elementos de la página al reverso.

UpdateLineCategoryRequest

Actualiza la categoría de un line.

Representación JSON
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Campos
objectId

string

Es el ID del objeto a la línea a la que se aplica la actualización.

Solo se puede actualizar una línea con un category que indique que es un “conector”.

Es posible que se cambie el recorrido de la línea después de actualizar su categoría.

lineCategory

enum (LineCategory)

La categoría de línea a la que se actualizará.

El line type exacto se determina en función de la categoría a la que se actualizará y de cómo se enruta para conectarse a otros elementos de la página.

RerouteLineRequest

Vuelve a enrutar un line de modo que esté conectado en los dos sitios de conexión más cercanos en los elementos de página conectados.

Representación JSON
{
  "objectId": string
}
Campos
objectId

string

Es el ID del objeto de la línea que se desviará.

Solo se puede redireccionar una línea con un category que indique que es un “conector”. Las conexiones de inicio y finalización de la línea deben estar en diferentes elementos de la página.