REST Resource: presentations.pages

Recurso: Página

Una página en una presentación

Representación JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Campos
objectId

string

El ID de objeto de esta página. Los ID de objeto que usan Page y PageElement comparten el mismo espacio de nombres.
pageType

enum (PageType)

Es el tipo de página.
pageElements[]

object (PageElement)

Los elementos de página renderizados en la página
revisionId

string

Solo salida. El ID de revisión de la presentación. Puede usarse en solicitudes de actualización para confirmar que la revisión de la presentación no ha cambiado desde la última operación de lectura. Solo se propaga si el usuario tiene acceso de edición a la presentación.

El ID de revisión no es un número secuencial, sino una string opaca. El formato del ID de revisión puede cambiar con el tiempo. Un ID de revisión que se muestra solo está garantizado durante 24 horas después de que se haya mostrado y no se puede compartir entre usuarios. Si el ID de revisión no cambia entre llamadas, la presentación no se modifica. Por el contrario, un ID modificado (para la misma presentación y el mismo usuario) suele significar que la presentación se actualizó. Sin embargo, un ID modificado también puede deberse a factores internos, como cambios de formato de ID.
pageProperties

object (PageProperties)

Las propiedades de la página.
Campo de unión properties. Propiedades específicas para cada tipo de página Las instancias principales no requieren ninguna propiedad adicional. Las direcciones (properties) solo pueden ser una de las siguientes opciones:
slideProperties

object (SlideProperties)

Desliza las propiedades específicas. Solo se establece si pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Propiedades específicas del diseño Solo se establece si pageType = LAYOUT.
notesProperties

object (NotesProperties)

Toma nota de propiedades específicas. Solo se establece si pageType = NOTES.
masterProperties

object (MasterProperties)

Domina propiedades específicas. Solo se establece si pageType = MASTER.

Tipo de página

Es el tipo de página.

Enumeradores
SLIDE Una página de diapositiva
MASTER Una página de diapositiva maestra
LAYOUT Una página de diseño.
NOTES Una página de notas
NOTES_MASTER Una página principal de notas.

Elemento de página

Un elemento visual renderizado en una página.

Representación JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  }
  // End of list of possible types for union field element_kind.
}
Campos
objectId

string

El ID de objeto para este elemento de página. Los ID de objeto que usan google.apps.slides.v1.Page y google.apps.slides.v1.PageElement comparten el mismo espacio de nombres.
size

object (Size)

El tamaño del elemento de página.
transform

object (AffineTransform)

La transformación del elemento de la página.

La apariencia visual del elemento de la página está determinada por su transformación absoluta. Para calcular la transformación absoluta, concatena la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de la página no está en un grupo, su transformación absoluta es la misma que el valor en este campo.

La transformación inicial para la Group recién creada siempre es la transformación de identidad.
title

string

El título del elemento de la página. Combinado con la descripción para mostrar texto alternativo.

Este campo no es compatible con los elementos Group.
description

string

Es la descripción del elemento de página. Combinado con el título para mostrar texto alternativo

Este campo no es compatible con los elementos Group.
Campo de unión element_kind. Tipo de elemento que representa este elemento de página. Cada mensaje contiene las propiedades específicas de ese tipo de elemento de página. Las direcciones (element_kind) solo pueden ser una de las siguientes opciones:
elementGroup

object (Group)

Una colección de elementos de página unidos como una sola unidad.
shape

object (Shape)

Una forma genérica.
image

object (Image)

Un elemento de página de imagen.
video

object (Video)

Un elemento de la página de video.
line

object (Line)

Un elemento de la página de línea.
table

object (Table)

Un elemento de página de tabla.
wordArt

object (WordArt)

Un elemento de la página de word art.
sheetsChart

object (SheetsChart)

Un gráfico vinculado incorporado desde Hojas de cálculo de Google Los gráficos desvinculados se representan como imágenes.

Grupo

Un tipo PageElement que representa una colección unida de PageElements.

Representación JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Campos
children[]

object (PageElement)

El grupo de elementos del grupo. El tamaño mínimo de un grupo es 2.

WordArt

Un tipo PageElement que representa word art.

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

string

El texto representado como word art.

Propiedades de las diapositivas

Las propiedades de Page que solo son relevantes para páginas con PageType SLIDE.

Representación JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Campos
layoutObjectId

string

El ID de objeto del diseño en el que se basa esta diapositiva. Esta propiedad es de solo lectura.
masterObjectId

string

El ID de objeto de la instancia principal en la que se basa esta diapositiva. Esta propiedad es de solo lectura.
notesPage

object (Page)

