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 celda de forma o 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 elemento Page

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Actualiza las propiedades de un elemento TableCell

updateLineProperties

object (UpdateLinePropertiesRequest)

Actualiza las propiedades de un elemento 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 las viñetas de los párrafos.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Actualiza el estilo de los párrafos de una Shape o Table

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Actualiza las propiedades de los bordes de la tabla de una Table

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Actualiza las propiedades de un elemento 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 de texto alternativo o la descripción 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 crea al final.

slideLayoutReference

object (LayoutReference)

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

  • El patrón del índice de diapositivas anterior.
  • El patrón de la primera diapositiva, si insertIndex es cero.
  • El primer 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 una regla de firewall.

LayoutReference

Referencia de diseño de diapositiva. Esto 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

Layout ID: ID de objeto de uno de los diseños de la presentación.

PredefinedLayout

Tipos de diseño predefinidos. Estos diseños se encuentran comúnmente en las presentaciones. Sin embargo, no hay garantía de que estos diseños estén presentes en el diseño maestro actual, ya que podrían haberse borrado o no formar 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 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

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 genera uno único.

Campo de unión kind Es el tipo que se usa 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, una configuración TITLE_AND_BODY el diseño generalmente puede tener un marcador de posición TITLE con el índice 0 y un marcador de posición BODY con el índice 0.

layoutPlaceholderObjectId

string

El ID de 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)

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 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 genera uno único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento de la tabla.

La tabla se creará con el tamaño proporcionado, sujeta 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 tabla deben tener una escala de 1 y no deben tener componentes de distorsión. 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

Texto que se va a 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 agrega al TextRun que existe en el índice de inserción.

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) se quitarán del texto insertado.

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 inicio de la cadena. El índice se puede ajustar para evitar inserciones dentro de clústeres de grafema Unicode. En estos casos, el texto se insertará inmediatamente después del clúster de grafema.

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)

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 : insertar debajo de la celda.
  • False : insertar encima de la celda.
number

integer

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

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 nueva columna a la izquierda (o derecha) de la columna donde 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

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. Se permite un 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 coinciden 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

El texto que reemplazará el texto coincidente.

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 400 de solicitud incorrecta si se proporciona el ID de objeto de página de una notes master o si una página con ese ID de objeto no existe en la presentación.

Campo de unión criteria Los criterios utilizados 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

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 las 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

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

Si, luego de una operación de eliminación, group contiene solo 1 elemento de página o ningún elemento, el grupo también se elimina.

Si se borra un marcador de posición de un diseño, también se borra cualquier marcador de posición heredado vacío.

UpdatePageElementTransformRequest

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

Si actualizas la transformación de un grupo, se modificará la transformación absoluta de los elementos de página de 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

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 reemplaza la existente por 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

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

DeleteTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

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 al especificar 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 los límites de un párrafo, es posible que se produzcan cambios en las listas y los estilos de párrafo cuando se combinan 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 los caracteres de un 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. Necesaria para FIXED_RANGE y FROM_START_INDEX o rangos.

endIndex

integer

Es el índice opcional basado en cero del final de la colección. Necesaria 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 Un rango fijo. Tanto el startIndex y endIndex debe especificarse.
FROM_START_INDEX Inicia el rango a las startIndex y continúa hasta el final de la colección. El endIndex no debe especificarse.
ALL Configura el rango para que sea la longitud total 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 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 genera 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.

El PageElementProperties.size es opcional. Si no especificas el tamaño, se usará el predeterminado de la imagen.

El 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 no debe superar los 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 para 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 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 genera uno único.

elementProperties

object (PageElementProperties)

Las propiedades del elemento del video.

El 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 distorsión. 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 para un subconjunto de archivos antiguos. Para obtener más información, consulta Accede a archivos compartidos por vínculos mediante claves de recursos.

CreateSheetsChartRequest

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

NOTA: Para crear gráficos, se necesita al menos uno de los permisos de documentos de Hojas de cálculo, Hojas de cálculo, Drive.readonly, drive.file o Drive.

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

string

Es 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 el carácter de una palabra [a-zA-Z0-9_], seguido de cualquier cantidad de los siguientes caracteres [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)

Son las propiedades del elemento del 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

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

linkingMode

enum (LinkingMode)

