Requests

Solicitud

Es un único tipo de actualización que se puede 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. Es el tipo de actualización. Se requiere exactamente un campo. kind puede ser solo 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 del 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 de la presentación.

deleteText

object (DeleteTextRequest)

Borra texto de una forma o una celda de la 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 Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Actualiza las propiedades de un Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Actualiza las propiedades de un Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Actualiza las propiedades de un Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Actualiza las propiedades de un TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Actualiza las propiedades de un Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Crea viñetas para los párrafos.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

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

duplicateObject

object (DuplicateObjectRequest)

Duplica una diapositiva o un elemento de la página.

updateTextStyle

object (UpdateTextStyleRequest)

Actualiza el estilo del texto de Shape o Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Reemplaza todas las formas que coinciden 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 dentro de Shape o Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

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

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Actualiza las propiedades de una columna Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Actualiza las propiedades de una fila Table.

mergeTableCells

object (MergeTableCellsRequest)

Combina celdas en un objeto Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Separa las celdas de 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 presentación

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 elemento line para que esté conectado en los dos sitios de conexión más cercanos en los elementos de página conectados.

CreateSlideRequest

Crea una diapositiva.

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

string

Un ID de objeto proporcionado por el usuario.

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

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

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

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

  • El principal del índice de diapositivas anterior.
  • Instancia principal de la primera diapositiva si el insertIndex es cero.
  • El primer diseño 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, en la diapositiva se usa el diseño predefinido BLANK.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

Referencia de diseño

Referencia del diseño de diapositivas. 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 puede ser solo una de las siguientes opciones:
predefinedLayout

enum (PredefinedLayout)

Diseño predefinido.

layoutId

string

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

Diseño predefinido

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 la instancia principal 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.

Enumeradores
PREDEFINED_LAYOUT_UNSPECIFIED Diseño sin especificar.
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 un título y un 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 subtítulo en el otro y 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.

Diseño de posición de posición de diseño

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

Representación JSON 
{
  "objectId": string,

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

string

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

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

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

Campo de unión kind. El tipo que permite identificar un marcador de posición en un diseño. kind puede ser solo una de las siguientes opciones:
layoutPlaceholder

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

Un ID de objeto proporcionado por el usuario.

Si especificas un ID, este debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la regex [a-zA-Z0-9_]). Los caracteres restantes pueden incluir un guion o dos puntos (coincide con la regex [a-zA-Z0-9_-:]). La longitud del ID no debe ser menor que 5 o 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.

Propiedades de elementos de página

Propiedades comunes para un elemento de página

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

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

string

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

size

object (Size)

El tamaño del componente.

transform

object (AffineTransform)

La transformación para el elemento.

CreateTableRequest

Crea una nueva tabla.

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

string

Un ID de objeto proporcionado por el usuario.

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

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento de la tabla.

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

Las transformaciones de tablas deben tener una escala de 1 y no tener componentes con 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 en la tabla.

InsertTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

La ubicación opcional de la celda de la tabla si el texto se debe insertar en una celda de la tabla. Si está presente, el ID del objeto debe hacer referencia a una tabla.

text

string

El texto que se insertará.

La inserción de un carácter de nueva línea creará implícitamente una ParagraphMarker nueva en ese índice. El estilo de párrafo del párrafo nuevo se copiará del párrafo del índice de inserción actual, incluidas listas y viñetas.

Los estilos de texto insertado se determinarán automáticamente y, por lo general, se preservará el estilo del texto cercano. En la mayoría de los casos, el texto se agregará al elemento TextRun que existe en el índice de inserción.

