Lecture de base

L'API Google Slides vous permet de lire les données de présentation, de page et d'élément de page. La les exemples de cette page montrent comment effectuer des opérations de lecture courantes à l'aide des presentations.get et presentations.pages.get méthodes.

Ces exemples utilisent les espaces réservés suivants:

  • PRESENTATION_ID : indique où vous fournissez le présentation ID. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
  • PAGE_ID : indique où vous fournissez l'objet Page ID. Vous pouvez récupérer la valeur à partir de l'URL ou à l'aide d'une requête de lecture d'API.

Ces exemples sont présentés comme des requêtes HTTP afin de ne pas tenir compte du langage. La exemples lus à partir de cet exemple présentation, dont la valeur est 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc PRESENTATION_ID Le PAGE_ID de première diapositive dans cette présentation est ge63a4b4_1_0.

Dans les exemples présentés ici, des masques de champ ne servent qu'à renvoyer les informations spécifiques demandées sur la présentation, la diapositive et la page . L'utilisation de masques de champ permet également d'améliorer les performances.

Afficher les ID d'objet des diapositives

Les éléments suivants : Code presentations.get montre comment récupérer la liste de tous les ID d'objets de diapositives à partir du présentation. Les ID sont renvoyés dans l'ordre de présentation des diapositives et peuvent être utilisée pour indiquer des diapositives spécifiques dans les requêtes API ultérieures. Vous pouvez obtenir les identifiants 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 permettant de lire les ID d'objets de diapositives:

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

La réponse se compose d'un Presentation contenant les identifiants d'objets 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

Les éléments suivants : presentations.pages.get exemple de code montrant comment récupérer une liste d'ID d'objets pour tous les éléments de la page sur une page.

Voici le protocole de requête permettant de lire les ID d'objet d'élément 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 d'une page

Les éléments suivants : presentations.pages.get exemple de code montre comment récupérer une liste Shapes sur une page. Vous pouvez récupérer d'autres PageElement en les spécifiant à l'aide du paramètre fields. Par exemple : fields=pageElements(line,table) renvoie uniquement des informations sur line et table éléments de la page, 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 la page. qui ne sont pas du type de forme ; dans ce cas, ce sont des é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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}