REST Resource: presentations.pages

Recurso: página

Uma página em uma apresentação.

Representação 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

O ID de objeto desta página. Os IDs de objeto usados por Page e PageElement compartilham o mesmo namespace.
pageType

enum (PageType)

O tipo da página.
pageElements[]

object (PageElement)

Os elementos da página renderizados.
revisionId

string

Apenas saída. O ID de revisão da apresentação. Pode ser usado em solicitações de atualização para declarar que a revisão da apresentação não foi alterada desde a última operação de leitura. Só é preenchida se o usuário tiver acesso para editar a apresentação.

O ID da revisão não é um número sequencial, mas uma string opaca. O formato do ID de revisão pode mudar com o tempo. Um ID de revisão retornado é válido somente por 24 horas após ser retornado e não pode ser compartilhado entre os usuários. Se o ID de revisão não foi alterado entre as chamadas, a apresentação não foi alterada. Por outro lado, um ID alterado (para a mesma apresentação e usuário) geralmente significa que a apresentação foi atualizada. No entanto, um ID alterado também pode ser devido a fatores internos, como mudanças no formato do ID.
pageProperties

object (PageProperties)

Propriedades da página.
Campo de união properties. Propriedades específicas para cada tipo de página. Mestres não exigem propriedades adicionais. properties pode ser apenas de um dos tipos a seguir:
slideProperties

object (SlideProperties)

Propriedades específicas do slide. Defina apenas se pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Propriedades específicas do layout. Definido apenas se pageType = LAYOUT.
notesProperties

object (NotesProperties)

Observa propriedades específicas. Defina apenas se pageType = NOTES.
masterProperties

object (MasterProperties)

Propriedades específicas do mestre. Defina apenas se pageType = MASTER.

PageType

O tipo de uma página.

Enums
SLIDE Uma página de slide.
MASTER Uma página de slide mestre.
LAYOUT Uma página de layout.
NOTES Uma página de notas.
NOTES_MASTER Uma página mestra de notas.

PageElement

Um elemento visual renderizado em uma página.

Representação 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

O ID de objeto deste elemento de página. Os IDs de objeto usados por google.apps.slides.v1.Page e google.apps.slides.v1.PageElement compartilham o mesmo namespace.
size

object (Size)

O tamanho do elemento de página.
transform

object (AffineTransform)

A transformação do elemento de página.

A aparência do elemento de página é determinada pela transformação absoluta. Para calcular a transformação absoluta, preconcatene a transformação de um elemento de página com as transformações de todos os grupos pais. Se o elemento de página não estiver em um grupo, sua transformação absoluta será igual ao valor nesse campo.

A transformação inicial da Group recém-criada é sempre a transformação de identidade.
title

string

O título do elemento de página. Combinado com a descrição para exibir texto alternativo.

O campo não é compatível com elementos Group.
description

string

A descrição do elemento de página. Combinado com o título para exibir o texto alternativo.

O campo não é compatível com elementos Group.
Campo de união element_kind. O tipo de elemento que este PageElement representa. Cada mensagem contém propriedades específicas para esse tipo de elemento de página. element_kind pode ser apenas de um dos tipos a seguir:
elementGroup

object (Group)

Uma coleção de elementos de página unidos como uma única unidade.
shape

object (Shape)

Um formato genérico.
image

object (Image)

Um elemento de página de imagem.
video

object (Video)

Um elemento de página de vídeo.
line

object (Line)

Um elemento de página de linha.
table

object (Table)

Um elemento de página da tabela.
wordArt

object (WordArt)

Um elemento de página de Word Art.
sheetsChart

object (SheetsChart)

Um gráfico vinculado incorporado do Planilhas Google. Os gráficos desvinculados são representados como imagens.
speakerSpotlight

object (SpeakerSpotlight)

Um apresentador em destaque.

Grupo

Um tipo PageElement que representa uma coleção mesclada de PageElements.

Representação JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Campos
children[]

object (PageElement)

A coleção de elementos do grupo. O tamanho mínimo de um grupo é 2.

WordArt

Um tipo PageElement que representa o Word Art.

Representação JSON 
{
  "renderedText": string
}
Campos
renderedText

string

O texto renderizado como Word Art.

SpeakerSpotlight

Um tipo PageElement que representa um "Apresentador em destaque".

Representação JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Campos
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

As propriedades do Apresentador em destaque.

SpeakerSpotlightProperties

As propriedades de SpeakerSpotlight.

Representação JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Campos
outline

object (Outline)

O contorno do Apresentador em destaque. Se não for definido, ele não terá contorno.
shadow

object (Shadow)

A sombra do Apresentador em destaque. Se ela não for definida, não haverá sombra.

SlideProperties

As propriedades de Page que são relevantes apenas para páginas com pageType SLIDE.

Representação JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Campos
layoutObjectId

string

O ID de objeto do layout no qual este slide se baseia. Esta propriedade é somente leitura.
masterObjectId

string