Algunos caracteres de control (U+0000-U+0008, U+000C-U+001F) y caracteres de la zona de uso privado del plano multilingüe Unicode básico (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 los índices de TextElement.

El índice se basa en cero y se calcula desde el principio de la string. Se puede ajustar el índice para evitar inserciones dentro de los clústeres de grafema de Unicode. En estos casos, el texto se insertará inmediatamente después del clúster 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 filas.

cellLocation

object (TableCellLocation)

La ubicación de celda de la tabla de referencia desde la que se insertarán las filas.

Se insertará una fila nueva arriba (o debajo) de la fila en la que se encuentra la celda de referencia. Si la celda de referencia es una celda combinada, se insertará una fila nueva arriba (o debajo) de la celda combinada.

insertBelow

boolean

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

  • True : Inserte debajo de la celda.
  • False: Inserte arriba de la celda.
number

integer

La cantidad de filas que se insertarán. Se permite un máximo de 20 por solicitud.

InsertarTablaColumnasRequest

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 celda de la tabla de referencia desde la que se insertarán las columnas.

Se insertará una columna nueva a la izquierda (o derecha) 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

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

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

integer

La cantidad 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 celda de la tabla de referencia de la que se borrará una fila.

Se borrará la fila que abarca esta celda. Si esta es 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 celda de la tabla de referencia de la que se borrará una columna.

Se borrará la columna que abarca esta celda. Si esta es 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.

ReemplazarAllRequestRequest

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

El texto que reemplazará al texto coincidente.

pageObjectIds[]

string

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

Muestra un error 400 de solicitud incorrecta si se proporciona el ID de objeto de página de una 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 que se usan para hacer coincidir el texto que se reemplazará. criteria puede ser solo una de las siguientes opciones:
containsText

object (SubstringMatchCriteria)

Busca texto en una forma que coincida con esta substring.

SubstringMatchCriterios

Criterio que coincide con una string de texto específica de una forma o tabla.

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

string

El texto que se debe buscar en la forma o la tabla.

matchCase

boolean

Indica si la búsqueda debe respetar el uso de 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 de objeto de la página o del elemento de la página que se borrará.

Si, después de una operación de eliminación, un objeto group contiene solo 1 o ningún elemento de la página, 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 heredados heredados.

UpdatePageElementTransformRequest

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

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

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

string

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

transform

object (AffineTransform)

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

applyMode

enum (ApplyMode)

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

Modo de aplicación

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

Enumeradores
APPLY_MODE_UNSPECIFIED Modo no especificado.
RELATIVE Aplica la nueva matriz de AffineTransform a la existente y reemplaza la existente con la concatenación resultante.
ABSOLUTE Reemplaza la matriz de AffineTransform existente por la nueva.

UpdateSlidesPositionRequest

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

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

string

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

insertionIndex

integer

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

DeleteTextRequest

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

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

string

El 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 si el texto se debe borrar de una celda de la tabla. Si está presente, el ID del objeto debe hacer referencia a una tabla.

textRange

object (Range)

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 forma o de celda de tabla que no se puede borrar. Range.Type.ALL usará los límites correctos, pero se deben tener cuidado cuando se especifiquen límites explícitos para los tipos de rango FROM_START_INDEX y FIXED_RANGE. Por ejemplo, si el texto es "ABC", seguido de una nueva línea 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, podrían producirse cambios en los estilos y las listas de los párrafos, a medida que se combinen los dos.

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 a un grupo indexado, 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. Obligatorio para los rangos FIXED_RANGE y FROM_START_INDEX.

endIndex

integer

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

type

enum (Type)

Es el tipo de rango.

Tipo

Los tipos de rangos.

Enumeradores
RANGE_TYPE_UNSPECIFIED Tipo de rango sin especificar. No se debe usar este valor.
FIXED_RANGE Rango fijo Se deben especificar startIndex y endIndex.
FROM_START_INDEX Inicia el rango a las startIndex y continúa hasta el final de la colección. No se debe especificar el endIndex.
ALL Establece el rango como la longitud completa de la colección. No se deben especificar startIndex ni endIndex.

CreateImageRequest

Crea una imagen.

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

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

string

Un ID de objeto proporcionado por el usuario.

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

Si no especifica 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 relación de aspecto 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 usa el tamaño predeterminado de la imagen.

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

Campo de unión image_source. Es el tipo de fuente de imagen. image_source puede ser solo 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 mostrar 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 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 del campo Image.source_url.

CreateVideoRequest

Crea un video.

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

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

string

Un ID de objeto proporcionado por el usuario.

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

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento del video.

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

La propiedad 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)

La fuente del video.

id

string

Es el identificador único de la fuente de video correspondiente a este video.

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

Para acceder a un archivo de video de Google Drive, es posible que deba agregar una clave de recurso al encabezado HTTP de un subconjunto de archivos antiguos. Para obtener más información, consulta Accede a archivos compartidos mediante 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 siguientes tipos: hojas de cálculo.readonly, 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

Un ID de objeto proporcionado por el usuario.

Si se especifica, el ID debe ser único entre todas las páginas y los elementos de página de la presentación. El ID debe comenzar con una palabra [a-zA-Z0-9_] y, a continuación, una cantidad cualquiera de los siguientes caracteres [a-zA-Z0-9_-:]. La longitud del ID no debe ser inferior a 5 o superior a 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, se escala y centra el gráfico 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 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 mediante vínculos mediante claves de recursos.

chartId

integer

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

