Requests

Solicitud

Es un solo tipo de actualización que se aplica 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 solo puede ser uno de los siguientes valores:
createSlide

object (CreateSlideRequest)

Crea una nueva diapositiva.

createShape

object (CreateShapeRequest)

Crea una forma nueva.

createTable

object (CreateTableRequest)

Crea una nueva tabla.

insertText

object (InsertTextRequest)

Inserta texto en una forma o en una celda de una 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 la 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 tabla.

createImage

object (CreateImageRequest)

Crea una imagen.

createVideo

object (CreateVideoRequest)

Crea un video.

createSheetsChart

object (CreateSheetsChartRequest)

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

createLine

object (CreateLineRequest)

Crea una línea.

refreshSheetsChart

object (RefreshSheetsChartRequest)

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

updateShapeProperties

object (UpdateShapePropertiesRequest)

Actualiza las propiedades de un Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Actualiza las propiedades de un objeto 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 un elemento de diapositiva o página.

updateTextStyle

object (UpdateTextStyleRequest)

Actualiza el diseño del texto dentro de un elemento 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 diseño de los párrafos dentro de un elemento Shape o Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

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

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Actualiza las propiedades de una columna Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Actualiza las propiedades de una fila de Table.

mergeTableCells

object (MergeTableCellsRequest)

Combina celdas en un objeto Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Separa las celdas en un Table.

groupObjects

object (GroupObjectsRequest)

Agrupa objetos, como elementos de la 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 objeto 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 Z de page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Actualiza la categoría de un line.

rerouteLine

object (RerouteLineRequest)

Redirige un line de modo que se conecte en los dos sitios de conexión más cercanos de los elementos de la 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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID debe ser de entre 5 y 50 caracteres, inclusive.

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

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

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

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

Si no se encuentra el LayoutReference en el diseño principal actual, se devuelve un error 400 de solicitud incorrecta.

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

LayoutReference

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

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

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

PredefinedLayout

Son los tipos de diseño predefinidos. Estos son diseños que se encuentran comúnmente en las presentaciones. Sin embargo, no hay garantía de que estos diseños estén presentes en la versión 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 en cada diseño.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Diseño no especificado.
BLANK Diseño en blanco, sin marcadores de posición.
CAPTION_ONLY Diseño con un pie de foto en la parte inferior.
TITLE Diseño con un título y un subtítulo.
TITLE_AND_BODY Diseño con un título y un cuerpo.
TITLE_AND_TWO_COLUMNS Diseño con un título y dos columnas.
TITLE_ONLY Diseño con solo un título.
SECTION_HEADER Diseño con el título de una 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, dispuestos 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 a partir de un diseño especificado.

