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 do objeto dessa 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 na página.
revisionId

string

Apenas saída. O ID da revisão da apresentação. Pode ser usado em solicitações de atualização para afirmar que a revisão da apresentação não mudou desde a última operação de leitura. Só é preenchido se o usuário tiver acesso de edição à apresentação.

O ID da revisão não é um número sequencial, mas uma string opaca. O formato do ID da revisão pode mudar com o tempo. Um ID de revisão retornado tem a garantia de ser válido apenas por 24 horas após ser retornado e não pode ser compartilhado entre usuários. Se o ID da revisão não mudar entre as chamadas, a apresentação não será 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)

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

object (SlideProperties)

Propriedades específicas do slide. Só será definido se pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Propriedades específicas do layout. Só será definido se pageType = LAYOUT.
notesProperties

object (NotesProperties)

Observa propriedades específicas. Só será definido se pageType = NOTES.
masterProperties

object (MasterProperties)

Controle propriedades específicas. Definido apenas se pageType = MASTER.

PageType

O tipo de uma página.

Enums
SLIDE Uma página de slides.
MASTER Uma página de slide mestre.
LAYOUT Uma página de layout.
NOTES Uma página de anotações.
NOTES_MASTER Uma página mestre 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 do objeto para esse elemento da 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 da página.
transform

object (AffineTransform)

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

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

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

string

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

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

string

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

O campo não tem suporte para 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)

Um conjunto de elementos de página reunidos como um único bloco.
shape

object (Shape)

Uma forma genérica.
image

object (Image)

Um elemento de página de imagem.
video

object (Video)

Um elemento da 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 das Planilhas Google. Os gráficos não vinculados são representados como imagens.
speakerSpotlight

object (SpeakerSpotlight)

Um Apresentador em destaque.

Grupo

Um tipo PageElement que representa uma coleção combinada de elementos de página.

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

object (PageElement)

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

WordArt

Um tipo PageElement que representa arte de palavras.

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

string

O texto renderizado como Word Art.

SpeakerSpotlight

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

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

object (SpeakerSpotlightProperties)

As propriedades do recurso "Apresentador em destaque".

SpeakerSpotlightProperties

Propriedades de SpeakerSpotlight.

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

object (Outline)

Contorno do Apresentador em destaque. Se não for definido, não haverá contorno.
shadow

object (Shadow)

A sombra do apresentador em destaque. Se não for definido, 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 do objeto do layout em que este slide é baseado. Esta propriedade é somente leitura.
masterObjectId

string

O ID do objeto do mestre em que este slide se baseia. Esta propriedade é somente leitura.
notesPage

object (Page)

A página de anotações associada a este slide. Ele define a aparência visual de uma página de anotações ao imprimir ou exportar slides com anotações do orador. A página de notas herda propriedades de notes master. A forma de marcador com o tipo BODY na página de notas contém as notas do palestrante para este slide. O ID do polígono é identificado pelo campo speakerNotesObjectId. A página de notas é somente leitura, exceto pelo conteúdo de texto e estilos da forma das anotações do apresentador. Esta propriedade é somente leitura.
isSkipped

boolean

Indica se o slide é pulado 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 do objeto do modelo em que esse layout se baseia.
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 do objeto da forma na página de anotações que contém as notas do palestrante do slide correspondente. A forma real nem sempre está na página de anotações. 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 vai 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 do 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 de plano de fundo será herdado de uma página pai, se houver. Se a página não tiver um pai, o preenchimento de plano de fundo será definido como o preenchimento correspondente no editor de slides.
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 mãe. Se a página não tiver um pai, o esquema de cores vai usar o esquema de cores padrão do Apresentações, correspondendo aos padrões no editor do Apresentações.

Somente as cores concretas das primeiras 12 ThemeColorTypes são editáveis. Além disso, apenas o esquema de cores nas páginas Master pode ser atualizado. Para atualizar o campo, é necessário fornecer um esquema de cores contendo mapeamentos de todos os primeiros 12 ThemeColorTypes para as cores concretas. As cores dos outros ThemeColorTypes 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 vai atualizar implicitamente esse campo 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 de 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 esticada.

StretchedPictureFill

O preenchimento da imagem esticada. A página ou o elemento da página é preenchido inteiramente com a imagem especificada. A imagem é esticada para caber no contêiner.

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

string

Leitura do contentUrl:

Um URL para uma imagem com uma validade padrão de 30 minutos. Esse URL é marcado com a conta do solicitante. Qualquer pessoa com o URL acessa a imagem como o requerente original. O acesso à imagem pode ser perdido se as configurações de compartilhamento da apresentação forem alteradas.

Como gravar o contentUrl:

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

O URL fornecido pode ter no máximo 2 kB.
size

object (Size)

O tamanho original do preenchimento de 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 concretos correspondentes.

ThemeColorPair

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

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

enum (ThemeColorType)

O tipo da cor do tema.
color

object (RgbColor)

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

Métodos

get

 Recebe 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 da miniatura.