L'API Google Slides vous permet de lire les données de présentation, de page et d'éléments 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 l'emplacement où vous devez fournir l'ID de présentation. Vous pouvez trouver la valeur de cet ID dans l'URL de la présentation.
- PAGE_ID : indique où vous devez fournir l'ID de l'objet de la page. Vous pouvez récupérer la valeur correspondante à partir de l'URL ou à l'aide d'une requête de lecture d'API.
Ces exemples sont présentés sous forme de requêtes HTTP pour être neutres en termes de langue. Les exemples lisent cet exemple de présentation, qui utilise 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc comme PRESENTATION_ID. La 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 demandées spécifiques sur la présentation, la diapositive et l'élément de page. L'utilisation de masques de champ permet également d'améliorer les performances.
Lire les ID d'objet des diapositives
L'exemple de code presentations.get suivant montre comment récupérer la liste de tous les ID d'objets 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 des pages de mise en page de la même manière, en utilisant fields=masters.objectId et fields=layout.objectId.
Voici le protocole de requête pour lire les ID d'objets de diapositive:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La réponse se compose d'un objet Presentation 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'objets d'éléments à partir d'une page
L'exemple de code presentations.pages.get suivant montre comment récupérer une liste d'ID d'objets pour tous les éléments de page d'une page.
Voici le protocole de requête permettant de lire les ID d'objets d'éléments à partir d'une page:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
La réponse se compose d'un objet Page 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 tous les Shapes sur une page. Vous pouvez récupérer d'autres genres PageElement en les spécifiant à l'aide du paramètre fields. Par exemple, fields=pageElements(line,table) ne renvoie des informations que sur les éléments de page line et table, le cas échéant.
Voici le protocole de requête permettant de lire les éléments de forme d'une page:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
La réponse se compose d'un objet Page 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 } } } ] } } }, ... ] }