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)

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

string

Solo salida. El ID de 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 completa 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. Solo se garantiza que un ID de revisión que se muestra sea válido durante 24 horas después de haberse mostrado y no se puede compartir entre los usuarios. Si el ID de revisión no se modifica entre llamadas, la presentación no se modifica. Por el contrario, un ID modificado (para la misma presentación y el mismo usuario) generalmente significa que la presentación se actualizó. Sin embargo, los IDs modificados también pueden deberse a factores internos, como cambios en el formato de los IDs.
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)

Propiedades específicas de deslizamiento Solo se establece si pageType = SLIDE.
layoutProperties

object (LayoutProperties)

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

object (NotesProperties)

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

object (MasterProperties)

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

PageType

Es el tipo de una página.

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

PageElement

Es un elemento visual que se renderiza 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

El ID de objeto de 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 página.

La apariencia visual del elemento de página está determinada por 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 la misma que el valor en este campo.

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

string

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

El campo no es compatible con los elementos Group.
description

string

La descripción del elemento de página. Se combina con el título para mostrar 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 elemento PageElement. Cada mensaje contiene 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 una colección de elementos de página unidos como una sola unidad.
shape

object (Shape)

Es una forma genérica.
image

object (Image)

Un elemento de la 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 una línea.
table

object (Table)

Un elemento de la página de tabla
wordArt

object (WordArt)

Un elemento de la página de WordArt.
sheetsChart

object (SheetsChart)

Un gráfico vinculado incorporado de 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 combinada de PageElements.

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

object (PageElement)

La colección de elementos en el grupo. El tamaño mínimo de un grupo es 2.

WordArt

Es un tipo PageElement que representa word art.

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

string

El texto renderizado como word art

SpeakerSpotlight

Un tipo PageElement que representa a Orador destacado.

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

object (SpeakerSpotlightProperties)

Propiedades de Orador destacado

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 la estableces, no tendrá contorno.
shadow

object (Shadow)

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

SlideProperties

Las propiedades de Page que solo son relevantes para las 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 del objeto de la instancia principal en el 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 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 CUERPO en la página de notas contiene las notas del orador para 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 notas del orador. Esta propiedad es de solo lectura.
isSkipped

boolean

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

LayoutProperties

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

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

string

El ID de objeto de la instancia 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

El ID del 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á la forma automáticamente. 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.

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

PageProperties

Las propiedades de Page.

La página heredará las propiedades de la página principal. 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 relleno de fondo de la página. Si no la estableces, el relleno del fondo se heredará de una página principal, en caso de que exista. Si la página no tiene un elemento superior, el relleno del fondo se establece de forma predeterminada en el relleno correspondiente del editor de Presentaciones.
colorScheme

object (ColorScheme)

Es el esquema de colores de la página. Si no la estableces, el esquema de colores se heredará de una página principal. Si la página no tiene un elemento primario, el esquema de colores utiliza un esquema de colores predeterminado de Presentaciones, que coincide con los valores 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 Master. Para actualizar el campo, se debe proporcionar un esquema de colores que contenga las asignaciones de los 12 primeros ThemeColorTypes a sus colores concretos. Se ignorarán los colores de los ThemeColorTypes restantes.

PageBackgroundFill

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á de forma implícita este campo a RENDERED, a menos que se especifique otro valor en la misma solicitud. Para que una página no tenga relleno, establece este campo en NOT_RENDERED. En este caso, se ignorará cualquier otro campo de relleno configurado 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

Es el relleno de la imagen estirada. La página o el elemento de página se rellena en su totalidad con la imagen especificada. La foto se estirará para ajustarse al contenedor.

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

string

Lectura de contentUrl:

Una URL a una foto con una vida útil predeterminada de 30 minutos. Esta URL está etiquetada con la cuenta del solicitante. Cualquier persona que tenga la URL puede acceder a la foto de forma efectiva como solicitante original. Si cambia la configuración de uso compartido de la presentación, es posible que pierdas el acceso a la foto.

Escribe la contentUrl:

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

La URL proporcionada puede tener como máximo 2 KB.
size

object (Size)

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)

El ThemeColorType y los pares de colores concretos correspondientes.

ThemeColorPair

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)

El color concreto correspondiente al tipo de color de 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.