L'API Slides vous permet de lire des données de présentation, de page et d'élément de page. Les exemples de cette page montrent comment effectuer des opérations de lecture courantes à l'aide des méthodes presentations.get et presentations.pages.get.
Ces exemples utilisent les variables suivantes:
- presentationId : indique l'endroit où vous fournissez l'ID de présentation. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
- pageId : indique où vous fournissez l'ID d'objet de page. Vous pouvez récupérer la valeur à partir de l'URL ou d'une requête de lecture de l'API.
Ces exemples sont lus à partir de cette présentation,
qui a 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc comme
presentationId. Le pageId de la première diapositive de cette présentation est ge63a4b4_1_0.
Dans les exemples ci-dessous, les masques de champ ne renvoient que les informations demandées spécifiques concernant la présentation, les diapositives et les éléments de la page. L'utilisation de masques de champ de cette manière améliore les performances.
Afficher les ID d'objet de diapositive
La requête presentations.get suivante récupère la liste de tous les ID d'objet de diapositive de la présentation.
Les ID sont renvoyés dans l'ordre de présentation des diapositives et peuvent être utilisés pour indiquer des diapositives spécifiques dans les requêtes API ultérieures. Vous pouvez obtenir les ID d'objet des pages maîtres et de la page de la même manière en utilisant fields=masters.objectId et fields=layout.objectId.
GET https://slides.googleapis.com/v1/presentations/presentationId?fields=slides.objectId
La réponse à cet appel de méthode est un objet Presentation contenant les composants demandés:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Lire les ID d'objet d'élément à partir d'une page
La requête presentations.pages.get suivante récupère une liste d'ID d'objets pour tous les éléments d'une page.
GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?fields=pageElements.objectId
La réponse à cet appel de méthode est un objet Page contenant les composants demandés:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Lire les éléments de forme d'une page
La requête presentations.pages.get suivante récupère la liste de tous les éléments de forme d'une page. Vous pouvez récupérer d'autres genres d'éléments de page en les spécifiant à l'aide du paramètre fields. Par exemple, fields=pageElements(line,table) ne renvoie que des informations sur les éléments de ligne line et table, le cas échéant.
Le protocole de requête de cet exemple est présenté ci-dessous.
GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?fields=pageElements.shape
La réponse à cet appel de méthode est un objet Page contenant les composants demandés. Les accolades vides indiquent des éléments de page qui ne sont pas du type de forme. Dans ce cas, il s'agit d'éléments de page d'image.
{
"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
}
}
}
]
}
}
},
...
]
}