Lecture de base

L'API Google Slides vous permet de lire les données des présentations, des pages et des é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'endroit où vous fournissez l'ID de présentation. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de présentation.
  • PAGE_ID : indique l'endroit où vous fournissez l'ID d'objet de page. Vous pouvez récupérer cette valeur à partir de l'URL ou à l'aide d'une requête de lecture API.

Ces exemples sont présentés comme des requêtes HTTP afin d'être indépendants du langage. Les exemples sont lus dans cet exemple de présentation, dont la 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 des informations spécifiques demandées concernant 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 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 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 permettant de 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 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'objet des éléments d'une page

L'exemple de code presentations.pages.get suivant montre comment récupérer la liste des ID d'objet pour tous les éléments d'une page.

Voici le protocole de requête permettant de lire les ID d'objet des éléments d'une page:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId

La réponse consiste en 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 d'une forme sur une page

L'exemple de code presentations.pages.get suivant montre comment récupérer la liste de tous les Shapes d'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 sur les éléments de page line et table que s'ils sont présents sur la page.

Voici le protocole de requête permettant de lire les éléments de forme sur une page:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape

La réponse consiste en un objet Page contenant les éléments de forme demandés. Les accolades vides indiquent les é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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}