Letture di base

L'API Presentazioni Google ti consente di leggere i dati di presentazioni, pagine ed elementi di pagina. La gli esempi in questa pagina mostrano come eseguire operazioni di lettura comuni utilizzando sia il comando presentations.get e presentations.pages.get di machine learning.

In questi esempi vengono utilizzati i seguenti segnaposto:

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

Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. La esempi letti da questo esempio presentazione, che ha 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc come PRESENTATION_ID. Il PAGE_ID del prima slide in questa presentazione è ge63a4b4_1_0.

In questi esempi, vengono utilizzate le maschere di campo per restituire informazioni specifiche richieste sulla presentazione, sulla slide e sulla pagina . L'utilizzo delle maschere dei campi migliora anche le prestazioni.

Leggi gli ID degli oggetti delle slide

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

Di seguito è riportato il protocollo di richiesta per leggere gli ID degli oggetti delle slide:

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

La risposta è composta da un 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"
    }
  ]
}

Leggi gli ID oggetto degli elementi da una pagina

Le seguenti presentations.pages.get l'esempio di codice mostra come recuperare un elenco di ID oggetto per tutti gli elementi della pagina in 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 è composta 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"
    }
  ]
}

Leggi gli elementi di forma da una pagina

Le seguenti presentations.pages.get un esempio di codice mostra come recuperare un elenco Shapes in una pagina. Puoi recuperare altri PageElement specificandoli tramite il parametro fields. Ad esempio: fields=pageElements(line,table) restituisce solo informazioni su line e table elementi della pagina, se presenti.

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

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

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