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)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
}
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 la página que se renderizan en ella.
revisionId

string

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

object (PageProperties)

Son las propiedades de la página.
commentAnchors[]

object (CommentAnchor)

Solo salida. Son los anclajes de comentarios presentes en la página.
comments[]

object (CommentThread)

Solo salida. Son las conversaciones de comentarios asociadas a la página. Solo se completa si la página se recuperó a través de un GetPageRequest con un commentsViewMode completado. De lo contrario, los comentarios se muestran en Presentation a través de GetPresentationRequest.
commentsViewMode

enum (CommentsViewMode)

Solo salida. Es el modo de visualización de comentarios aplicado a la página. Solo se completa si la página se recuperó a través de un GetPageRequest con un commentsViewMode completado.
Son las propiedades específicas de cada tipo de página. Los masters no requieren propiedades adicionales. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

Son 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.
Fin de los campos mutuamente excluyentes.

PageType

Es el tipo de página.

Enums
SLIDE Una página de diapositiva
MASTER Página de diapositiva principal
LAYOUT Una página de diseño
NOTES Una página de notas
NOTES_MASTER Una página principal de notas

PageElement

Es un elemento visual renderizado en una página.

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

  "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)
  }
}
Campos
objectId

string

Es el ID del objeto para 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 la página.
transform

object (AffineTransform)

Es 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, concatena previamente la transformación de un elemento de la página con las transformaciones de todos sus grupos principales. 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 el Group recién creado siempre es la transformación de identidad.
title

string

Es el título del elemento de 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 página. Se combina con el título para mostrar el texto alternativo.

El campo no es compatible con los elementos Group.
Tipo de elemento que representa este PageElement. Cada mensaje contiene las propiedades específicas de ese tipo de elemento de la página. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
elementGroup

object (Group)

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

object (Shape)

Forma genérica.
image

object (Image)

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

Es un elemento de página de WordArt.
sheetsChart

object (SheetsChart)

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

object (SpeakerSpotlight)

Un Orador destacado
Fin de los campos mutuamente excluyentes.

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 de 2.

WordArt

Es un tipo PageElement que representa el word art.

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

string

Es el texto renderizado como WordArt.

SpeakerSpotlight

Es un tipo PageElement que representa un Orador destacado.

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

object (SpeakerSpotlightProperties)

Son las propiedades de la función Orador destacado.

SpeakerSpotlightProperties

Son las propiedades de SpeakerSpotlight.

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

object (Outline)

Es el contorno de Orador destacado. Si no se configura, no tiene contorno.
shadow

object (Shadow)

Sombra de Orador destacado. Si no se configura, no tiene sombra.

SlideProperties

Son 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

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

string

Es el ID de objeto del patrón en el que se basa esta diapositiva. Esta propiedad es de solo lectura.
notesPage

object (Page)

Es la página de notas con la que se asocia 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 de marcador de posición con el tipo BODY en la página de notas contiene las notas del orador para 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

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 patrón en el que se basa este diseño.
name

string

Es el nombre del diseño.
displayName

string

Es el nombre del diseño legible por humanos.

NotesProperties

Son 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 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. La acción presentations.get o pages.get siempre devolverá el ID de objeto más reciente.

MasterProperties

Son 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 por humanos del master.

PageProperties

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

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

object (ColorScheme)

Es el esquema de colores de la página. Si no se configura, el esquema de color se hereda de una página principal. Si la página no tiene un elemento superior, el esquema de color usa un esquema de color predeterminado de Presentaciones, que coincide con los valores predeterminados del editor de Presentaciones.

Solo se pueden editar los colores concretos de los primeros 12 ThemeColorTypes. Además, solo se puede actualizar el esquema de color de las páginas de Master. Para actualizar el campo, se debe proporcionar un esquema de color que contenga asignaciones de 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),

  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
}
Campos
propertyState

enum (PropertyState)

Es el estado de la propiedad de relleno de fondo.

Si actualizas el relleno de una página, este campo se actualizará de forma implícita 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án todos los demás campos de relleno establecidos en la misma solicitud.
Es el tipo de relleno de fondo. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
solidFill

object (SolidFill)

Relleno de color sólido.
stretchedPictureFill

object (StretchedPictureFill)

Relleno de imagen estirada.
Fin de los campos mutuamente excluyentes.

StretchedPictureFill

Es 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:

Es la URL de una imagen con una vida útil predeterminada de 30 minutos. Esta URL está etiquetada con la cuenta del solicitante. Cualquier persona que tenga la URL 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 el valor de contentUrl:

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 fotos 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.
size

object (Size)

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

ColorScheme

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

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

object (ThemeColorPair)

Es el ThemeColorType y los pares de colores concretos correspondientes.

ThemeColorPair

Es un par que asigna un tipo de color del 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.

CommentAnchor

Contiene una lista de todas las ubicaciones de un Page que están ancladas a un CommentThread a través del mismo anchorId. Es posible que varios anclajes separados hagan referencia a la misma ubicación, ya sea dentro de un Page o en diferentes páginas.

Representación JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Campos
anchorId

string

Solo salida. Es el ID único de la referencia del comentario.
objectAnchors[]

object (ObjectAnchor)

Solo salida. Son todas las ubicaciones basadas en el ID del objeto dentro de una página que hacen referencia al ID del ancla.

ObjectAnchor

Representa los datos de anclaje de comentarios vinculados a un objeto de Slides, por ejemplo, un Page o un PageElement.

Representación JSON 
{
  "objectId": string,

  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
}
Campos
objectId

string

Solo salida. Es la página o el elemento de página al que se ancla el hilo de comentarios.
Solo salida. Son los rangos de texto dentro del elemento de la página al que se ancla el hilo de comentarios. Estará vacío si el anclaje del comentario es para toda la página o el elemento de página, en lugar de un rango de texto dentro del elemento. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
shapeTextAnchors

object (ShapeTextAnchors)

Se completa para Shapes que tienen comentarios anclados a rangos de texto en [text][google.apps.slides.v1.Shape.TextContent] de la forma.
tableCellAnchors

object (TableCellAnchors)

Se completa para Tables que tienen comentarios anclados a rangos de texto en una o más celdas de la tabla.
Fin de los campos mutuamente excluyentes.

ShapeTextAnchors

Representa rangos de texto dentro de una forma cubierta por un ancla de comentario.

Representación JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campos
ranges[]

object (TextRange)

Es una lista de rangos de texto cubiertos por el ancla del comentario.

TextRange

Especifica un rango contiguo de texto dentro de la text de una forma o celda de tabla.

Representación JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Campos
startIndex

integer

Índice basado en cero del rango inicial. Este campo es un Int32Value para admitir futuros casos de uso con rangos abiertos.
endIndex

integer

Índice basado en cero del final del rango. Este campo es un Int32Value para admitir futuros casos de uso con rangos abiertos.

TableCellAnchors

Representa los rangos de celdas de la tabla dentro de una tabla cubierta por un anclaje de comentario.

Representación JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Campos
cellRanges[]

object (TableCellTextRanges)

Es una lista de todas las celdas de una tabla que tienen texto cubierto por el ancla en la tabla.

TableCellTextRanges

Representa los rangos de texto dentro de una celda de la tabla que abarca un ancla de comentario.

Representación JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campos
cellLocation

object (TableCellLocation)

Ubicación de la celda de la tabla.
ranges[]

object (TextRange)

Es una lista de todos los rangos de texto cubiertos por el ancla en esta celda.

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 devuelve una URL a la imagen de la miniatura.