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 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 declarar que a revisão da apresentação não foi alterada desde a última operação de leitura. Preenchido apenas se o usuário tiver acesso para editar a apresentação.

O ID de 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 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 de revisão não for alterado entre 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)

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. Defina somente se pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Propriedades específicas do layout. Defina somente se pageType = LAYOUT.

notesProperties

object (NotesProperties)

Observa propriedades específicas. Definido apenas se pageType = NOTES.

masterProperties

object (MasterProperties)

Propriedades específicas do mestre. 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 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 desse 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, pré-concatena 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 do Group recém-criado é sempre a transformação de identidade.

title

string

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

O campo não tem suporte para elementos Group.

description

string

A descrição do elemento de 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 desse 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 da 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 do Planilhas Google. Os gráficos desvinculados são representados como imagens.

speakerSpotlight

object (SpeakerSpotlight)

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 no grupo. O tamanho mínimo de um grupo é 2.

WordArt

Um tipo de 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

Propriedades do SpeakerSpotlight.

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

object (Outline)

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 não for definido, ele não terá 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 no qual este slide se baseia. 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 notas a que este slide está associado. Ela define a aparência de uma página de notas ao imprimir ou exportar slides com as anotações do apresentador. A 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 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

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 do objeto do mestre em que este 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 de objeto da forma nesta página de notas que contém as anotações do apresentador para o slide correspondente. A forma real nem sempre existe na página de notas. Inserir texto usando esse ID de objeto criará 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 de 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

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 do plano de fundo será herdado de uma página pai, se houver. Se a página não tiver um pai, o preenchimento do plano de fundo será o padrão no editor do 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 mãe. Se a página não tiver um pai, o esquema de cores vai usar o padrão do app Apresentações, que corresponde aos padrões do editor do app.

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 contendo mapeamentos de todos os primeiros 12 ThemeColorTypes para as 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 de uma página atualiza implicitamente este 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 do plano de fundo. kind pode ser apenas de um dos tipos a seguir:
solidFill

object (SolidFill)

Preenchimento com cor sólida.

stretchedPictureFill

object (StretchedPictureFill)

Preenchimento de imagem esticado.

StretchedPictureFill

O preenchimento de imagem esticada. O elemento de página ou página está totalmente preenchido com a imagem especificada. A imagem é esticada para caber no contêiner.

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

string

Lendo o contentUrl:

Um URL para uma imagem com vida útil padrão de 30 minutos. Esse URL está codificado com a conta do solicitante. Qualquer pessoa com o URL acessa efetivamente a imagem como o solicitante original. O acesso à imagem poderá 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 na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e 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 de concreto correspondentes.

ThemeColorPair

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

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

enum (ThemeColorType)

O tipo de 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 em miniatura.