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 una de las siguientes opciones:
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 de texto especificado.

deleteObject

object (DeleteObjectRequest)

Borra una página o un elemento de 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 texto de una forma o de una celda de una tabla.

createImage

object (CreateImageRequest)

Crea una imagen.

createVideo

object (CreateVideoRequest)

Crea un video.

createSheetsChart

object (CreateSheetsChartRequest)

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

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 elemento Shape

updateImageProperties

object (UpdateImagePropertiesRequest)

Actualiza las propiedades de un Image

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Actualiza las propiedades de un elemento 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 de un 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 un elemento Table fila.

mergeTableCells

object (MergeTableCellsRequest)

Combina las celdas en una Table

unmergeTableCells

object (UnmergeTableCellsRequest)

Separa las celdas en una 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)

Redirige un line de modo que esté conectada en los dos sitios de conexión más cercanos a 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

Es 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 ser esos, así como un guion o dos puntos (coincide con la regex) [a-zA-Z0-9_-:]). El ID debe tener entre 5 y 50 caracteres, inclusive.

Si no especificas un ID, se genera uno único.

insertionIndex

integer

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)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Una lista opcional de asignaciones de ID de objeto del placeholder (s) en el diseño a los marcadores de posición que se crean en la diapositiva a partir del diseño especificado. Solo se puede usar cuando slideLayoutReference cuando se especifica un valor.

LayoutReference

Referencia de diseño de 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 una de las siguientes opciones:
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 que se usó. 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 una leyenda en la parte inferior.
TITLE Diseño con título y subtítulo.
TITLE_AND_BODY Diseño con título y 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

Es la asignación de ID especificada por el usuario para un marcador de posición que se creará en una diapositiva 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 ser esos, así como un guion o dos puntos (coincide con la regex) [a-zA-Z0-9_-:]). La longitud del ID no debe ser menor que 5 ni mayor que 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 una de las siguientes opciones:
layoutPlaceholder

object (Placeholder)

El marcador de posición en un diseño que se aplicará a una diapositiva. Solo type y index los componentes necesarios. 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

Es 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 ser esos, así como un guion o dos puntos (coincide con la regex) [a-zA-Z0-9_-:]). La longitud del ID no debe ser menor que 5 ni mayor que 50. Si está vacío, se generará un identificador único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento de la forma.

shapeType

enum (Type)

Es el tipo de forma.

PageElementProperties

Propiedades comunes de un elemento de página.

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

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)

El tamaño del elemento.

transform

object (AffineTransform)

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

Es 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 las páginas 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, se ajustará automáticamente el tamaño de la tabla.

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 de la tabla.

InsertTextRequest

Inserta texto en una forma o en una celda de tabla.

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

string

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

cellLocation

object (TableCellLocation)

La ubicación opcional de la celda de la tabla en caso de que el texto se inserte en una celda. 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 línea nueva, se crea implícitamente un nuevo carácter ParagraphMarker en ese índice. El estilo de párrafo del nuevo párrafo se copiará del párrafo en el índice de inserción actual, incluidas las listas y las viñetas.

Los estilos de texto del texto insertado se determinarán automáticamente y, por lo general, conservarán el estilo del texto cercano. 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

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

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

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 encima (o debajo) de la fila donde se encuentra la celda de referencia. Si la celda de referencia es una celda combinada, se insertará una fila nueva encima (o debajo) de la celda combinada.

insertBelow

boolean

Establece 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. Se permite un máximo de 20 por solicitud.

InsertTableColumnsRequest

Inserta columnas en una tabla.

Se cambiará el tamaño de otras columnas de la tabla para que se ajusten a la columna nueva.

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)

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 a la 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 a la derecha) de la celda combinada.

insertRight

boolean

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

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

integer

Número 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)

La ubicación de la celda de la tabla de referencia de 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 quedan filas en la tabla después de esta eliminación, se borra 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)

La ubicación de la celda de la tabla de referencia de 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 quedan columnas en la tabla después de esta eliminación, se borra 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 que coincide.

pageObjectIds[]

string

Si no está vacío, limita las coincidencias a los elementos de página únicamente 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 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 una de las siguientes opciones:
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
}
Campos
text

string

El texto que se debe buscar en la forma o en 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.

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 de 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 para PageElement.transform para obtener más información.

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

string

Es el ID de 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)

El modo de aplicación de la actualización de la transformación.

ApplyMode

Los modos de aplicación de la actualización de la 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

Son 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 de TextElement.

Siempre hay un carácter de línea nueva implícito al final del texto de una celda de una tabla o una forma que no se puede eliminar. Range.Type.ALL usará los límites correctos, pero se debe tener cuidado cuando se especifican 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 fusionan los dos párrafos.

Los rangos que incluyen solo una unidad de código de un par subrogado 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

Es el índice opcional basado en cero del comienzo de la colección. Necesario para FIXED_RANGE y FROM_START_INDEX o rangos.

endIndex

integer

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

type

enum (Type)

Es el tipo de rango.

Tipo

Los tipos de rangos.