Representación JSON
{
  "objectId": string,

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

string

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

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

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

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

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

CreateShapeRequest

Crea una forma nueva.

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

string

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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50. Si está vacío, se generará un identificador único.

elementProperties

object (PageElementProperties)

Son las propiedades del elemento para la forma.

shapeType

enum (Type)

Es el tipo de forma.

PageElementProperties

Son las propiedades comunes de un elemento de página.

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

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

string

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

size

object (Size)

Es el tamaño del elemento.

transform

object (AffineTransform)

Es la transformación del elemento.

CreateTableRequest

Crea una nueva tabla.

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

string

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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento de la tabla.

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

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

rows

integer

Cantidad de filas en la tabla.

columns

integer

Cantidad de columnas en la tabla.

InsertTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

text

string

Es el texto que se insertará.

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

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

Algunos caracteres de control (U+0000 a U+0008, U+000C a U+001F) y caracteres del área de uso privado del plano multilingüe básico de Unicode (U+E000 a U+F8FF) se quitarán del texto insertado.

insertionIndex

integer

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

InsertTableRowsRequest

Inserta filas en una tabla.

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

string

Tabla en la que se insertarán las filas.

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

Inserta columnas en una tabla.

El tamaño de las demás columnas de la tabla se ajustará para que quepa la nueva columna.

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

string

Tabla en la que se insertarán las columnas.

cellLocation

object (TableCellLocation)

Es la ubicación de la celda de la tabla de referencia desde la que se insertarán las columnas.

Se insertará una columna nueva a la izquierda (o a la derecha) de la columna en la que se encuentra la celda de referencia. Si la celda de referencia es una celda combinada, se insertará una columna nueva a la izquierda (o a la derecha) de la celda combinada.

insertRight

boolean

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

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

integer

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

DeleteTableRowRequest

Borra una fila de una tabla.

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

string

Tabla de la que se borrarán las filas.

cellLocation

object (TableCellLocation)

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

Se borrará la fila que abarca esta celda. Si se trata de una celda combinada, se borrarán varias filas. Si no 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

Tabla de la que se borrarán las columnas.

cellLocation

object (TableCellLocation)

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

Se borrará la columna que abarca esta celda. Si se trata de una celda combinada, se borrarán varias columnas. Si no 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

Es el texto que reemplazará el texto coincidente.

pageObjectIds[]

string

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

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

Campo de unión criteria. Son los criterios que se usan para hacer coincidir el texto que se reemplazará. criteria solo puede ser uno de los siguientes valores:
containsText

object (SubstringMatchCriteria)

Busca texto en una forma que coincida con esta subcadena.

SubstringMatchCriteria

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

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

string

Es el texto que se buscará en la forma o la tabla.

matchCase

boolean

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

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

boolean

Opcional. Es verdadero si el valor de búsqueda debe tratarse como una expresión regular. Se debe escapar cualquier barra invertida en el patrón.

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

DeleteObjectRequest

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

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

string

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

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

Si se borra un marcador de posición en un diseño, también se borrarán los marcadores de posición vacíos que heredan de él.

UpdatePageElementTransformRequest

Actualiza la transformación de un elemento de la 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

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

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

ApplyMode

Son los modos de aplicación de la actualización de transformación.

Enums
APPLY_MODE_UNSPECIFIED Modo sin especificar.
RELATIVE Aplica la nueva matriz de 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

Índice en el que se deben insertar las diapositivas, según la disposición de las diapositivas antes de que se realice el movimiento. Debe ser un número entre cero y la cantidad de diapositivas de la presentación, incluidos ambos.

DeleteTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

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

Borrar texto que cruza el límite de un párrafo puede generar cambios en los estilos y las listas de párrafos, ya que los dos párrafos se combinan.

Los rangos que incluyen solo una unidad de código de un par sustituto 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. Se requiere 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 los rangos de FIXED_RANGE.

type

enum (Type)

Es el tipo de rango.

Tipo

Son los tipos de rangos.

Enums
RANGE_TYPE_UNSPECIFIED Es un tipo de rango sin especificar. No se debe usar este valor.
FIXED_RANGE Es un rango fijo. Se deben especificar startIndex y endIndex.
FROM_START_INDEX Comienza el rango en startIndex y continúa hasta el final de la colección. No se debe especificar endIndex.
ALL Establece el rango para que abarque toda 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

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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento de la imagen.

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

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

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

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

string

Es la URL de la imagen.

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

La URL proporcionada 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 que realiza la solicitud debe tener, al menos, uno de los permisos de OAuth 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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento para el video.

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

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

source

enum (Source)

Es la fuente del video.

id

string

Es el identificador único de la fuente del video.

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

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

CreateSheetsChartRequest

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

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

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

string

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 la página en la presentación. El ID debe comenzar con un carácter de palabra [a-zA-Z0-9_] y, luego, incluir cualquier cantidad de los siguientes caracteres [a-zA-Z0-9_-:]. La longitud del ID no debe ser inferior a 5 ni superior a 50. Si está vacío, se generará un identificador único.

elementProperties

object (PageElementProperties)

Son las propiedades del elemento del gráfico.

Cuando la relación de aspecto del tamaño proporcionado no coincide con la relación de aspecto del gráfico, el gráfico se ajusta y 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

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

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

LinkingMode

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

Enums
NOT_LINKED_IMAGE El gráfico no está asociado con la hoja de cálculo de origen y no se puede actualizar. Los gráficos que no estén vinculados se insertarán como imágenes.
LINKED Vincular el gráfico permite que se actualice, y los demás colaboradores verán un vínculo a la hoja de cálculo.

CreateLineRequest

Crea una línea.

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

string

Es un ID de objeto proporcionado por el usuario.

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

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

elementProperties

object (PageElementProperties)

Son las propiedades del elemento para la línea.

lineCategory
(deprecated)

enum (Category)

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

Obsoleto : usa category en su lugar.

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

Si especificas category y lineCategory, category tendrá prioridad.

category

enum (LineCategory)

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

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

Si especificas category y lineCategory, category tendrá prioridad.

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

Si no especificas ninguno, se usa STRAIGHT.

Categoría

Son las categorías de líneas.

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

RefreshSheetsChartRequest

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

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

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

string

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

UpdateShapePropertiesRequest

Actualiza las propiedades de un Shape.

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

string

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

shapeProperties

object (ShapeProperties)

Son las propiedades de forma que se actualizarán.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

UpdateImagePropertiesRequest

Actualiza las propiedades de un objeto Image.

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

string

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

imageProperties

object (ImageProperties)

Son las propiedades de la imagen que se actualizarán.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero deja el campo 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 del objeto del video al que se aplican las actualizaciones.

videoProperties

object (VideoProperties)

Son las propiedades del video que se actualizarán.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

UpdatePagePropertiesRequest

Actualiza las propiedades de un Page.

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

string

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

pageProperties

object (PageProperties)

Son las propiedades de la página que se actualizarán.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

Para restablecer una propiedad a su valor predeterminado, incluye su nombre de campo en la máscara de campo, pero deja el campo 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

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

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

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

TableRange

Un rango de tabla representa una referencia a un subconjunto de una tabla.

Es importante tener en cuenta que las celdas especificadas por un rango de tabla no necesariamente forman un rectángulo. Por ejemplo, supongamos que tenemos una tabla de 3 x 3 en la que todas las celdas de la última fila están combinadas. La tabla se ve de la siguiente manera:

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

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

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

object (TableCellLocation)

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

rowSpan

integer

Es la extensión vertical del rango de la tabla.

columnSpan

integer

Es la extensión de la columna del rango de la tabla.

UpdateLinePropertiesRequest

Actualiza las propiedades de un Line.

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

string

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

lineProperties

object (LineProperties)

Son las propiedades de la línea que se actualizarán.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

CreateParagraphBulletsRequest

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

El nivel de anidación de cada párrafo se determinará contando las tabulaciones iniciales delante de cada párrafo. Para evitar el exceso de espacio entre la viñeta y el párrafo correspondiente, esta solicitud quita las tabulaciones iniciales. 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 anterior.

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

string

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

cellLocation

object (TableCellLocation)

Ubicación opcional de la celda de la tabla si el texto que se modificará se encuentra en una celda de la tabla. Si está presente, el parámetro objectId debe hacer referencia a una tabla.

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

Son patrones predeterminados de glifos de viñetas para listas en texto.

Estos patrones usan los siguientes tipos de viñetas:

  • ARROW : Una flecha, que corresponde a un punto de código Unicode U+2794
  • ARROW3D : Una flecha con sombreado en 3D, que corresponde a un punto de código Unicode U+27a2
  • CHECKBOX : Un cuadrado vacío, que corresponde a un punto de código Unicode U+274f
  • CIRCLE : Un círculo hueco, que corresponde a un punto de código Unicode U+25cb
  • DIAMOND : Un diamante sólido, que corresponde a un punto de código Unicode U+25c6
  • DIAMONDX : Un diamante con una "X", que corresponde a un punto de código Unicode U+2756
  • HOLLOWDIAMOND : Un diamante hueco, que corresponde a un punto de código Unicode U+25c7
  • DISC : Un círculo sólido, que corresponde a un punto de código Unicode U+25cf
  • SQUARE : Un cuadrado sólido, que corresponde a un punto de código Unicode U+25a0
  • STAR : Una estrella, que corresponde a un punto de código Unicode U+2605
  • ALPHA : Una letra en 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 : Es un número en el que los números de un solo dígito tienen un prefijo cero, como "01", "02" o "03". Los números con más de un dígito no tienen un cero como prefijo.
  • ROMAN : Es un número romano en minúsculas, como "i", "ii" o "iii".
  • UPPERROMAN : Es un número romano en mayúsculas, como "I", "II" o "III".
  • LEFTTRIANGLE : Un triángulo que apunta hacia la izquierda, correspondiente a un punto de código Unicode U+25c4
Enums
BULLET_DISC_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta DISC, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
BULLET_DIAMONDX_ARROW3D_SQUARE Una lista con viñetas con un glifo de viñeta DIAMONDX, ARROW3D y SQUARE para los primeros 3 niveles de anidamiento de la lista.
BULLET_CHECKBOX Una lista con viñetas que incluye 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 ARROW, DIAMOND y DISC para los primeros 3 niveles de anidamiento de la lista.
BULLET_STAR_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta STAR, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
BULLET_ARROW3D_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta ARROW3D, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Una lista con viñetas con un glifo de viñeta LEFTTRIANGLE, DIAMOND y DISC para los primeros 3 niveles de anidamiento de la lista.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Una lista con viñetas con un glifo de viñeta DIAMONDX, HOLLOWDIAMOND y SQUARE para los primeros 3 niveles de anidamiento de la lista.
BULLET_DIAMOND_CIRCLE_SQUARE Una lista con viñetas con un glifo de viñeta DIAMOND, CIRCLE y SQUARE para los primeros 3 niveles de anidamiento de la lista.
NUMBERED_DIGIT_ALPHA_ROMAN Una lista numerada con glifos numéricos DIGIT, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Una lista numerada con DIGIT, ALPHA y ROMAN glifos numéricos para los primeros 3 niveles de anidamiento de la lista, seguidos de paréntesis.
NUMBERED_DIGIT_NESTED Una lista numerada con DIGIT glifos numéricos separados por puntos, en la que cada nivel de anidación usa el glifo del nivel de anidación anterior como prefijo. Por ejemplo, "1.". '1.1.', "2.", "2.2.".
NUMBERED_UPPERALPHA_ALPHA_ROMAN Una lista numerada con glifos numéricos UPPERALPHA, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Una lista numerada con glifos numéricos UPPERROMAN, UPPERALPHA y DIGIT para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Una lista numerada con glifos numéricos ZERODIGIT, ALPHA y ROMAN para los primeros 3 niveles de anidamiento de la lista, seguidos de puntos.

ReplaceAllShapesWithImageRequest

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

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

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

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

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

enum (ReplaceMethod)

Es el método de reemplazo.

Obsoleto : usa imageReplaceMethod en su lugar.

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

imageReplaceMethod

enum (ImageReplaceMethod)

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

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

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

Si no especificas ninguna, se usa CENTER_INSIDE.

pageObjectIds[]

string

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

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

Campo de unión criteria. Son los criterios que deben cumplir las formas para reemplazarse. criteria solo puede ser uno de los siguientes valores:
containsText

object (SubstringMatchCriteria)

Si se configura, esta solicitud reemplazará todas las formas que contengan el texto proporcionado.

Campo de unión image_source. Es el tipo de fuente de imagen. image_source solo puede ser uno de los siguientes valores:
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 pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

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

ReplaceMethod

Es el método de reemplazo.

Enums
CENTER_INSIDE Ajusta y centra la imagen para que quepa dentro de los límites de la forma original y mantiene la relación de aspecto de la imagen. 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 que llene 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

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

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED No se especificó el método de reemplazo de la imagen. No se debe usar este valor.
CENTER_INSIDE Ajusta y centra la imagen para que quepa dentro de los límites de la forma original y mantiene la relación de aspecto de la imagen. 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 que llene 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 un elemento de diapositiva o página.

Cuando dupliques una diapositiva, la diapositiva duplicada se creará inmediatamente después de la diapositiva especificada. Cuando dupliques un elemento de la página, el duplicado se colocará en la misma página y en la misma posición que el original.

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

string

Es el ID del objeto que se duplicará.

objectIds

map (key: string, value: string)

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

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

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

UpdateTextStyleRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

Son los estilos que se aplicarán al texto.

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

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

Es el rango de texto al que se le aplicará un estilo.

El rango se puede extender para incluir saltos de línea 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)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

