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 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 de página renderizados na página.

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 mudou desde a última operação de leitura. Só é preenchido se o usuário tem 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 ao longo do tempo. O ID de revisão retornado é válido somente por 24 horas após ter sido devolvido 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 mudou. Por outro lado, um ID alterado (para a mesma apresentação e usuário) normalmente significa que a apresentação foi atualizada. No entanto, um ID alterado também pode ser devido a fatores internos, como mudanças de formato.

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)

Deslize as propriedades específicas. Defina somente se pageType = SLIDE.

layoutProperties

object (LayoutProperties)

Propriedades específicas de layout. Defina apenas se pageType = LAYOUT.

notesProperties

object (NotesProperties)

Observações sobre propriedades específicas. Defina somente se pageType = NOTES.

masterProperties

object (MasterProperties)

Domine propriedades específicas. Defina apenas se pageType = MASTER.

Tipo de página

Tipo de 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 mestre de notas.

Elemento de página

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)
  }
  // End of list of possible types for union field element_kind.
}
Campos
objectId

string

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 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, preconcatene a transformação de um elemento de página com as transformações de todos os grupos pai. Se o elemento de página não estiver em um grupo, a transformação absoluta será igual ao valor neste 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 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 exibir texto alternativo.

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

Campo de união element_kind. O tipo de elemento que o 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 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 da página Word Art.

sheetsChart

object (SheetsChart)

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

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.

Propriedades Slide

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

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 no qual 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 visual de uma página de notas durante a impressão ou exportação de slides com anotações do apresentador. Uma página de notas herda propriedades do notes master. A forma do marcador com o tipo Body na página de notas contém as anotações do apresentador deste slide. O ID desse formato é identificado pelo campo speakerNotesObjectId. A página de notas é somente leitura, exceto pelo conteúdo de texto e estilos do formato 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 o pageType LAYOUT.

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

string

O ID do objeto do mestre em que este layout é baseado.

name

string

O nome do layout.

displayName

string

O nome legível do layout.

Propriedades de observações

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 notas que contém as anotações do apresentador do slide correspondente. O formato real nem sempre existe na página de notas. Inserir texto usando esse ID de objeto criará automaticamente a forma. Nesse caso, o formato real pode ter um ID de objeto diferente. A ação presentations.get ou pages.get sempre retornará o ID do objeto mais recente.

Propriedades mestres

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

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

string

Nome legível do mestre.

Propriedades de página

As propriedades de Page.

A página herda as 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 for definido, o preenchimento do segundo plano será herdado de uma página mãe, se existir. Se a página não tiver pai, o preenchimento do plano de fundo será definido como o preenchimento correspondente no editor do Apresentações por padrão.

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 página mãe, o esquema de cores vai usar um esquema padrão correspondente ao padrão do editor do Apresentações.

Somente 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 os mapeamentos dos primeiros 12 ThemeColorTypes em suas cores concretas. As cores dos ThemeColorTypes restantes serão ignoradas.

Plano de fundo de preenchimento da página

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 em segundo plano.

A atualização do preenchimento em uma página atualizará implicitamente esse campo para RENDERED, a menos que outro valor seja especificado na mesma solicitação. Para que não haja preenchimento em uma página, defina esse campo como NOT_RENDERED. Nesse caso, quaisquer 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 estendido de imagem.

Filme preenchido

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

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

string

Como ler o contentUrl:

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

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.

size

object (Size)

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

Esquema de cores

A paleta de cores predefinidas para 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 associando um tipo de cor do tema à cor concreta que ele 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

Acessa 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 de miniatura.