Enumeraciones
RANGE_TYPE_UNSPECIFIED Tipo de rango no especificado. No se debe usar este valor.
FIXED_RANGE Es un rango fijo. Tanto el startIndex y endIndex debe especificarse.
FROM_START_INDEX Inicia el rango en startIndex y continúa hasta el final de la colección. El endIndex no debe especificarse.
ALL Establece el rango como la longitud completa de la colección. Tanto el startIndex y las endIndex no debe especificarse.

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

Es 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 las páginas 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 de la imagen.

Cuando la relación de aspecto del tamaño proporcionado no coincide con la de la imagen, esta se ajusta y se centra con respecto al 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 usará el 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 la imagen. image_source solo puede ser una de las siguientes opciones:
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 dentro de 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 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 de 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

Es 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 las páginas 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.

El 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 videos 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 incorporado de Hojas de cálculo de Google.

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 las páginas 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 con respecto al 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 Accede a archivos compartidos por vínculos mediante 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 está vinculada.

LinkingMode

Es el modo con el que se vincula el gráfico 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 una 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

Es 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 las páginas 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 línea.

lineCategory
(deprecated)

enum (Category)

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 un category y un lineCategory, el category tiene 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 un category y un lineCategory, el category tiene prioridad.

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

Si no especificas ninguno, se usa STRAIGHT.

Categoría

Las categorías de línea

Enumeraciones
STRAIGHT Conectores rectos, incluido el conector recto 1. 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 de Hojas de cálculo de Google incorporado 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

El ID de 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 la 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. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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 deja el campo sin definir.

UpdateImagePropertiesRequest

Actualizar las propiedades de un Image

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

string

El ID de objeto de la imagen 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. La raíz imageProperties está implícita y no debe especificarse. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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

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

UpdateVideoPropertiesRequest

Actualizar 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. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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

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

UpdatePagePropertiesRequest

Actualiza las propiedades de un elemento Page

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

string

Es el ID de 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 atajo para enumerar todos los campos.

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

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.

UpdateTableCellPropertiesRequest

Actualiza las propiedades de un TableCell.

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

string

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. La raíz tableCellProperties está implícita y no debe especificarse. Se puede usar un solo "*" como atajo 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 a "tableCellBackgroundFill.solidFill.color"

Para restablecer una propiedad a su valor predeterminado, incluye el nombre de su 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

El ID de objeto de 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. La raíz lineProperties está implícita y no debe especificarse. Se puede usar un solo "*" como atajo para enumerar todos los campos.

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

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.

CreateParagraphBulletsRequest

Crea viñetas para todos los párrafos que se superponen con el rango de índice de texto dado.

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)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

Los tipos de glifos de viñetas que se usarán. La configuración predeterminada es el BULLET_DISC_CIRCLE_SQUARE ajuste predeterminado.

BulletGlyphPreset

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

Estos patrones usan los siguientes 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 : Cuadrado hueco, 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 : 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 : Un asterisco, 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 prefijo de cero, como “01”, “02” o “03”. Los números con más de un dígito no tienen el prefijo cero.
  • ROMAN : Un número romano en minúscula, 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 DIAMONDX, ARROW3D y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 ARROW, DIAMOND y DISC glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 LEFTTRIANGLE, DIAMOND y DISC glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 DIGIT, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento de listas, 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 DIGIT glifos numéricos separados por puntos, en los que cada nivel de anidamiento usa el glifo del nivel de anidamiento anterior como prefijo Por ejemplo: "1.", '1.1.', '2.', '2.2.'
NUMBERED_UPPERALPHA_ALPHA_ROMAN Una lista numerada con UPPERALPHA, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento de listas, 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 coinciden con los criterios dados por la imagen proporcionada.

Las imágenes que reemplazan las formas son rectangulares después de insertarse en la presentación y no adoptan las formas 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)

Es el método de reemplazo.

Obsoleto : Usa imageReplaceMethod en su lugar.

Si especificas un replaceMethod y un imageReplaceMethod, el imageReplaceMethod tiene prioridad.

imageReplaceMethod

enum (ImageReplaceMethod)

El método de reemplazo de imagen.

Si especificas un replaceMethod y un imageReplaceMethod, el imageReplaceMethod tiene prioridad.

Si no especificas un valor para imageReplaceMethod, pero especifica un valor para replaceMethod y, luego, el valor especificado replaceMethod de ese valor.

Si no especificas ninguno, se usa CENTER_INSIDE.

pageObjectIds[]

string

Si no está vacío, limita las coincidencias a los elementos de página únicamente 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. Los criterios con los que deben coincidir las formas para que se puedan reemplazar. criteria solo puede ser una de las siguientes opciones:
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 la imagen. image_source solo puede ser una de las siguientes opciones:
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 dentro de 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 en sí se guarda con la imagen y se expone a través del Image.source_url .

ReplaceMethod

Es el método de reemplazo.

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. El tamaño renderizado de la imagen puede ser 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 llenar la forma. El tamaño renderizado de la imagen será el mismo que el de la forma original.

ImageReplaceMethod

El método de reemplazo de imagen.