La página de notas con la que está asociada esta diapositiva. Define la apariencia visual de una página de notas al imprimir o exportar diapositivas con notas del orador. Una página de notas hereda propiedades de notes master. La forma del marcador de posición del tipo BODY en la página de notas contiene las notas del orador para esta diapositiva. El ID de esta forma se identifica mediante el campo speakerNotesObjectId. La página de notas es de solo lectura, excepto el contenido de texto y los estilos de la forma de las notas del orador. Esta propiedad es de solo lectura.
isSkipped

boolean

Indica si la diapositiva se omite en el modo de presentación. La configuración predeterminada es "false".

Propiedades de la función de diseño

Las propiedades de Page solo son relevantes para páginas con pageY LAYOUT.

Representación JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Campos
masterObjectId

string

El ID de objeto de la instancia principal en la que se basa este diseño.
name

string

El nombre del diseño.
displayName

string

Es el nombre legible del diseño.

Propiedades de notas

Las propiedades de Page que solo son relevantes para páginas con pageType NOTES.

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

string

El ID de objeto de la forma de esta página de notas que contiene las notas del orador para la diapositiva correspondiente. Es posible que la forma real no siempre exista en la página de notas. Si insertas el texto con este ID de objeto, se creará automáticamente la forma. En este caso, la forma real puede tener un ID de objeto diferente. Las acciones presentations.get o pages.get siempre mostrarán el ID de objeto más reciente.

Propiedades maestras

Las propiedades de Page que solo son relevantes para páginas con pageType MASTER.

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

string

El nombre legible de la instancia principal.

Propiedades de la página

Las propiedades de Page.

La página heredará las propiedades de la página superior. Según el tipo de página, la jerarquía se define en SlideProperties o LayoutProperties.

Representación JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Campos
pageBackgroundFill

object (PageBackgroundFill)

El fondo de la página. Si no se establece, el relleno del fondo se hereda de una página principal en caso de que exista. Si la página no tiene un elemento superior, el valor predeterminado de relleno en segundo plano corresponde al relleno correspondiente en el editor de Presentaciones.
colorScheme

object (ColorScheme)

El esquema de colores de la página. Si no se establece, el esquema de colores se hereda de una página superior. Si la página no tiene un elemento superior, el esquema de colores utiliza un esquema de colores predeterminado de Presentaciones que coincide con los valores predeterminados en el editor de Presentaciones.

Solo se pueden editar los colores concretos de las primeras 12 ThemeColorType. Además, solo se puede actualizar el esquema de colores en las páginas de Master. Para actualizar el campo, se debe proporcionar un esquema de colores que contenga asignaciones de los primeros 12 ThemeColorTypes a sus colores concretos. Se ignorarán los colores para los ThemeColorTypes restantes.

Página en segundo plano

El relleno del fondo de la página

Representación JSON 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Campos
propertyState

enum (PropertyState)

Es el estado de la propiedad de relleno en segundo plano.

La actualización del relleno en una página actualizará de manera implícita este campo a RENDERED, a menos que se especifique otro valor en la misma solicitud. Para no completar ninguna página, establece este campo en NOT_RENDERED. En este caso, se ignorará cualquier otro campo de relleno que se haya configurado en la misma solicitud.
Campo de unión kind. El tipo de relleno del fondo. Las direcciones (kind) solo pueden ser una de las siguientes opciones:
solidFill

object (SolidFill)

Relleno de color sólido.
stretchedPictureFill

object (StretchedPictureFill)

Relleno de imagen estirado.

Fino de película estirado

El relleno de la imagen extendida. La página o el elemento de página se rellena por completo con la imagen especificada. La imagen se expande para que quepa en el contenedor.

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

string

Lectura de contentUrl:

Una URL a una imagen con una vida útil predeterminada de 30 minutos. Esta URL está etiquetada con la cuenta del solicitante. Cualquier persona con la URL accede efectivamente a la imagen como el solicitante original. Si cambia la configuración de uso compartido de la presentación, es posible que se pierda el acceso a la foto.

Escritura del contentUrl:

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

La URL proporcionada no puede superar los 2 KB.
size

object (Size)

El tamaño original del relleno de la imagen. Este campo es de solo lectura.

Esquema de colores

Paleta de colores predefinidos para una página

Representación JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Campos
colors[]

object (ThemeColorPair)

El ThemeColorType y los pares de colores concretos correspondientes.

Tema de color

Un par asigna un tipo de color de tema al color concreto que representa.

Representación JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Campos
type

enum (ThemeColorType)

Tipo de color del tema.
color

object (RgbColor)

El color concreto correspondiente al tipo de color del tema anterior.

Métodos

get

 Obtiene la versión más reciente de la página especificada en la presentación.

getThumbnail

 Genera una miniatura de la última versión de la página especificada en la presentación y muestra una URL a la imagen en miniatura.