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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
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 se actualizó la presentación. 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 propaga si la página se recuperó a través de un GetPageRequest con un commentsViewMode propagado. De lo contrario, los comentarios se muestran en Presentation a través de GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Solo salida. Es el modo de vista de comentarios aplicado a la página. Solo se propaga si la página se recuperó a través de un GetPageRequest con un commentsViewMode propagado.

Son las propiedades específicas de cada tipo de página. Los elementos principales no requieren propiedades adicionales. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
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)

Domina propiedades específicas. Solo se establece si pageType = MASTER.
Fin de los campos mutuamente exclusivos.

PageType

Es el tipo de página.

Enums
SLIDE Ser una página de diapositiva
MASTER Ser una página de diapositiva principal
LAYOUT Es 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 que se renderiza en una página.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
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 la página no está en un grupo, su transformación absoluta es la misma que el valor de este campo.

La transformación inicial del 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 se admite para 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 se admite para los elementos Group.
Es el tipo de elemento que representa este PageElement. Cada mensaje contiene las propiedades específicas de ese tipo de elemento de la página. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
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)

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 exclusivos.

Grupo

Es un tipo de 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 arte de palabras.

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 establece, 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 del 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 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

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 legible del diseño.

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 del elemento principal.

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 colores 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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
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. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
solidFill

object (SolidFill)

Relleno de color sólido.
stretchedPictureFill

object (StretchedPictureFill)

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

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 una asignación de 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 en 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. 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 Presentaciones, por ejemplo, un Page o un PageElement.

Representación JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
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. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
shapeTextAnchors

object (ShapeTextAnchors)

Se completa para los 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 exclusivos.

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 que abarca 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 tabla que abarca un anclaje 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 que abarca 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.