A Google Slides API permite ler dados de apresentações, páginas e elementos de página. A
nesta página mostram como executar operações de leitura comuns usando o método
presentations.get e
presentations.pages.get
métodos.
Esses exemplos usam os seguintes marcadores:
- PRESENTATION_ID: indica onde você fornece apresentação ID. Você pode descobrir o valor desse ID no URL da apresentação.
- PAGE_ID: indica onde você fornece o objeto de página ID. Você pode recuperar o valor dele no URL ou usando uma solicitação de leitura da API.
Esses exemplos são apresentados como solicitações HTTP para serem neutros em relação à linguagem. A
leia este exemplo
apresentação,
que tem 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc como
PRESENTATION_ID. O PAGE_ID do
primeiro
slide
nesta apresentação é ge63a4b4_1_0.
Nestes exemplos, usamos máscaras de campo para retornar informações específicas solicitadas sobre a apresentação, o slide e a página . O uso de máscaras de campo também melhora o desempenho.
Ler IDs de objeto de slides
O seguinte
Código do presentations.get
exemplo mostra como recuperar uma lista de todos os IDs de objeto de slides do
apresentação. Os IDs são retornados na ordem da apresentação de slides e podem ser
usado para indicar slides específicos em solicitações de API subsequentes. Você pode receber
IDs de objeto das páginas mestre e de layout da mesma maneira, usando
fields=masters.objectId e fields=layout.objectId.
Veja a seguir o protocolo de solicitação para ler os IDs de objeto de slides:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
A resposta consiste em um
Presentation
que contém os IDs de objeto solicitados:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Ler IDs de objeto de elementos de uma página
O seguinte
presentations.pages.get
exemplo de código mostra como recuperar uma lista de IDs de objetos para todos os elementos da página
em uma página.
Veja a seguir o protocolo de solicitação para ler IDs de objeto de elementos em uma página:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
A resposta consiste em um
Objeto Page
contendo os IDs de objeto solicitados:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Ler elementos de forma de uma página
O seguinte
presentations.pages.get
exemplo de código mostra como recuperar uma lista de todos
Shapes
em uma página. Você pode recuperar outras
PageElement
os tipos especificando-os usando o parâmetro fields. Por exemplo:
fields=pageElements(line,table) retorna somente informações sobre
line e
table
elementos de página, se houver algum.
Veja a seguir o protocolo de solicitação para ler elementos de forma de uma página:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
A resposta consiste em um
Objeto Page
contendo os elementos de forma solicitados. As chaves vazias indicam os elementos da página
que não são do tipo de forma. nesse caso, são elementos de página de imagem.
{
"pageElements": [
{},
{},
{
"shape": {
"shapeProperties" {
"outline" {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 1,
"color": {
"rgbColor": {}
}
},
},
"propertyState": "NOT_RENDERED",
"weight": {
"magnitude": 9525,
"unit": "EMU"
}
},
"shadow": {
"alignment": "BOTTOM_LEFT",
"alpha": 1,
"blurRadius": {
"unit": "EMU"
},
"color": {
"rgbColor": {}
},
"propertyState": "NOT_RENDERED",
"rotateWithShape": false,
"transform": {
"scaleX": 1,
"scaleY": 1,
"unit": "EMU"
},
"type": "OUTER"
},
"shapeBackgroundFill" : {
"propertyState": "NOT_RENDERED",
"solidFill": {
"alpha": 1,
"color": {
"rgbColor: {
"blue": 1,
"green": 1,
"red": 1
}
}
}
}
},
"shapeType": "TEXT_BOX",
"text": {
"textElements": [
{
"endIndex": 11,
"paragraphMarker": {
"style": {
"alignment": "START",
"direction": "LEFT_TO_RIGHT",
"indentEnd": {
"unit": "PT"
},
"indentFirstLine": {
"unit": "PT"
},
"indentStart": {
"unit": "PT"
},
"lineSpacing": 100,
"spaceAbove": {
"unit": "PT"
},
"spaceBelow": {
"unit": "PT"
},
"spacingMode": "COLLAPSE_LISTS"
}
}
},
{
"endIndex": 11,
"textRun": {
"content": "Baby Album\n",
"style": {
"backgroundColor": {},
"baselineOffset": "NONE",
"bold": false,
"fontFamily": "Arial",
"fontSize": {
"magnitude": 14,
"unit": "PT"
},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {}
}
},
"italic": false,
"smallCaps": false,
"strikethrough": false,
"underline": false
}
}
}
]
}
}
},
...
]
}