Elementvorgänge

Mit der Google Slides API können Sie PageElement Ressource enthalten, darunter Textfelder, Bilder, Tabellen, Grundformen, Linien und eingebetteten Videos angezeigt. Die Beispiele auf dieser Seite zeigen gängige Seitenelemente. Operationen mithilfe der presentations.batchUpdate .

In diesen Beispielen werden die folgenden Variablen verwendet:

  • PRESENTATION_ID: Gibt an, wo Sie die Präsentation ID fest. Sie können ruft den Wert für diese ID aus der Präsentations-URL ab.
  • PAGE_ID: Gibt an, wo Sie das Seitenobjekt bereitstellen. ID fest. Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
  • PAGE_ELEMENT_ID: Gibt an, wo Sie die Seite bereitstellen. Objekt-ID des Elements. Ich kann diese ID für von Ihnen erstellte Elemente angeben (mit einigen Einschränkungen) oder über die Slides API automatisch eine erstellen lassen. Element-IDs kann über eine API-Leseanfrage abgerufen werden.

Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Weitere Informationen Wie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API implementiert wird Clientbibliotheken finden Sie in den folgenden Anleitungen:

Aufzählungslisten zu Textfeldern hinzufügen

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie InsertTextRequest zum Einfügen von Text in ein leeres Textfeld, das durch die PAGE_ELEMENT_ID Im Beispiel wird dann die Methode CreateParagraphBulletsRequest , um den gesamten Textfeldtext in eine Aufzählungsliste zu konvertieren. Elemente in der Liste werden durch \n Zeichen getrennt, der Einzug wird mit \t gesteuert Zeichen.

Das folgende Anfrageprotokoll wird zum Erstellen einer Präsentation verwendet:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3",
        "insertionIndex": 0
      },
      "createParagraphBullets": {
        "objectId": PAGE_ELEMENT_ID,
        "bulletPreset": "BULLET_ARROW_DIAMOND_DISC",
        "textRange": {
          "type": "ALL"
        }
      }
    }
  ]
}

Mit dieser Anfrage kann eine Aufzählungsliste erstellt werden, die so aussieht:

Schemaergebnis für Aufzählungsliste.

Formen in Folien einfügen

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie CreateShapeRequest , um einer durch PAGE_ID angegebenen Folie eine Wellenform hinzuzufügen. Diese Anfrage gibt den Formtyp an und skaliert die Form dann auf die Folie. Dann wird die Methode InsertTextRequest um Text zu dieser Form hinzuzufügen. Die Anfrage legt die ID der Zeile auf PAGE_ELEMENT_ID

Mit dem folgenden Anfrageprotokoll können Sie einer Folie eine Form hinzufügen:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 0.6807,
            "scaleY": 0.4585,
            "translateX": 6583050,
            "translateY": 1673950,
            "unit": "EMU"
          }
        },
        "shapeType": "WAVE"
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Wave Shape",
        "insertionIndex": 0
      }
    }
  ]
}

Videos in Folien einfügen

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie CreateVideoRequest , um ein Video in eine durch PAGE_ID angegebene Folie einzubetten. Mit dieser Anfrage wird das Video auf der Folie skaliert und positioniert, ID an PAGE_ELEMENT_ID. Die eindeutige Kennung des Quellvideos lautet auf VIDEO_ID festgelegt. Das YouTube-Video unter https://www.youtube.com/watch?v=7U3axjORYZ0 hat die ID 7U3axjORYZ0.

Mit dem folgenden Anfrageprotokoll können Sie einer Folie ein Video hinzufügen:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createVideo": {
        "objectId": PAGE_ELEMENT_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 12000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 9000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 381,
            "scaleY": 381,
            "translateX": 152400,
            "translateY": 152400,
            "unit": "EMU"
          }
        },
        "source": "YOUTUBE",
        "id": VIDEO_ID
      }
    }
  ]
}

Elemente kopieren und bearbeiten

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie DuplicateObjectRequest eine vorhandene Form (angegeben durch das PAGE_ELEMENT_ID) und erstellen Sie eine Kopie (angegeben durch die COPY_ELEMENT_ID).

