Letture di base

L'API Google Slides consente di leggere i dati di presentazioni, pagine ed elementi delle pagine. Gli esempi in questa pagina mostrano come eseguire operazioni di lettura comuni utilizzando i metodi presentations.get e presentations.pages.get.

Questi esempi utilizzano i seguenti segnaposto:

  • PRESENTATION_ID: indica dove fornire l'ID presentazione. Puoi scoprire il valore di questo ID dall'URL della presentazione.
  • PAGE_ID: indica dove fornisci l'ID oggetto pagina. Puoi recuperare il valore da questo URL o utilizzando una richiesta di lettura dell'API.

Questi esempi vengono presentati come richieste HTTP per essere indipendenti dalla lingua. Gli esempi sono tratti da questa presentazione di esempio, che ha 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc come PRESENTATION_ID. Il PAGE_ID della prima slide di questa presentazione è ge63a4b4_1_0.

Gli esempi riportati di seguito utilizzano le maschere dei campi per restituire solo le informazioni specifiche richieste sull'elemento presentazione, slide e pagina. L'utilizzo delle maschere di campo migliora anche il rendimento.

Leggi gli ID oggetto della slide

Il seguente esempio di codice presentations.get mostra come recuperare un elenco di tutti gli ID oggetto slide dalla presentazione. Gli ID vengono restituiti nell'ordine di presentazione delle slide e possono essere utilizzati per indicare slide specifiche nelle richieste API successive. Puoi ottenere gli ID oggetto delle pagine master e di layout allo stesso modo, utilizzando fields=masters.objectId e fields=layout.objectId.

Di seguito è riportato il protocollo di richiesta per leggere gli ID oggetto slide:

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

La risposta è costituita da un oggetto Presentation contenente gli ID oggetto richiesti:

{
  "slides": [
    {
      "objectId": "ge63a4b4_1_0"
    },
    {
      "objectId": "ge63a4b4_1_9"
    },
    {
      "objectId": "ge63a4b4_1_23"
    },
    {
      "objectId": "ge63a4b4_1_35"
    },
    {
      "objectId": "ge63a4b4_1_43"
    }
  ]
}

Leggere gli ID oggetto degli elementi da una pagina

Il seguente presentations.pages.get esempio di codice mostra come recuperare un elenco di ID oggetto per tutti gli elementi della pagina di una pagina.

Di seguito è riportato il protocollo di richiesta per leggere gli ID oggetto degli elementi da una pagina:

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

La risposta è costituita da un oggetto Page contenente gli ID oggetto richiesti:

{
  "pageElements": [
    {
      "objectId": "ge63a4b4_1_5"
    },
    {
      "objectId": "ge63a4b4_1_6"
    },
    {
      "objectId": "ge63a4b4_1_7"
    },
    {
      "objectId": "ge63a4b4_1_8"
    }
  ]
}

Leggere gli elementi delle forme da una pagina

Il seguente presentations.pages.get esempio di codice mostra come recuperare un elenco di tutti i Shapes in una pagina. Puoi recuperare altri tipi di PageElement specificandoli utilizzando il parametro fields. Ad esempio, fields=pageElements(line,table) restituisce solo informazioni sugli elementi di pagina line e table, se presenti nella pagina.

Di seguito è riportato il protocollo di richiesta per leggere gli elementi di forma di una pagina:

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

La risposta è costituita da un oggetto Page contenente gli elementi della forma richiesti. Le parentesi graffe vuote indicano gli elementi di pagina che non sono di tipo forma; in questo caso, si tratta di elementi di pagina immagine.

{
  "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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}