Para usar a Slides API da melhor forma, você precisa entender as a arquitetura de apresentações e seus componentes, bem como as interações entre esses componentes. Esta página fornece uma visão geral detalhada desses tópicos:
- Modelo conceitual dos componentes da apresentação
- Como a API representa esses componentes
- Propriedades de estilo dos componentes
Leia esta e as outras visões gerais de conceitos para entender melhor e use os guias de instruções, os guias de referência documentação e a receita de amostra.
Apresentações, páginas e elementos de página
O elemento do contêiner mais externo das Apresentações Google é uma apresentação. Isso é a unidade que pode ser salva no Google Drive, compartilhada com outros usuários, e assim por diante.
Cada apresentação contém vários tipos de páginas. Um tipo de página é um um slide, que são as páginas que os usuários ver e alternar entre os momentos em que a apresentação é renderizada em uma tela.
Cada página contém vários elementos de página que, juntos, compõem o conteúdo da página, conforme mostrado no diagrama a seguir:
Além dos slides, há outros tipos de páginas que permitem aplicar design a slides diferentes, criando uma aparência consistente. Esses outros tipos de página são masters e layouts, e as propriedades deles determinam a forma como os slides renderizado, como mostrado no diagrama a seguir:
Masters: a página mestra tem duas finalidades. Marcadores de posição no mestre contêm os padrões para os estilos de texto usados em toda a apresentação. A plano de fundo e quaisquer outras formas no slide mestre compõem o padrão contexto de todos os slides com base nesse mestre. Se você tem um logotipo de empresa que você quer que apareça em todos os slides de sua apresentação, coloque-o no mestre.
Layouts: os modelos de layout determinam como o conteúdo é organizado em cada tipo. do slide. Se você quiser que todos os seus slides de título tenham uma determinada aparência, por por exemplo, edite o modelo de layout do título.
Há mais dois tipos de página: páginas de notas e mestres de notas, que são mais relevantes para trabalhar com as notas do apresentador.
Tipos e estrutura de representação da API
Esta seção descreve como o modelo conceitual do Apresentações Google, conforme descrito acima, está representado na Slides API.
O diagrama a seguir mostra a relação entre apresentações, páginas e elementos de página como tipos na Slides API:
As seções a seguir mostram como esses tipos são representados em JSON.
Apresentações
Uma apresentação inclui um número de propriedades e contém as páginas que estão nele:
{
"presentationId": string,
"pageSize": { object(Size) },
"slides": [ { object(Page) } ],
"title": string,
"masters": [ { object(Page) } ],
"layouts": [ { object(Page) } ],
"notesMaster": object(Page),
"locale": string,
}
Pages
Uma página inclui um conjunto de e contém os elementos de página que estão nele:
{
"objectId": string,
"pageType": enum(PageType),
"pageElements": [ { object(PageElement) } ],
"pageProperties": { object(PageProperties) },
// Union field properties can be only one of the following:
"slideProperties": { object(SlideProperties) },
"layoutProperties": { object(LayoutProperties) },
"notesProperties": { object(NotesProperties) },
// End of list of possible types for union field properties.
}
Elementos de página
Elementos de página são os componentes visuais colocados nas páginas. Um elemento de página na API contém diversas propriedades, incluindo um campo que varia de acordo com as tipo de elemento de página:
{
"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.
}
Há vários tipos de elementos de página, conforme definido pelo campo de união
element_kind na definição acima. Esses tipos de elementos de página são
descritos na tabela a seguir:
| Tipo do elemento | Descrição |
|---|---|
| Grupo | Um conjunto de elementos de página tratados como uma unidade. Eles podem ser movidos, dimensionados e girados em conjunto. |
| Forma | Um objeto visual simples, como retângulos, elipses e caixas de texto. As formas podem conter texto, por isso são os elementos de página mais comuns na criação de slides. |
| Imagem | Uma imagem importada para o app Apresentações. |
| Vídeo | Um vídeo importado para as Apresentações. |
| Linha | Uma linha, curva ou conector visual. |
| Tabela | Uma grade de conteúdo. |
| WordArt | Um elemento de texto visual que se comporta de forma parecida com uma forma. |
| SheetsChart | Um gráfico do Planilhas Google importado para o Apresentações. |
Propriedades de página e elemento de página
A Slides API permite ler e atualizar a aparência das páginas e das elementos na sua apresentação. Diferentes elementos de página são compatíveis propriedades diferentes que controlam como o elemento de página é renderizado.
Cada tipo de elemento de página tem um elemento de propriedades correspondente e uma propriedade de atualização, por exemplo:
- Há um tipo de elemento de página Forma.
- O campo de propriedade é shapeProperties
- A solicitação para atualizar essas propriedades é UpdateShapePropertiesRequest
O mesmo conjunto de elementos/propriedades/solicitação de atualização existe para cada elemento de página Tipo: Image/imageProperties/UpdateImageProperties, e assim por diante.
Você pode ler o atributo de propriedades sempre que o encontrar ao ler um element; para alterar os valores nele, use-o com o tipo de solicitação correspondente como o payload para a operação batchUpdate , permitindo alterar esses valores na apresentação.
Tipos de propriedade
Há algumas propriedades comuns entre vários tipos de objetos em API Slides:
| Propriedade | Descrição |
|---|---|
| Cor | As cores na Slides API podem ser um valor RGB ou uma referência à cor de um tema. As cores de tema são chamadas pelo nome (por exemplo, "DARK1") e podem ser mapeadas para valores RGB usando o esquema de cores de uma página. Esse esquema de cores é frequentemente atualizado ao alterar o tema da apresentação no editor do Apresentações. |
| Preenchimento | O preenchimento representa a renderização de espaço vazio dentro de um objeto. O preenchimento mais comumente aceito no app Apresentações é o sólido, em que o interior de um objeto é preenchido com uma única cor sólida. Os preenchimentos também podem ser usados para o plano de fundo das Páginas. |
| Contorno | O contorno representa o conjunto de linhas em volta do elemento de página. A cor das linhas é controlada com um preenchimento. Os autores da chamada também podem ajustar a largura e o estilo do traço do contorno. |
| Sombra | A sombra representa um efeito visual destinado a imitar uma sombra física projetada pelo objeto. No momento, as sombras na API Slides são somente leitura. |
Como atualizar propriedades
Para atualizar uma propriedade, use o método
Update...Properties em um
batchUpdate
chamada, por exemplo, UpdateShapeProperties para Formas. Essas solicitações
aceitam uma mensagem de propriedades completa e podem usar
máscaras de campo para determinar quais campos na
de propriedades do Terraform precisa ser atualizada.
Herança da propriedade
Uma página ou um elemento de página pode herdar propriedades de seus objetos pai. Um das propriedades do objeto, incluindo as que ele define e as que herda, determina sua aparência visual final.
- Propriedades da página: uma página herda as propriedades não herdadas definem, mas são definidos no layout ou no mestre em que se baseia.
- Propriedades da forma: uma forma pode ser marcada como um marcador, permitindo fazer referência explícita a outra forma de marcador (no layout pai da página ou mestre) das quais herdar propriedades.
Essas ideias são explicadas mais detalhadamente nos parágrafos a seguir.
Herança de propriedades de página
A estrutura de slides, layouts e masters define uma hierarquia de herança na apresentação: slides herdam de layouts, e layouts herdam de layouts mestres. O layout pai e mestre de um slide são especificados no slideProperties .
Uma página pode herdar propriedades, como plano de fundo e esquema de cores, de uma página principal. Para herdar uma propriedade, a página secundária simplesmente não define um o valor dessa propriedade na PageProperties mensagem. Ao não "substituir" o valor definido pelo pai, a página aceita o valor herdado.
O diagrama a seguir mostra um slide que herda as propriedades de um layout, o que herda de um mestre:
As propriedades usadas para renderizar um slide são uma combinação das que ele define e as herdadas. Neste exemplo, os valores resolvidos usados para renderizar o Slide 1 são os seguintes:
- A propriedadeA é "vermelha".
- A propriedadeB é "laranja".
Herança de propriedades de forma
As formas podem herdar propriedades, como preenchimento, contorno ou sombra, de outras
formas. Uma forma é um marcador de posição se
Shape.placeholder
está definido. O campo Shape.placeholder.parentObjectId do marcador de posição filho
identifica o marcador de posição pai. Quando você cria um novo slide com base em
todos os marcadores desse layout vão aparecer como formas secundárias no novo slide.
Da mesma forma, os marcadores de posição nas páginas mestras podem atuar como pais dos layouts
espaços reservados.
Com essa hierarquia de herança definida, a página filha herda uma propriedade ao não definir esse valor em seu ShapeProperties mensagem. Ao não substituir o valor definido pelo pai, a forma secundária aceita o valor herdado.
O diagrama a seguir mostra a herança de propriedades entre três marcadores de posição contidos em um slide, um layout e um mestre:
As propriedades usadas para renderizar uma forma de marcador de posição são uma combinação das que ela define e aqueles que herda. Neste exemplo, os valores resolvidos as formas são as seguintes:
- Marcador 1: a propriedadeA é renderizada como "amarelo" e a propriedadeB como "verde".
- Marcador 2: a propriedadeA é renderizada como "amarelo" e a propriedadeB como "roxa".
- Marcador 3: a propriedadeA é renderizada como "amarelo" e a propriedadeB como "roxa".
As formas são o único tipo de elemento de página que pode ter pais. Outros tipos, como imagens, tabelas e gráficos, não podem ser marcadores de posição nem ter pais.
"Ocultando" propriedades usando PropertyState
O PropertyState
enumeração controla se a propriedade de uma forma é realmente usada para renderização,
ou se o valor for usado apenas para herança por formas filhas. Uma propriedade com
o estado de propriedade NOT_RENDERED não será usado ao renderizar a forma na própria
No entanto, as filhas que têm um estado de propriedade correspondente de RENDERED
ainda podem herdar essa propriedade.
O diagrama a seguir mostra a herança de propriedades entre três marcadores que manipulam o campo PropertyState:
A renderização de propriedades da forma pode ser afetada pelo campo PropertyState. Neste exemplo, os valores resolvidos dessas formas são os seguintes:
- Marcador 1: a propriedadeA é renderizada como "vermelho".
- Marcador 2: a propriedadeA não é renderizada. Se fosse a propriedade "outline", O marcador de posição2 não teria contorno.
- Marcador 3: a propriedadeA não é renderizada.
Há mais um valor possível de
O PropertyState
enumeração: o estado da propriedade INHERIT significa que o estado da propriedade
em si é herdado, e o valor do pai deve ser usado. Formas sem
os pais não podem ter um estado de propriedade INHERIT.