Enumeraciones
IMAGE_REPLACE_METHOD_UNSPECIFIED Método de reemplazo de imagen no especificado. 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. El tamaño renderizado de la imagen puede ser menor que el tamaño de la forma. Este es el método predeterminado cuando no se especifica uno.
CENTER_CROP Ajusta la escala y centra la imagen para llenar los límites de la forma original. Es posible que la imagen se recorte para llenar la forma. El tamaño renderizado de la imagen será el mismo que el de la forma original.

DuplicateObjectRequest

Duplica una diapositiva o un elemento de página.

Cuando se duplica una diapositiva, esta se crea inmediatamente después de la diapositiva especificada. Cuando se duplica un elemento de página, el duplicado se colocará en la misma página, 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 ser esos, así como un guion o dos puntos (coincide con la regex) [a-zA-Z0-9_-:]). La longitud del nuevo ID no debe ser menor que 5 ni mayor que 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á configurado, todos los objetos duplicados recibirán un nuevo ID aleatorio.

UpdateTextStyleRequest

Actualizar el estilo del texto de una 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 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.

Ciertos cambios en el estilo de texto pueden provocar otros cambios destinados a 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á 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 atajo para enumerar todos los campos.

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

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.

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 escalará y se centrará para adaptarse 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)

Los criterios con los que deben coincidir las formas para que se puedan reemplazar. 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

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

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 se vincula el gráfico 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 una 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

El ID de objeto de la forma o la tabla que contiene el texto del que se borrarán 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 estilo de todos los párrafos de una Shape o Table que se superponen con el rango de índice de texto dado.

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

string

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

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 se refiere a una tabla, cellLocation debe tener un valor. De lo contrario, no debe hacerlo.

style

object (ParagraphStyle)

El estilo del párrafo.

textRange

object (Range)

El rango de texto que contiene los párrafos a los que se les aplicará 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. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluye el nombre de su 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

El ID del objeto de la tabla.

tableRange

object (TableRange)

El rango de la tabla que representa el subconjunto de la tabla a la que se aplican las actualizaciones. Si no se especifica un rango de la tabla, 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. La raíz tableBorderProperties está implícita y no debe especificarse. Se puede usar un solo "*" como atajo para enumerar todos los campos.

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

Para restablecer una propiedad a su valor predeterminado, incluye el nombre de su 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 en el interior del rango
INNER_HORIZONTAL Bordes horizontales dentro del rango.
INNER_VERTICAL Bordes verticales en el interior 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 un elemento Table .

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

string

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 si la solicitud es inferior a 406,400 EMU (32 puntos), se devuelve un error 400 de solicitud incorrecta.

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. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

Por ejemplo, para actualizar el ancho de columna, establece fields a "columnWidth"

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

UpdateTableRowPropertiesRequest

Actualiza las propiedades de una fila Table.

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

string

El ID del objeto de la tabla.

rowIndices[]

integer

Es la lista de índices basados en cero que especifica 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. La raíz tableRowProperties está implícita y no debe especificarse. Se puede usar un solo "*" como atajo para enumerar todos los campos.

Por ejemplo, para actualizar la altura mínima de la fila, establece fields a "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 las celdas en una Table

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

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

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 que el rango abarca celdas que ya están combinadas), se muestra un error 400 de solicitud incorrecta.

UnmergeTableCellsRequest

Separa las celdas en una Table

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

string

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 ("encabezado") del bloque resultante de celdas separadas.

GroupObjectsRequest

Agrupa objetos para crear un grupo de objetos. Por ejemplo, los grupos 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

Es 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 las páginas 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 genera 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. Algunos elementos de la página, videos, tables y placeholders no se pueden agrupar.

UngroupObjectsRequest

Desagrupa objetos, como groups.

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

string

Los IDs de los objetos que se desagrupará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 borrará 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

El ID de objeto del elemento de página al que se aplican las actualizaciones.

title

string

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

description

string

Es la descripción de texto alternativo actualizada del elemento de página. Si no la estableces, se mantendrá el valor existente. La descripción se expone a lectores de pantalla y 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.

Cuando se reemplaza una imagen, se quitan algunas image effects a partir 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

El ID de la imagen existente que se reemplazará. El ID se puede recuperar a partir 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 una de las siguientes opciones:
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 dentro de 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. La URL se guarda con la imagen y se expone a través de Image.source_url .

UpdateSlidePropertiesRequest

Actualiza las propiedades de una diapositiva.

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

string

El ID de objeto de la diapositiva 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 atajo para enumerar todos los campos.

Por ejemplo, para indicar que se debe omitir una diapositiva, establece fields a "isSkipped"

Para restablecer una propiedad a su valor predeterminado, incluye el nombre de su 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 que se encuentra al principio puede cubrir los elementos que están detrás.

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

string

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

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

operation

enum (ZOrderOperation)

Es la operación de orden en Z que se aplica a los elementos de 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 un elemento 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

El ID de objeto de 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 nombre exacto line type se determina en función de la categoría a la que se debe actualizar y cómo se enruta para conectarse a otros elementos de la página.

RerouteLineRequest

Redirige un line de modo que esté conectada en los dos sitios de conexión más cercanos a 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 indica que es un “conector”. Las conexiones de inicio y finalización de la línea deben estar en diferentes elementos de la página.