REST Resource: presentations.pages

Recurso: Página

Es una página de 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

Es el ID del objeto de esta página. Los IDs 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)

Son los elementos de página renderizados en la página.
revisionId

string

Solo salida. El ID de la revisión de la presentación. Se puede usar en solicitudes de actualización para confirmar que la revisión de la presentación no cambió 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 cadena opaca. El formato del ID de revisión puede cambiar con el tiempo. Se garantiza que un ID de revisión devuelto solo será válido durante 24 horas después de que se devuelva y no se puede compartir entre usuarios. Si el ID de revisión no cambia entre llamadas, significa que la presentación no cambió. Por el contrario, un ID modificado (para la misma presentación y el mismo usuario) suele significar que se actualizó la presentación. Sin embargo, un ID cambiado también puede deberse a factores internos, como cambios en el formato del ID.
pageProperties

object (PageProperties)

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

object (SlideProperties)

Propiedades específicas de la diapositiva Solo se establece si pageType = DIAPOSITIVA.
layoutProperties

object (LayoutProperties)

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

object (NotesProperties)

Anota propiedades específicas. Solo se establece si pageType = NOTES.
masterProperties

object (MasterProperties)

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

PageType

Es el tipo de página.

Enumeraciones
SLIDE Una página de diapositivas
MASTER Una página de diapositivas maestra.
LAYOUT Una página de diseño.
NOTES Una página de notas
NOTES_MASTER Una página maestra de notas.

PageElement

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)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
Campos
objectId

string

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

object (Size)

Es el tamaño del elemento de página.
transform

object (AffineTransform)

La transformación del elemento de página.

La apariencia visual del elemento de página se determina según su transformación absoluta. Para calcular la transformación absoluta, preconcatena la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de página no está en un grupo, su transformación absoluta es igual al valor de este campo.

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

string

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

El campo no es compatible con los elementos Group.
description

string

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

El campo no es compatible con los elementos Group.
Campo de unión element_kind. Es el tipo de elemento que representa este PageElement. 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)

Es un conjunto de elementos de página unidos como una sola unidad.
shape

object (Shape)

Es una forma genérica.
image

object (Image)

Un elemento de página de imagen.
video

object (Video)

Es un elemento de página de video.
line

object (Line)

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

object (Table)

Es un elemento de página de tabla.
wordArt

object (WordArt)

Un elemento de página de texto artístico.
sheetsChart

object (SheetsChart)

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

object (SpeakerSpotlight)

Un orador destacado.

Grupo

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

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

object (PageElement)

Es la colección de elementos del grupo. El tamaño mínimo de un grupo es 2.

WordArt

Un tipo PageElement que representa texto artístico.

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

string

El texto renderizado como texto artístico.

SpeakerSpotlight

Un tipo de PageElement que representa un Orador destacado.

Representación JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Campos
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Las propiedades de Speaker Spotlight.

SpeakerSpotlightProperties

Las propiedades de SpeakerSpotlight.

Representación JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Campos
outline

object (Outline)

El esquema del Orador destacado Si no se establece, no tiene contorno.
shadow

object (Shadow)

La sombra del Orador destacado Si no se establece, no tiene sombra.

SlideProperties

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

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

string

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

string

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

object (Page)

Es la página de notas a la que está asociada esta diapositiva. Define el aspecto visual de una página de notas cuando se imprimen o exportan diapositivas con notas del orador. Una página de notas hereda propiedades de notes master. La forma del marcador de posición con el tipo BODY en la página de notas contiene las notas del orador de esta diapositiva. El campo speakerNotesObjectId identifica el ID de esta forma. La página de notas es de solo lectura, excepto por 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 se omite la diapositiva en el modo de presentación. La configuración predeterminada es "false".

LayoutProperties

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

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

string

Es el ID del objeto del modelo principal en el que se basa este diseño.
name

string

Es el nombre del diseño.
displayName

string

Es el nombre legible del diseño.

NotesProperties

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

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

string

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

MasterProperties

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

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

string

Es el nombre legible del elemento principal.

PageProperties

Las propiedades de Page.

La página heredará 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)

Es el relleno del fondo de la página. Si no se establece, el relleno de fondo se hereda de una página superior, si existe. Si la página no tiene un elemento superior, el relleno de fondo se establece de forma predeterminada en el relleno correspondiente en el editor de diapositivas.
colorScheme

object (ColorScheme)

Es 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 usa un esquema de colores predeterminado de Presentaciones, que coincide con los predeterminados del editor de Presentaciones.

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

PageBackgroundFill

Es 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 de fondo.

La actualización del relleno de una página actualizará implícitamente este campo a RENDERED, a menos que se especifique otro valor en la misma solicitud. Si no deseas que una página tenga relleno, establece este campo en NOT_RENDERED. En este caso, se ignorará cualquier otro campo de relleno establecido en la misma solicitud.
Campo de unión kind. Es el tipo de relleno de 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

StretchedPictureFill

El relleno de la imagen estirada. La página o el elemento de página se completan por completo con la imagen especificada. La imagen se estira para ajustarse a su contenedor.

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

string

Lectura de contentUrl:

Una URL a una foto con una duración predeterminada de 30 minutos. Esta URL está etiquetada con la cuenta del solicitante. Cualquier persona que tenga la URL podrá acceder a la foto como el solicitante original. Es posible que se pierda el acceso a la imagen si cambia la configuración de uso compartido de la presentación.

Cómo escribir contentUrl:

La imagen se recupera una vez en el momento de la inserción y se almacena una copia para mostrarla 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 puede tener una longitud máxima de 2 KB.
size

object (Size)

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

ColorScheme

Es la paleta de colores predefinidos de una página.

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

object (ThemeColorPair)

ThemeColorType y los pares de colores concretos correspondientes.

ThemeColorPair

Es un par que 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)

Es el tipo de color del tema.
color

object (RgbColor)

Es el color concreto que corresponde 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 versión más reciente de la página especificada en la presentación y muestra una URL a la imagen de la miniatura.