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

O ID do 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 garantir que a revisão da apresentação não mudou desde a última operação de leitura. Preenchido somente 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 só é válido por 24 horas após o retorno 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 terá sido alterada. Por outro lado, um ID mudado (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.
commentAnchors[]

object (CommentAnchor)

Apenas saída. Os âncoras de comentários presentes na página.

comments[]

object (CommentThread)

Apenas saída. As conversas associadas à página. Preenchido apenas se a página foi buscada por um GetPageRequest com um commentsViewMode preenchido. Caso contrário, os comentários serão retornados no Presentation pela GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Apenas saída. O modo de visualização de comentários aplicado à página. Preenchido apenas se a página foi buscada por um GetPageRequest com um commentsViewMode preenchido.

Propriedades específicas para cada tipo de página. Os mestres não exigem propriedades adicionais. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

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

object (NotesProperties)

Anota propriedades específicas. Definido apenas se pageType = NOTES.
masterProperties

object (MasterProperties)

Domine propriedades específicas. Definido apenas se pageType = MASTER.
Fim dos campos mutuamente exclusivos.

PageType

O tipo de uma página.

Tipos enumerados
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 principal de anotações.

PageElement

Um elemento visual renderizado em uma página.

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

O ID do objeto para esse 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 visual do elemento de 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 principais. Se o elemento da página não estiver em um grupo, a transformação absoluta será igual ao valor neste 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 de página. Combinado com o título para mostrar o texto alternativo.

O campo não é compatível com elementos Group.
O tipo de elemento que este PageElement representa. Cada mensagem contém propriedades específicas para esse tipo de elemento de página. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
elementGroup

object (Group)

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

object (Shape)

Uma forma genérica.
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 de 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 desvinculados são representados como imagens.
speakerSpotlight

object (SpeakerSpotlight)

Um Apresentador em destaque.
Fim dos campos mutuamente exclusivos.

Grupo

Um tipo PageElement que representa uma coleção unida 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 PageElement que representa word art.

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

string

O texto renderizado como word art.

SpeakerSpotlight

Um tipo PageElement que representa um destaque do orador.

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

object (SpeakerSpotlightProperties)

As propriedades do recurso "Apresentador em destaque".

SpeakerSpotlightProperties

As propriedades do 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, não terá contorno.
shadow

object (Shadow)

A sombra do recurso "Apresentador em destaque". Se não for definido, 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 em que o slide se baseia. Essa propriedade é somente leitura.
masterObjectId

string

O ID do objeto do modelo em que o slide se baseia. Essa propriedade é somente leitura.
notesPage

object (Page)

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

boolean

Se o slide é pulado no modo de apresentação. O padrão é "falso".

LayoutProperties

As propriedades de Page só são relevantes 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 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 do objeto da forma nesta página de anotações que contém as anotações do apresentador para o slide correspondente. A forma real nem sempre existe 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 master.

PageProperties

As propriedades do Page.

A página vai herdar propriedades da página mãe. 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 estiver definido, o preenchimento do plano de fundo será herdado de uma página mãe, se houver. Se a página não tiver um elemento pai, o preenchimento do plano de fundo será o mesmo do editor de 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 uma entidade principal, o esquema de cores vai usar um padrão do Apresentações, que corresponde aos padrões do editor.

Apenas as cores concretas dos primeiros 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 que contenha 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),

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

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.
O tipo de preenchimento de plano de fundo. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
solidFill

object (SolidFill)

Preenchimento com cor sólida.
stretchedPictureFill

object (StretchedPictureFill)

Preenchimento de imagem esticada.
Fim dos campos mutuamente exclusivos.

StretchedPictureFill

O preenchimento de imagem esticada. A página ou o elemento da página é preenchido totalmente 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 um tempo de vida padrão de 30 minutos. Esse URL está marcado com a conta do solicitante. Qualquer pessoa com o URL acessa a foto como o requerente original. O acesso à imagem pode ser perdido se as configurações de compartilhamento da apresentação forem alteradas.

Como 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 fotos 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 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 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 concreta correspondente ao tipo de cor do tema acima.

CommentAnchor

Contém uma lista de todos os locais em um Page ancorados a um CommentThread pelo mesmo anchorId. Várias âncoras separadas podem se referir ao mesmo local, seja em um Page ou em páginas diferentes.

Representação JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Campos
anchorId

string

Apenas saída. O ID exclusivo da âncora do comentário.
objectAnchors[]

object (ObjectAnchor)

Apenas saída. Todos os locais com base no ID do objeto em uma página que se referem ao ID da âncora.

ObjectAnchor

Representa dados de âncora de comentário vinculados a um objeto do Apresentações, por exemplo, um Page ou PageElement.

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

Apenas saída. A página ou o elemento de página a que a sequência de comentários está ancorada.
Apenas saída. Os intervalos de texto no elemento de página a que a conversa está ancorada. Ficará vazio se a âncora do comentário for para a página inteira ou para um elemento de página, em vez de um intervalo de texto dentro do elemento. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
shapeTextAnchors

object (ShapeTextAnchors)

Preenchido para Shapes que têm comentários ancorados a intervalos de texto em [text][google.apps.slides.v1.Shape.TextContent] da forma.
tableCellAnchors

object (TableCellAnchors)

Preenchido para Tables que têm comentários ancorados em intervalos de texto em uma ou mais células da tabela.
Fim dos campos mutuamente exclusivos.

ShapeTextAnchors

Representa intervalos de texto em uma forma coberta por uma âncora de comentário.

Representação JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campos
ranges[]

object (TextRange)

Uma lista de intervalos de texto cobertos pela âncora de comentário.

TextRange

Especifica um intervalo contíguo de texto em uma forma ou text de uma célula de tabela.

Representação JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Campos
startIndex

integer

O índice baseado em zero do intervalo inicial. Esse campo é um Int32Value para acomodar casos de uso futuros com intervalos abertos.
endIndex

integer

O índice com base em zero do fim do intervalo. Esse campo é um Int32Value para acomodar casos de uso futuros com intervalos abertos.

TableCellAnchors

Representa intervalos de células de tabela dentro de uma tabela coberta por uma âncora de comentário.

Representação JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Campos
cellRanges[]

object (TableCellTextRanges)

Uma lista de todas as células de uma tabela que têm texto coberto pela âncora na tabela.

TableCellTextRanges

Representa intervalos de texto em uma célula de tabela coberta por uma âncora de comentário.

Representação JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Campos
cellLocation

object (TableCellLocation)

A localização da célula da tabela.
ranges[]

object (TextRange)

Uma lista de todos os intervalos de texto cobertos pela âncora nesta célula.

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.