linkingMode

enum (LinkingMode)

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.

Modo de vinculación

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

Enumeradores
NOT_LINKED_IMAGE El gráfico no está asociado a 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

Un ID de objeto proporcionado por el usuario.

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

Si no especifica 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 se determina según la categoría y la forma en que se enruta para conectarse a otros elementos de página.

Si especificas category y lineCategory, category tiene prioridad.

category

enum (LineCategory)

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

El line type exacto se determina según la categoría y la forma en que se enruta para conectarse a otros elementos de página.

Si especificas category y lineCategory, category tiene prioridad.

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

Si no especificas ninguno de ellos, se usa STRAIGHT.

Categoría

Son las categorías de línea.

Enumeradores
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 de 2 a 5.
CURVED Conectores curvos, incluidos los conectores curvos de 2 a 5.

Solicitud de actualización de ChartsChart

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

NOTA: Para actualizar gráficos, se necesita al menos uno de los permisos de hojas de cálculo.readonly, hojas de cálculo, 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

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 se debe especificar. Se puede usar una sola "*" como versión abreviada 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, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

UpdateImagePropertiesRequest

Actualiza 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

UpdateVideoPropertiesRequest

Actualiza las propiedades de un Video.

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

string

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

videoProperties

object (VideoProperties)

Son 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. La raíz videoProperties está implícita y no se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

UpdatePagePropertiesRequest

Actualiza las propiedades de un 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

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 de 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 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

Rango de la tabla

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 necesariamente forman un rectángulo. Por ejemplo, supongamos que tenemos una tabla de 3 x 3 en la que se combinan todas las celdas de la última fila. La tabla se ve de la siguiente manera: 

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

Un rango de tabla con ubicación = (0, 0), rango de fila = 3 y rango de columna = 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)

La ubicación inicial del rango de tablas.

rowSpan

integer

El intervalo de filas del rango de tablas

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)

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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

Solicitud CreateBugraphBullets

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

Para determinar el nivel de anidamiento de cada párrafo, se contarán las pestañas iniciales que estén delante de cada uno. Para evitar el exceso de espacio entre la viñeta y el párrafo correspondiente, se quitan estas pestañas principales de esta solicitud. Esto puede cambiar los índices de las partes del texto.

Si el párrafo inmediatamente anterior a los párrafos que se actualizan está en una lista con un ajuste predeterminado coincidente, los párrafos que se actualizan se agregan a esa lista.

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 le agregarán las viñetas.

cellLocation

object (TableCellLocation)

La ubicación opcional de la celda de la tabla si el texto que se modifica está en una celda de la tabla. Si está presente, el ID del objeto debe hacer referencia a una tabla.

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

Ajuste predeterminado de viñetas de viñetas

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

Estos patrones usan estos tipos de viñetas:

  • ARROW : Una flecha, que corresponde a un punto de código Unicode U+2794
  • ARROW3D : Una flecha con sombreado 3D, que corresponde a un punto de código Unicode U+27a2
  • CHECKBOX: Un cuadrado vacío, que corresponde a un punto de código U+274f de Unicode
  • CIRCLE: Un círculo hueco, que corresponde a un punto de código U+25cb de Unicode
  • DIAMOND: Un diamante sólido, que corresponde a un punto de código Unicode U+25c6.
  • DIAMONDX: Un diamante con una “x”, que corresponde a un punto de código Unicode U+2756
  • HOLLOWDIAMOND: Un diamante vacío, que corresponde a un punto de código U+25c7 de Unicode.
  • DISC: Un círculo sólido que corresponde a un punto de código U+25cf de Unicode
  • SQUARE: Es un cuadrado sólido, que corresponde a un punto de código Unicode U+25a0.
  • STAR: Una estrella, que corresponde a un punto de código Unicode U+2605
  • ALPHA Una letra minúscula, como “a”, “b” o “c”.
  • UPPERALPHA : Una letra mayúscula, como "A", "B" o "C".
  • DIGIT: Un número, como "1", "2" o "3".
  • ZERODIGIT: Un número en el que los números de un solo dígito tienen el prefijo cero, como “01”, “02” o “03”. Los números que tengan más de un dígito no tendrán 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 U+25c4 de Unicode