In den nachfolgenden Anfragen werden dann die folgenden Änderungen am doppelten Objekt vorgenommen:

  • Als Hintergrundfarbe wird die Designfarbe LIGHT2 festgelegt.
  • Die Kopie wird auf der Seite nach unten verschoben (von der Position der ursprünglichen Form aus).
  • Hiermit wird die Schriftart für Georgien (18 pt) festgelegt.
  • Bearbeitet den Text, sodass er „Meine Form“ lautet.

Die Anfragen hier verwenden Feldmasken, um die Formeigenschaften, die nicht geändert werden (z. B. der Umriss). Mit Feldmasken verbessern auch die Leistung.

Weitere Informationen zum Kopieren einer Folie finden Sie im Beispiel Eine Folie.

Das folgende Anfrageprotokoll dient zum Kopieren und Bearbeiten eines Elements:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ELEMENT_ID,
        "objectIds": {
          PAGE_ELEMENT_ID: COPY_ELEMENT_ID
        }
      }
    },
    {
      "updateShapeProperties": {
        "objectId": COPY_ELEMENT_ID,
        "fields": "shapeBackgroundFill.solidFill.color",
        "shapeProperties": {
          "shapeBackgroundFill": {
            "solidFill": {
              "color": {
                "themeColor": "LIGHT2"
              }
            }
          }
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": COPY_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
          "scaleX": 1,
          "scaleY": 1,
          "translateX": 0,
          "translateY": 1250000,
          "unit": "EMU"
        }
      }
    },
    {
      "updateTextStyle": {
        "objectId": COPY_ELEMENT_ID,
        "fields": "fontFamily,fontSize",
        "textRange": {
          "type": "ALL"
        },
        "style": {
          "fontFamily": "Georgia",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteText": {
        "objectId": COPY_ELEMENT_ID,
        "textRange": {
          "type": "ALL"
        }
      }
    },
    {
      "insertText": {
        "objectId": COPY_ELEMENT_ID,
        "text": "My Shape Copy",
        "insertionIndex": 0
      }
    }
  ]
}

So könnte eine Form und ihre Kopie nach diesen Aktualisierungen aussehen:

Kopieren und bearbeiten Sie ein Elementschemaergebnis.