Es el modo con el que se vincula el gráfico 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 otros 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 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 genera 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 : utilizar category en su lugar.

El nombre exacto line type se crea en función de la categoría y la forma en que 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)

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

El nombre exacto line type se crea en función de la categoría y la forma en que 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 especifica un valor para lineCategory y, luego, el valor especificado lineCategory de ese valor.

Si no especificas ninguna de estas opciones, STRAIGHT y control sobre el uso de sus datos.

Categoría

Son las categorías de líneas.

Enumeraciones
STRAIGHT Conectores rectos, incluido el conector recto 1. Es la categoría predeterminada cuando no se especifica una.
BENT Conectores doblados, incluido el conector doblado 2 a 5.
CURVED Conectores curvos, incluido el conector curvo 2 a 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 gráficos, se necesita al menos uno de los permisos de Sheets.readonly, Spreadsheets, drive.readonly o Drive de OAuth.

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

string

El ID de objeto del gráfico que se actualizará.

UpdateShapePropertiesRequest

Actualizar las propiedades de un Shape

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

string

El ID de objeto de la forma 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. La raíz shapeProperties está implícita y no debe especificarse. 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 a "shapeBackgroundFill.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.

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

El ID de objeto del video al que se aplican las actualizaciones.

videoProperties

object (VideoProperties)

Las propiedades del video que se actualizarán.

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. La raíz videoProperties 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 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

El ID de objeto de la página a la que se aplica la actualización.

pageProperties

object (PageProperties)

Son 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. La raíz pageProperties está implícita y no debe especificarse. 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 página, establece fields a "pageBackgroundFill.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.

UpdateTableCellPropertiesRequest

Actualizar 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)

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.

tableCellProperties

object (TableCellProperties)

Las propiedades de celda 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. 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 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

El rango de una 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 necesariamente forman un rectángulo. Por ejemplo, digamos que tenemos una tabla de 3 x 3 en la que todas las celdas de la última fila están fusionadas. La tabla tiene el siguiente aspecto:

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

En un rango de tabla con ubicación = (0, 0), intervalo de filas = 3 y intervalo de columnas = 2, se especifican las siguientes celdas:

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

object (TableCellLocation)

La ubicación inicial del rango de la tabla.

rowSpan

integer

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

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

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 el nombre de su 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 dado.

El nivel de anidamiento de cada párrafo se determinará mediante el recuento de las pestañas iniciales delante de cada párrafo. Para evitar el exceso de espacio entre la viñeta y el párrafo correspondiente, esta solicitud quita las pestañas iniciales. Esto puede cambiar los índices de partes del texto.

Si el párrafo que se encuentra justo antes de que se actualicen está en una lista con un ajuste predeterminado correspondiente, los párrafos que se actualizan se agregan a la lista anterior.

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

string

El ID de objeto de la forma o tabla que contiene el texto al que se agregan las 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 : Flecha con sombreado 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 Unicode U+2756
  • HOLLOWDIAMOND : 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 : Un número, como “1”, “2” o “3”.
  • ZERODIGIT : Número en el que los números de un solo dígito tienen el 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 DISC, CIRCLE y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 CHECKBOX glifos de viñetas para todos los niveles de anidamiento 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 STAR, CIRCLE y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
BULLET_ARROW3D_CIRCLE_SQUARE Una lista con viñetas con un ARROW3D, CIRCLE y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 DIAMONDX, HOLLOWDIAMOND y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
BULLET_DIAMOND_CIRCLE_SQUARE Una lista con viñetas con un DIAMOND, CIRCLE y SQUARE glifo de viñetas para los primeros 3 niveles de anidación de listas.
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 DIGIT, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento de listas, 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 UPPERROMAN, UPPERALPHA y DIGIT glifos numéricos para los primeros 3 niveles de anidamiento de listas, seguidos de puntos.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Una lista numerada con ZERODIGIT, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento de listas, 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 : utilizar 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 especifica ninguno, entonces se utiliza 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 400 de solicitud incorrecta si se proporciona el ID de objeto de página de una notes page o un notes master o si una página con ese ID de objeto no existe 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 dado.

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 se guarda con la imagen y se expone mediante el Image.source_url .

