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 del objeto de esta página. Los IDs de objeto que usan Page y PageElement comparten el mismo espacio de nombres.
pageType

enum (PageType)

Indica 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 se modificó 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 cadena opaca. El formato del ID de revisión puede cambiar con el tiempo. Si se muestra un ID de revisión, solo se garantiza su validez durante 24 horas, y no se puede compartir con los usuarios. Si el ID de revisión no se cambia entre llamadas, la presentación no cambió. En cambio, si cambias el ID (para la misma presentación y el mismo usuario), generalmente significa que la presentación se actualizó. Sin embargo, un ID modificado también puede deberse a factores internos, como modificaciones 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 Las instancias principales no requieren propiedades adicionales. 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)

Ten en cuenta las propiedades específicas. Solo se establece si pageType = NOTES.
masterProperties

object (MasterProperties)

Propiedades específicas principales Solo se establece si pageType = MASTER.

PageType

Indica el tipo de página.

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

PageElement

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

El ID de 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 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 de 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

Es 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. El tipo de elemento que representa este PageElement. Cada mensaje contiene propiedades específicas para 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)

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)

Es 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 WordArt.
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 word art.

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

string

El texto renderizado como word art.

SpeakerSpotlight

Un tipo de PageElement que representa un Orador destacado.

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

object (SpeakerSpotlightProperties)

Propiedades del Orador destacado

SpeakerSpotlightProperties

Las propiedades de SpeakerSpotlight

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

object (Outline)

El contorno del Orador destacado. Si no la estableces, no tendrá contorno.
shadow

object (Shadow)

La sombra de la Orador destacado Si no está configurado, 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

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 del diseño maestro en el que se basa esta diapositiva. Esta propiedad es de solo lectura.
notesPage

object (Page)

La página de notas a la que está asociada esta diapositiva. Define el aspecto visual de la 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 con el tipo BODY en la página de notas contiene las notas del orador de esta diapositiva. El ID de esta forma se identifica con el campo speakerNotesObjectId. 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

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 las 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 la 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 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. Las acciones presentations.get o pages.get siempre mostrarán el ID de objeto más reciente.

MasterProperties

Son las propiedades de Page que solo son relevantes para 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 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 la estableces, 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 establecerá 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 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 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 de Master. Para actualizar el campo, se debe proporcionar un esquema de colores que contenga asignaciones de los primeros 12 ThemeColorTypes a los 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 del 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. 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)

Se estiró el relleno de la imagen.

StretchedPictureFill

Se estiró el relleno de la imagen. La página o elemento de página se rellena completamente con la imagen especificada. La foto se estirará para que quepa en el contenedor.

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

string

Cómo leer contentUrl:

Una URL a una imagen 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. Si se cambia la configuración de uso compartido de la presentación, es posible que se pierda el acceso a la foto.

Escribe la contentUrl:

La imagen se recupera una vez al 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 una longitud máxima de 2 KB.
size

object (Size)

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

ColorScheme

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

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)

El tipo del color de 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.