Bild- oder Videostruktur bearbeiten

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie UpdateImagePropertiesRequest -Methode zur Aktualisierung der Umrissdarstellung eines Bildes, das durch das IMAGE_ELEMENT_ID Außerdem werden die UpdateVideoPropertiesRequest zur Aktualisierung des Umrisses eines eingebetteten Videos, das durch die VIDEO_ELEMENT_ID.

Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:

  • Legt die Umrissfarbe des Bilds auf die Designfarbe ACCENT5 mit Teilbild fest Transparenz.
  • Legt die Umrissfarbe des Videos auf die Designfarbe ACCENT1 fest (ohne Transparenz.
  • Legt die Umrissstärken für beide auf 3 pt fest.
  • Legt den Umrissstil des Bilds auf SOLID fest.
  • Hiermit wird der Videostrukturstil auf „DASH_DOT“ festgelegt.

Sowohl die Methode UpdateImagePropertiesRequest als auch die Methode Mit der UpdateVideoPropertiesRequest-Methode kann nur die Darstellung des Bildes geändert werden und Videokonzepte. Alle anderen Properties sind schreibgeschützt. Die Anfragen hier verwenden Feldmasken, um anzugeben, dass nur der Umriss geändert werden, um den Code vor zukünftigen API-Änderungen zu schützen. Feld verwenden verbessert auch die Leistung.

Das folgende Anfrageprotokoll dient zum Bearbeiten einer Bild- oder Videostruktur:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateImageProperties": {
        "objectId": IMAGE_ELEMENT_ID,
        "fields": "outline",
        "imageProperties": {
          "outline": {
            "dashStyle": "SOLID",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.8,
                "color": {
                  "themeColor": "ACCENT5"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    },
    {
      "updateVideoProperties": {
        "objectId": VIDEO_ELEMENT_ID,
        "fields": "outline",
        "videoProperties": {
          "outline": {
            "dashStyle": "DASH_DOT",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.8,
                "color": {
                  "themeColor": "ACCENT1"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    }
  ]
}

So könnten ein Bild und eingebettetes Video nach diesen Updates aussehen:

Rezepte mit Bildern und Videos Ergebnis.

Umriss einer Form bearbeiten

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie UpdateShapePropertiesRequest eine vorhandene Form (angegeben durch das PAGE_ELEMENT_ID) und aktualisiert das Aussehen des Umrisses.

Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:

  • Legt die Umrissfarbe auf die Designfarbe ACCENT5 mit Teilbild fest Transparenz.
  • Legt die Umrissstärke auf 3 pt fest.
  • Legt den Umrissstil auf LONG_DASH fest.

Die Anfragen hier verwenden Feldmasken, um Formeigenschaften, die nicht geändert werden (z. B. die Formfüllfarbe) Mit Feldmasken verbessern auch die Leistung.

Mit dem folgenden Anfrageprotokoll können Sie den Umriss einer Form bearbeiten:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateShapeProperties": {
        "objectId": PAGE_ELEMENT_ID,
        "fields": "outline",
        "shapeProperties": {
          "outline": {
            "dashStyle": "LONG_DASH",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.6,
                "color": {
                  "themeColor": "ACCENT5"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    }
  ]
}

So könnte eine Form nach diesen Updates aussehen:

Ergebnis des Schemas der Gliederung bearbeiten.

Text in einer Form oder einem Textfeld formatieren

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie UpdateTextStyleRequest eine vorhandene Form (angegeben durch das PAGE_ELEMENT_ID) und aktualisiert das Aussehen des Textes.

Mit den Anfragen werden die folgenden Änderungen am Objekt vorgenommen:

  • Legt die Textfarbe auf die Designfarbe ACCENT5 fest.
  • Legt die Schrift auf fett, kursiv (18-pt-Corsiva) fest.
  • Der Text wird unterstrichen.

Die Anfragen hier verwenden Feldmasken, um Textstileigenschaften, die nicht geändert werden (z. B. Hintergrundfarbe, Links oder Referenz-Offsets). Die Verwendung von Feldmasken verbessert auch die Leistung.

Das folgende Anfrageprotokoll dient zum Formatieren von Text in einer Form oder einem Textfeld:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateTextStyle": {
        "objectId": PAGE_ELEMENT_ID,
        "fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline",
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "themeColor": "ACCENT5"
            }
          },
          "bold": true,
          "italic": true,
          "underline": true,
          "fontFamily": "Corsiva",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        }
      }
    }
  ]
}

So könnte der Formtext nach diesen Updates aussehen:

Schema für Textformat bearbeiten Ergebnis.

Diagramm aus Google Tabellen importieren

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie CreateSheetsChartRequest um ein Diagramm aus einem Tabellenblatt zu importieren und auf einer Folie zu platzieren, PAGE_ID

Für den Antrag ist die Tabellen-ID erforderlich (angegeben durch die SPREADSHEET_ID) und die Diagramm-ID der Tabelle (angegeben durch das SPREADSHEET_CHART_ID). Die Diagramm-ID im Die Präsentation wird durch das PRESENTATION_CHART_ID

Die Anfrage legt auch die LinkingMode des Diagramms auf LINKED aus, damit Sie die eingebettetes Diagramm, wenn das Diagramm in der Quelltabelle aktualisiert wird.

Das folgende Anfrageprotokoll, aus dem ein Diagramm importiert werden soll Google Tabellen:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSheetsChart": {
        "objectId": PRESENTATION_CHART_ID,
        "spreadsheetId": SPREADSHEET_ID,
        "chartId": SPREADSHEET_CHART_ID,
        "linkingMode": "LINKED",
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 4000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 4000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 100000,
            "translateY": 100000,
            "unit": "EMU"
          }
      }
    }
  ]
}

Diagramme aus Google Tabellen aktualisieren

Die folgenden presentations.batchUpdate wird in einem Codebeispiel gezeigt, wie Sie RefreshSheetsChartRequest -Methode aktualisieren, um ein verknüpftes Diagramm in einer Präsentation durch das neueste Version dieses Diagramms aus der Google Tabellen-Quelltabelle. Die Für die Anfrage ist die Diagramm-ID in der Google-Präsentation erforderlich (durch PRESENTATION_CHART_ID angegeben).

Das folgende Anfrageprotokoll zum Aktualisieren eines Diagramms aus Google Tabellen:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "refreshSheetsChart": {
        "objectId": PRESENTATION_CHART_ID
      }
    }
  ]
}