ReplaceAllShapesWithSheetsChartRequest

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

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

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

object (SubstringMatchCriteria)

Son los criterios que deben cumplir las formas para reemplazarse. La solicitud reemplazará todas las formas que contengan el texto proporcionado.

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

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

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

LinkingMode

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

Enums
NOT_LINKED_IMAGE El gráfico no está asociado con la hoja de cálculo de origen y no se puede actualizar. Los gráficos que no estén vinculados se insertarán como imágenes.
LINKED Vincular el gráfico permite que se actualice, 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 determinado range.

El nivel de anidación de cada párrafo se conservará visualmente agregando una sangría al comienzo del párrafo correspondiente.

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

string

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

cellLocation

object (TableCellLocation)

Ubicación opcional de la celda de la tabla si el texto que se modificará se encuentra en una celda de la tabla. Si está presente, el parámetro objectId debe hacer referencia a una tabla.

textRange

object (Range)

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

UpdateParagraphStyleRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

Es el estilo del párrafo.

textRange

object (Range)

Es el rango de texto que contiene los párrafos a los que se les aplicará el diseño.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

UpdateTableBorderPropertiesRequest

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

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

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

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

tableBorderProperties

object (TableBorderProperties)

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

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

BorderPosition

Posición del borde de la tabla.

Enums
ALL Todos los bordes del rango.
BOTTOM Son los bordes en la parte inferior del rango.
INNER Bordes en el interior del rango.
INNER_HORIZONTAL Son los bordes horizontales en el interior del rango.
INNER_VERTICAL Bordes verticales en el interior del rango.
LEFT Son los 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 una columna Table.

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