ReplaceMethod

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

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

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 ID de los objetos duplicados: las claves son los ID de los objetos originales, y sus valores son los ID que se asignarán al objeto duplicado correspondiente. El ID del duplicado del objeto de origen también se puede especificar en este mapa, con el mismo valor del objectId como clave y el nuevo ID deseado como valor.

Todas las claves deben corresponder a los 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 omiten ID de objetos de origen del mapa, se asignará un nuevo ID aleatorio. Si el mapa está vacío o no se establece, 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 de objeto de la forma o tabla con el texto al que se le aplicará el estilo.

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

Los estilos que se deben configurar en el texto.

Si el valor de un estilo particular coincide con el del elemento superior, se configurará ese estilo como heredado.

Algunos 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. La raíz style está implícita y no debe especificarse. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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

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.

ReplaceAllShapesWithSheetsChartRequest

Reemplaza todas las formas que coincidan con los criterios dados 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 necesita al menos uno de los permisos de templates.readonly, total de hojas de cálculo, 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 dado.

spreadsheetId

string

Es 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 se vincula el gráfico a la hoja de cálculo de origen. Si no se especifica, el gráfico será una imagen que no está vinculada.

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 400 de solicitud incorrecta si se proporciona el ID de objeto de página de una notes page o un notes master o si una página con ese ID de objeto no existe 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 otros colaboradores verán un vínculo a la hoja de cálculo.

DeleteParagraphBulletsRequest

Elimina las viñetas de todos los párrafos que se superponen con el índice de texto dado. range

El nivel de anidamiento de cada párrafo se preservará visualmente agregando sangría al comienzo 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)

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 desde el que se borrarán las viñetas, según TextElement los índices.

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)

La ubicación de la celda en la tabla que contiene los párrafos a los que se les aplicará 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. La raíz style está implícita y no debe especificarse. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

Por ejemplo, para actualizar la alineación del párrafo, establece fields a "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 de una 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 deben aplicarse 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)

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

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 en el interior del rango
INNER_VERTICAL Bordes verticales en el interior del rango
LEFT Bordes a la izquierda del rango
OUTER Bordes a lo largo del exterior 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 especifica 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. La raíz tableColumnProperties está implícita y no debe especificarse. 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 un elemento Table fila.

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

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

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

MergeTableCellsRequest

Combina 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)

El rango de la tabla que especifica qué celdas de la tabla se combinarán.

Cualquier texto en las celdas que se combinen se concatenará y se almacenará en la celda superior izquierda (“head”) 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)

El rango de la tabla que especifica qué celdas de la tabla se separarán.

Se separarán todas las celdas combinadas en este rango, pero las celdas que ya no se combinaron no se verán afectadas. Si el rango no tiene celdas combinadas, la solicitud no hará nada. Si hay texto en alguna de las celdas combinadas, este permanecerá en la celda 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 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 genera uno único.

childrenObjectIds[]

string

Los IDs de los objetos que se agruparán.

Solo se pueden agrupar los elementos de página. Debe haber al menos dos elementos de página en la misma página que no estén ya 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 groups que no están dentro de otra groups se puede desagrupar. Todos los grupos deben estar en la misma página. Se borrará el grupo. Los tamaños y las posiciones visuales de todos los elementos secundarios se conservan.

UpdatePageElementAltTextRequest

Actualiza el título de texto alternativo o la descripción 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 la estableces, 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 que estén 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 que estén 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)

Es el método de reemplazo.

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 superar los 25 megapíxeles y 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. La raíz 'slideProperties' está implícita y no debe especificarse. Un solo "*" se puede usar como abreviatura para enumerar cada campo.

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 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 mantiene el orden en Z relativo dentro de estos elementos de página antes de que se mantenga 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 Lleva los elementos de página al principio de la página.
BRING_FORWARD Mueve los elementos de página hacia adelante en la página según un elemento relativo al que está más adelante en los elementos de página especificados.
SEND_BACKWARD Envía los elementos de página hacia atrás en la página de un elemento en relación con el que se encuentra más detrás de uno en los elementos de página especificados.
SEND_TO_BACK Envía los elementos de la página al final de la página.

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 una línea con un category lo que indica que es un “conector” se pueden actualizar.

La línea se puede volver a enrutar 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

El ID de objeto de la línea que se redirigirá.

Solo una línea con un category lo que indica que es un “conector” que se puede redirigir. Las conexiones inicial y final de la línea deben estar en elementos de página diferentes.