Enumeradores
BULLET_DISC_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta de DISC, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de listas.
BULLET_DIAMONDX_ARROW3D_SQUARE Una lista con viñetas con un glifo de viñeta de DIAMONDX, ARROW3D y SQUARE para los primeros 3 niveles de anidamiento de listas.
BULLET_CHECKBOX Una lista con viñetas con CHECKBOX glifos de viñetas para todos los niveles de anidación de la lista.
BULLET_ARROW_DIAMOND_DISC Una lista con viñetas con un glifo de viñeta de ARROW, DIAMOND y DISC para los primeros 3 niveles de anidamiento de listas.
BULLET_STAR_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta de STAR, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de listas.
BULLET_ARROW3D_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta de ARROW3D, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de listas.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Una lista con viñetas con un glifo de viñeta de LEFTTRIANGLE, DIAMOND y DISC para los primeros 3 niveles de anidamiento de listas.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Una lista con viñetas con un glifo de viñeta de DIAMONDX, HOLLOWDIAMOND y SQUARE para los primeros 3 niveles de anidamiento de listas.
BULLET_DIAMOND_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta de DIAMOND, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de listas.
NUMBERED_DIGIT_ALPHA_ROMAN Una lista numerada con DIGIT, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento, 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, seguidos de paréntesis.
NUMBERED_DIGIT_NESTED Una lista numerada con glifos numéricos DIGIT separados por puntos, en la 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, 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, 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, seguidos de puntos.

ReemplazarTodasLasFormasConImagenDeSolicitud

Reemplaza todas las formas que coincidan con los criterios especificados 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)

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)

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 especificas un valor para replaceMethod, se usa el valor de replaceMethod especificado.

Si no especificas ninguno de ellos, entonces se usa CENTER_INSIDE.

pageObjectIds[]

string

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

Muestra un error 400 de solicitud incorrecta si se proporciona el ID de objeto de página de una notes page o una 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 reemplacen. criteria puede ser solo 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 imagen. image_source puede ser solo 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 mostrar 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 estar en formato PNG, JPEG o GIF.

La URL proporcionada puede tener un máximo de 2 KB. La URL en sí se guarda con la imagen y se expone a través del campo Image.source_url.

Método de reemplazo

El método de reemplazo.

Enumeradores
CENTER_INSIDE Ajusta y centra la imagen para que se ajuste a los límites de la forma original y mantiene su relación de aspecto. El tamaño renderizado de la imagen puede ser más pequeño que el tamaño de la forma. Este es el método predeterminado cuando no se especifica uno.
CENTER_CROP Ajusta y centra la imagen para completar los límites de la forma original. Es posible que la imagen se recorte para completar la forma. El tamaño renderizado de la imagen será el mismo que el de la forma original.

Método de imagen de reemplazo

Método de reemplazo de imagen.

Enumeradores
IMAGE_REPLACE_METHOD_UNSPECIFIED Método de reemplazo de imagen no especificado. No se debe usar este valor.
CENTER_INSIDE Ajusta y centra la imagen para que se ajuste a los límites de la forma original y mantiene su relación de aspecto. El tamaño renderizado de la imagen puede ser más pequeño que el tamaño de la forma. Este es el método predeterminado cuando no se especifica uno.
CENTER_CROP Ajusta y centra la imagen para completar los límites de la forma original. Es posible que la imagen se recorte para completar la forma. El tamaño renderizado de la imagen será el mismo que el de la forma original.

Solicitud de objeto duplicado

Duplica una diapositiva o un elemento de la página.

Cuando duplicas una diapositiva, la diapositiva duplicada 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 campo objectId como clave y el ID deseado nuevo como valor.

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

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

UpdateTextStyleRequest

Actualiza el estilo del texto de un Shape o Table.

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

string

El ID 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 de la tabla que contiene el texto al que se aplica el estilo. Si objectId hace referencia 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 en particular coincide con el del estilo superior, se configurará ese estilo para heredarlo.

Ciertos cambios en el estilo del 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)

El rango de texto al estilo.

El rango se puede extender para incluir saltos de línea adyacentes.

Si el rango contiene completamente 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

ReemplazarAllShapesWithSheetsChartRequest

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

NOTA: Para reemplazar formas con un gráfico se necesita al menos uno de los tipos de hojas de cálculo.readonly, 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 reemplacen. La solicitud reemplazará todas las formas que contengan el texto dado.

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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.

pageObjectIds[]

string

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

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

Modo de vinculación

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

Enumeradores
NOT_LINKED_IMAGE El gráfico no está asociado a 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 las viñetas de todos los párrafos que se superponen con el índice de texto range.

El nivel de anidamiento de cada párrafo se conservará 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 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 modifica está en una celda de la tabla. Si está presente, el ID del objeto debe hacer referencia a una tabla.

