Letture di base

L'API Google Slides consente di leggere i dati di presentazioni, pagine ed elementi di pagina. 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 fornire l'ID oggetto pagina. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura dell'API.

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

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

Leggere gli ID oggetto slide

Il seguente presentations.get esempio di codice 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 nello 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 Presentation oggetto 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 elemento da una pagina

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

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

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

La risposta è costituita da un Page oggetto 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 forma da una pagina

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

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

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

La risposta è costituita da un Page oggetto contenente gli elementi forma richiesti. Le parentesi graffe vuote indicano gli elementi pagina che non sono di tipo forma; in questo caso, si tratta di elementi 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}