string

Es el ID del objeto de la tabla.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

Son 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 devuelve un error 400 de solicitud incorrecta.

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

UpdateTableRowPropertiesRequest

Actualiza las propiedades de una fila de Table.

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

string

Es el ID del objeto de la tabla.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

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

fields

string (FieldMask format)

Son 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 un solo "*" como abreviatura para enumerar todos los campos.

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

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

MergeTableCellsRequest

Combina celdas en un objeto Table.

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

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

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

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

UnmergeTableCellsRequest

Separa las celdas en un Table.

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

string

Es el ID del objeto de la tabla.

tableRange

object (TableRange)

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

Se descombinarán todas las celdas combinadas en este rango, y las celdas que ya estén descombinadas no se verán afectadas. Si el rango no tiene celdas combinadas, la solicitud no hará nada. Si hay texto en alguna de las celdas combinadas, este permanecerá en la celda superior izquierda ("principal") del bloque resultante de celdas no combinadas.

GroupObjectsRequest

Agrupa objetos para crear un grupo de objetos. Por ejemplo, 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 el 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 la página de la presentación. El ID debe comenzar con un carácter alfanumérico o un guion bajo (coincide con la expresión regular [a-zA-Z0-9_]); los caracteres restantes pueden incluir esos, así como un guion o dos puntos (coincide con la expresión regular [a-zA-Z0-9_-:]). La longitud del ID no debe ser inferior a 5 ni superior a 50.

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