O ID de objeto do mestre no qual este slide se baseia. Esta propriedade é somente leitura.
notesPage

object (Page)

A página de notas a que este slide está associado. Define a aparência visual da página de anotações ao imprimir ou exportar slides com as anotações do apresentador. Uma página de notas herda propriedades de notes master. A forma do marcador de posição com o tipo BODY na página de notas contém as anotações do apresentador deste slide. O ID desse polígono é identificado pelo campo speakerNotesObjectId. A página de anotações é somente leitura, exceto o conteúdo de texto e os estilos da forma das anotações do apresentador. Esta propriedade é somente leitura.
isSkipped

boolean

Indica se o slide é ignorado no modo de apresentação. O padrão é "false".

LayoutProperties

As propriedades de Page são relevantes apenas para páginas com pageType LAYOUT.

Representação JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Campos
masterObjectId

string

O ID de objeto do mestre no qual este layout é baseado.
name

string

O nome do layout.
displayName

string

O nome legível do layout.

NotesProperties

As propriedades de Page que são relevantes apenas para páginas com pageType NOTES.

Representação JSON 
{
  "speakerNotesObjectId": string
}
Campos
speakerNotesObjectId

string

O ID de objeto da forma nesta página de notas que contém as anotações do apresentador para o slide correspondente. O formato real nem sempre estará na página de notas. Inserir texto usando esse ID de objeto cria a forma automaticamente. Nesse caso, a forma real pode ter um ID de objeto diferente. A ação presentations.get ou pages.get sempre retornará o ID do objeto mais recente.

MasterProperties

As propriedades de Page que são relevantes apenas para páginas com pageType MASTER.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

O nome legível do mestre.

PageProperties

As propriedades de Page.

A página herdará as propriedades da página principal. Dependendo do tipo de página, a hierarquia é definida em SlideProperties ou LayoutProperties.

Representação JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Campos
pageBackgroundFill

object (PageBackgroundFill)

O preenchimento do plano de fundo da página. Se não for definido, o preenchimento do plano de fundo será herdado de uma página pai, se existir. Se a página não tiver um pai, o preenchimento do plano de fundo será o padrão correspondente no editor das Apresentações.
colorScheme

object (ColorScheme)

O esquema de cores da página. Se não for definido, o esquema de cores será herdado de uma página principal. Se a página não tiver um elemento pai, o esquema de cores vai usar o padrão do app Apresentações Google, que corresponde aos padrões do editor das Apresentações.

Somente as cores concretas das primeiras 12 ThemeColorTypes são editáveis. Além disso, apenas o esquema de cores em páginas Master pode ser atualizado. Para atualizar o campo, é necessário fornecer um esquema de cores que contenha mapeamentos de todos os 12 primeiros ThemeColorTypes para suas cores concretas. As cores dos ThemeColorTypes restantes serão ignoradas.

PageBackgroundFill

O preenchimento do plano de fundo da página.

Representação 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)

O estado da propriedade de preenchimento do plano de fundo.

Atualizar o preenchimento em uma página atualiza esse campo implicitamente para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para não ter preenchimento em uma página, defina esse campo como NOT_RENDERED. Nesse caso, todos os outros campos de preenchimento definidos na mesma solicitação serão ignorados.
Campo de união kind. O tipo de preenchimento do plano de fundo. kind pode ser apenas de um dos tipos a seguir:
solidFill

object (SolidFill)

Preenchimento de cor sólida.
stretchedPictureFill

object (StretchedPictureFill)

Preenchimento de imagem ampliado.

StretchedPictureFill

A imagem esticada preenchida. A página ou o elemento da página está totalmente preenchido com a imagem especificada. A imagem é esticada para caber no próprio contêiner.

Representação JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Campos
contentUrl

string

Como ler o contentUrl:

URL de uma imagem com duração padrão de 30 minutos. Esse URL está codificado com a conta do solicitante. Qualquer pessoa com o URL acessa a imagem como o solicitante original. O acesso à imagem pode ser perdido se as configurações de compartilhamento da apresentação mudarem.

Escrever o contentUrl:

A imagem é buscada uma vez no momento da inserção e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.

O URL fornecido pode ter no máximo 2 KB de comprimento.
size

object (Size)

O tamanho original do preenchimento da imagem. Este campo é somente leitura.

ColorScheme

A paleta de cores predefinidas de uma página.

Representação JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Campos
colors[]

object (ThemeColorPair)

O ThemeColorType e os pares de cores concretas correspondentes.

ThemeColorPair

Um par que mapeia um tipo de cor de tema para a cor concreta que representa.

Representação JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Campos
type

enum (ThemeColorType)

Tipo de cor do tema.
color

object (RgbColor)

A cor concreta correspondente ao tipo de cor do tema acima.

Métodos

get

 Extrai a versão mais recente da página especificada na apresentação.

getThumbnail

 Gera uma miniatura da versão mais recente da página especificada na apresentação e retorna um URL para a imagem em miniatura.