textRange

object (Range)

Rango de texto del que se borrarán las viñetas, según los índices TextElement.

UpdateParagraphStyleRequest

Actualiza el estilo de todos los párrafos dentro de 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 de la tabla que contiene los párrafos a los que se les aplicará estilo. Si objectId hace referencia 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)

Rango de texto que contiene los párrafos a los que se les va a aplicar el 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 se debe especificar. Se puede usar una sola "*" como versión abreviada 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, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

UpdateTableBorderPropertiesRequest

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

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

string

El ID de 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 tabla, las actualizaciones se aplicarán a toda la tabla.

borderPosition

enum (BorderPosition)

La posición de borde del rango de tablas a la 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 tabla.

tableBorderProperties

object (TableBorderProperties)

Las propiedades de borde de 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

Posición del borde

Es la posición del borde de la tabla.

Enumeradores
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 en el exterior del rango
RIGHT Bordes a la derecha del rango
TOP Bordes en la parte superior del rango

UpdateTableColumnPropertiesRequest

Actualiza las propiedades de una columna Table.

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

string

El ID de objeto de la tabla.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

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

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

fields

string (FieldMask format)

Los campos que se deben actualizar.

Se debe especificar al menos un campo. La raíz tableColumnProperties está implícita y no se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Si se incluye ""columnWidth"" en la máscara de campo, pero no se establece la propiedad, el ancho predeterminado de la columna será 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 de objeto de la tabla.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

Las propiedades de 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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

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

Solicitud de MergeTableCells

Combina celdas en un objeto Table.

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

string

El ID de objeto de la tabla.

tableRange

object (TableRange)

El rango de la tabla que especifica qué celdas de la tabla se combinan.

El texto de las celdas que se combinen se concatenará y se almacenará en la celda superior ("izquierda") del rango. Si el rango no es rectangular (lo que puede ocurrir en algunos casos en los que el rango cubre celdas que ya están combinados), se muestra un error de solicitud incorrecta 400.

Solicitud de combinación de celdas

Separa las celdas de Table.

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

string

El ID de 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 de este rango, y las celdas que ya 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") del bloque resultante de celdas separadas.

Solicitud de objetos de grupo

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

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

string

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

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

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

childrenObjectIds[]

string

Los ID de objeto 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 en otro grupo. Algunos elementos de la página, como videos, tables y placeholders, no se pueden agrupar.

Solicitud de desagrupación de objetos

Desagrupa objetos, como groups.

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

string

Los ID de objeto de los objetos que se desagruparán.

Solo se puede desagrupar groups que no esté dentro de otro 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

Es el ID de objeto del elemento de la página al que se aplican las actualizaciones.

title

string

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

description

string

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

Reemplazar imagen de solicitud

Reemplaza una imagen existente por una nueva.

Si reemplazas una imagen, se quita image effects de la imagen existente.

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

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

string

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 imagen. image_source puede ser solo 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 mostrar dentro de la presentación. Las imágenes deben ser inferiores a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

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

UpdateSlidePropertiesRequest

Actualiza las propiedades de una diapositiva.

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

string

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 se debe especificar. Se puede usar una sola "*" como versión abreviada para enumerar cada campo.

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

Para restablecer una propiedad a su valor predeterminado, incluya el nombre del campo en la máscara de campo, pero déjelo sin configurar.

UpdatePageElementsZOrderRequest

Actualiza el orden Z de los elementos de la página. El orden Z es un orden de los elementos de la página, de atrás hacia adelante. Es posible que el elemento de la parte delantera cubra los elementos que están detrás.

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

string

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

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

operation

enum (ZOrderOperation)

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

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

Operación ZOrden

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

Enumeradores
Z_ORDER_OPERATION_UNSPECIFIED Operación no especificada.
BRING_TO_FRONT Mueve los elementos de la página al principio de la página.
BRING_FORWARD Mueve los elementos de página hacia adelante en la página un elemento en relación con el elemento que se encuentra 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 por un elemento relacionado con el que se encuentra más detrás de uno de 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 se puede actualizar una línea con un objeto category que indica que es un "conector".

La línea se puede redirigir después de actualizar su categoría.

lineCategory

enum (LineCategory)

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

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

Solicitud de RerouteLine

Redirige un elemento line para que esté conectado en los dos sitios de conexión más cercanos en los elementos de página conectados.

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

string

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

Solo se puede redirigir una línea con un objeto category que indique que es un "conector". Las conexiones de inicio y finalización de la línea deben encontrarse en diferentes elementos de página.