childrenObjectIds[]

string

Son los IDs de los objetos que se agruparán.

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

UngroupObjectsRequest

Desagrupa objetos, como groups.

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

string

Son los IDs de los objetos que se desagruparán.

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

UpdatePageElementAltTextRequest

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

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

string

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

title

string

Es el título actualizado del texto alternativo del elemento de la página. Si no se configura, se conservará el valor existente. El título se expone a los lectores de pantalla y a otras interfaces de accesibilidad. Usa solo 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 configura, se conservará el valor existente. La descripción se expone a los lectores de pantalla y otras interfaces de accesibilidad. Usa solo valores legibles relacionados con el contenido del elemento de la página.

ReplaceImageRequest

Reemplaza una imagen existente por una nueva.

Reemplazar una imagen quita algunos image effects de la imagen existente.

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

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

string

ID de la imagen existente que se reemplazará. El ID se puede recuperar 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 solo puede ser uno de los siguientes valores:
url

string

Es la URL de la imagen.

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

La URL proporcionada no puede superar los 2 KB 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

ID del objeto de la diapositiva a la que se aplica la actualización.

slideProperties

object (SlideProperties)

Son las propiedades de la diapositiva que se actualizarán.

fields

string (FieldMask format)

Son los campos que se deben actualizar.

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

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

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

UpdatePageElementsZOrderRequest

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

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

string

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

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

operation

enum (ZOrderOperation)

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 la página, se mantienen los órdenes Z relativos dentro de estos elementos de la página antes de la operación.

ZOrderOperation

Operación para actualizar el orden Z de un elemento de la página.

Enums
Z_ORDER_OPERATION_UNSPECIFIED Operación no especificada.
BRING_TO_FRONT Lleva los elementos de la página al frente de la página.
BRING_FORWARD Adelanta los elementos de la página en un elemento en relación con el elemento más adelantado de los elementos de la página especificados.
SEND_BACKWARD Envía los elementos de la página hacia atrás en la página en relación con el elemento más rezagado de los elementos de la página especificados.
SEND_TO_BACK Envía los elementos de la página al fondo de la página.

UpdateLineCategoryRequest

Actualiza la categoría de un line.

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

string

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

Solo se puede actualizar una línea con un category que indica que es un "conector".

Es posible que la línea se desvíe después de actualizar su categoría.

lineCategory

enum (LineCategory)

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

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

RerouteLineRequest

Redirige un line de modo que se conecte en los dos sitios de conexión más cercanos de los elementos de la página conectados.

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

string

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

Solo se puede cambiar la ruta de una línea con un category que indica que es un "conector". Las conexiones de inicio y finalización de la línea deben estar en diferentes elementos de la página.