L'API Google Slides vous permet de lire les 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 espaces réservés suivants :
- PRESENTATION_ID : indique où vous fournissez l' ID de la présentation. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
- PAGE_ID : indique où vous fournissez l'ID de l'objet de la page. Vous pouvez récupérer la valeur de cet ID à partir de l'URL ou à l'aide d'une requête de lecture de l'API.
Ces exemples sont présentés sous forme de requêtes HTTP pour être indépendants du langage. Les
exemples sont lus à partir de cet exemple
de présentation,
dont l'ID PRESENTATION_ID est 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc. Le PAGE_ID de la
première
diapositive
de cette présentation est ge63a4b4_1_0.
Les exemples présentés ici utilisent des masques de champ pour ne renvoyer que les informations spécifiques demandées sur la présentation, la diapositive et l' élément de page. L'utilisation de masques de champ améliore également les performances.
Lire les ID d'objet de diapositive
L'exemple de code
presentations.get suivant montre comment récupérer la liste de tous les ID d'objet de diapositive de la
présentation. Les ID sont renvoyés dans l'ordre de la présentation des diapositives et peuvent être utilisés pour indiquer des diapositives spécifiques dans les requêtes d'API suivantes. Vous pouvez obtenir les ID d'objet des pages maîtres et de mise en page de la même manière, à l'aide de fields=masters.objectId et fields=layout.objectId.
Voici le protocole de requête pour lire les ID d'objet de diapositive :
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La réponse consiste en un
Presentation
objet contenant les ID d'objet 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
L'exemple de code
presentations.pages.get
suivant montre comment récupérer la liste des ID d'objet de tous les éléments de page
d'une page.
Voici le protocole de requête pour lire les ID d'objet d'élément à partir d'une page :
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
La réponse consiste en un
Page objet
contenant les ID d'objet 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 à partir d'une page
L'exemple de code
presentations.pages.get
suivant montre comment récupérer la liste de toutes les
Shapes
d'une page. Vous pouvez récupérer d'autres
PageElement
types en les spécifiant à l'aide du fields paramètre. Par exemple,
fields=pageElements(line,table) ne renvoie des informations que sur
line et
table
éléments de page, s'ils sont présents sur la page.
Voici le protocole de requête pour lire les éléments de forme à partir d'une page :
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
La réponse consiste en un
Page objet
contenant les éléments de forme demandés. Les accolades vides indiquent les éléments de page qui ne sont pas de type forme. Dans ce cas, il s'agit d'éléments de page 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 } } } ] } } }, ... ] }