Requests

Anfrage

Eine einzelne Art von Aktualisierung, die auf eine Präsentation angewendet werden soll.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Art der Aktualisierung. Es ist genau ein Feld erforderlich. kind darf nur einen der folgenden Werte haben:
createSlide

object (CreateSlideRequest)

Erstellt eine neue Folie.

createShape

object (CreateShapeRequest)

Damit wird eine neue Form erstellt.

createTable

object (CreateTableRequest)

: Erstellt eine neue Tabelle.

insertText

object (InsertTextRequest)

Hiermit können Sie Text in eine Form oder Tabellenzelle einfügen.

insertTableRows

object (InsertTableRowsRequest)

Zeilen in eine Tabelle einfügen

insertTableColumns

object (InsertTableColumnsRequest)

Hiermit werden Spalten in eine Tabelle eingefügt.

deleteTableRow

object (DeleteTableRowRequest)

Löscht eine Zeile aus einer Tabelle.

deleteTableColumn

object (DeleteTableColumnRequest)

Löscht eine Spalte aus einer Tabelle.

replaceAllText

object (ReplaceAllTextRequest)

Ersetzt alle Instanzen des angegebenen Texts.

deleteObject

object (DeleteObjectRequest)

Löscht eine Seite oder ein Seitenelement aus der Präsentation.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aktualisiert die Transformation eines Seitenelements.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Aktualisiert die Position einer Reihe von Folien in der Präsentation.

deleteText

object (DeleteTextRequest)

Löscht Text aus einer Form oder einer Tabellenzelle.

createImage

object (CreateImageRequest)

Erstellt ein Bild.

createVideo

object (CreateVideoRequest)

Erstellt ein Video.

createSheetsChart

object (CreateSheetsChartRequest)

Erstellt ein eingebettetes Google Tabellen-Diagramm.

createLine

object (CreateLineRequest)

Erstellt eine Linie.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aktualisiert ein Google Sheets-Diagramm.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualisiert die Eigenschaften einer Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualisiert die Eigenschaften einer Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualisiert die Eigenschaften einer Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualisiert die Eigenschaften einer Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualisiert die Eigenschaften einer TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aktualisiert die Eigenschaften einer Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Erstellt Aufzählungspunkte für Absätze.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Ersetzt alle Formen, die bestimmten Kriterien entsprechen, durch ein Bild.

duplicateObject

object (DuplicateObjectRequest)

Hiermit können Sie ein Folien- oder Seitenelement duplizieren.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert das Text-Styling in einem Shape oder Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Ersetzt alle Formen, die bestimmten Kriterien entsprechen, durch ein Google Tabellen-Diagramm.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Löscht Aufzählungspunkte aus Absätzen.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualisiert das Format von Absätzen innerhalb eines Shape oder Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualisiert die Eigenschaften der Tabellenränder in einer Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Eigenschaften einer Table-Spalte.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aktualisiert die Eigenschaften einer Table-Zeile.

mergeTableCells

object (MergeTableCellsRequest)

Zellen in einer Table zusammenführen

unmergeTableCells

object (UnmergeTableCellsRequest)

Heben Sie den Zellenverbund in einer Table auf.

groupObjects

object (GroupObjectsRequest)

Gruppiert Objekte wie Seitenelemente.

ungroupObjects

object (UngroupObjectsRequest)

Heben Sie die Gruppierung von Objekten wie groups auf.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Aktualisiert den Titel und/oder die Beschreibung des Alt-Texts einer page element.

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Bild durch ein neues.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aktualisiert die Eigenschaften einer Folie

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Aktualisiert die Z-Reihenfolge von page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Aktualisiert die Kategorie eines line.

rerouteLine

object (RerouteLineRequest)

Leitet eine line so um, dass sie an den beiden Verbindungsstellen auf den verbundenen Seitenelementen verbunden ist.

CreateSlideRequest

Erstellt eine Folie.

JSON-Darstellung 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem Regex [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem Regex [a-zA-Z0-9_-:]). Die ID muss zwischen 5 und 50 Zeichen lang sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

insertionIndex

integer

Der optionale nullbasierte Index, der angibt, wo die Folien eingefügt werden sollen.

Wenn Sie keinen Index angeben, wird die Folie am Ende erstellt.

slideLayoutReference

object (LayoutReference)

Layoutreferenz der einzufügenden Folie, basierend auf dem aktuellen Master, der einen der folgenden Werte hat:

  • Der Master des vorherigen Folienindexes.
  • Der Master der ersten Folie, wenn der „insertionIndex“ null ist.
  • Der erste Master in der Präsentation, wenn keine Folien vorhanden sind.

Wenn die LayoutReference im aktuellen Master nicht gefunden wird, wird der Fehler 400 „Ungültige Anfrage“ zurückgegeben.

Wenn Sie keine Layoutreferenz angeben, wird für die Folie das vordefinierte Layout BLANK verwendet.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Eine optionale Liste von Objekt-ID-Zuordnungen von den placeholder auf dem Layout zu den Platzhaltern, die auf der Folie aus dem angegebenen Layout erstellt werden. Kann nur verwendet werden, wenn slideLayoutReference angegeben ist.

LayoutReference

Referenz zum Folienlayout Dies kann sich auf Folgendes beziehen:

  • Ein vordefiniertes Layout
  • Eines der Layouts in der Präsentation.
JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art der LayoutReference. kind darf nur einen der folgenden Werte haben:
predefinedLayout

enum (PredefinedLayout)

Vordefiniertes Layout.

layoutId

string

Layout-ID: Die Objekt-ID eines der Layouts in der Präsentation.

PredefinedLayout

Vordefinierte Layouttypen Diese Layouts sind in Präsentationen häufig zu finden. Es gibt jedoch keine Garantie dafür, dass diese Layouts im aktuellen Master vorhanden sind, da sie möglicherweise gelöscht wurden oder nicht zum verwendeten Design gehören. Außerdem wurden möglicherweise die Platzhalter in den einzelnen Layouts geändert.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Nicht angegebenes Layout.
BLANK Leeres Layout ohne Platzhalter.
CAPTION_ONLY Layout mit einer Bildunterschrift unten
TITLE Layout mit einem Titel und einem Untertitel
TITLE_AND_BODY Layout mit Titel und Textkörper
TITLE_AND_TWO_COLUMNS Layout mit einem Titel und zwei Spalten
TITLE_ONLY Layout mit nur einem Titel
SECTION_HEADER Layout mit einem Abschnittstitel
SECTION_TITLE_AND_DESCRIPTION Layout mit einem Titel und einer Unterüberschrift auf der einen Seite und einer Beschreibung auf der anderen Seite.
ONE_COLUMN_TEXT Layout mit einer Überschrift und einem Textkörper, die in einer einzigen Spalte angeordnet sind.
MAIN_POINT Layout mit einem Hauptpunkt
BIG_NUMBER Layout mit einer großen Zahlenüberschrift

LayoutPlaceholderIdMapping

Die vom Nutzer angegebene ID-Zuordnung für einen Platzhalter, der auf einer Folie aus einem bestimmten Layout erstellt wird.

JSON-Darstellung 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID für den oben genannten Platzhalter, der auf einer Folie erstellt werden soll.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

Union-Feld kind. Die Art, mit der ein Platzhalter in einem Layout gekennzeichnet wird. kind darf nur einen der folgenden Werte haben:
layoutPlaceholder

object (Placeholder)

Der Platzhalter in einem Layout, der auf eine Folie angewendet wird. Nur type und index sind erforderlich. Ein vordefiniertes TITLE_AND_BODY-Layout hat beispielsweise normalerweise einen TITLE-Platzhalter mit dem Index 0 und einen BODY-Platzhalter mit dem Index 0.

layoutPlaceholderObjectId

string

Die Objekt-ID des Platzhalters in einem Layout, der auf eine Folie angewendet wird.

CreateShapeRequest

Damit wird eine neue Form erstellt.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Form.

shapeType

enum (Type)

Der Formtyp.

PageElementProperties

Gängige Eigenschaften für ein Seitenelement.

Hinweis: Wenn Sie ein PageElement zum ersten Mal erstellen, ändert die API möglicherweise die Werte von size und transform. Die visuelle Größe bleibt jedoch unverändert.

JSON-Darstellung 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Felder
pageObjectId

string

Die Objekt-ID der Seite, auf der sich das Element befindet.

size

object (Size)

Die Größe des Elements.

transform

object (AffineTransform)

Die Transformation für das Element.

CreateTableRequest

: Erstellt eine neue Tabelle.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Tabelle.

Die Tabelle wird mit der angegebenen Größe erstellt, sofern diese die Mindestgröße nicht unterschreitet. Wenn keine Größe angegeben wird, wird die Tabelle automatisch skaliert.

Tabellentransformationen müssen einen Maßstab von 1 und keine Scherkomponenten haben. Wenn keine Transformation angegeben wird, wird die Tabelle auf der Seite zentriert.

rows

integer

Anzahl der Zeilen in der Tabelle.

columns

integer

Anzahl der Spalten in der Tabelle.

InsertTextRequest

Hiermit können Sie Text in eine Form oder eine Tabellenzelle einfügen.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle, in die der Text eingefügt werden soll.

cellLocation

object (TableCellLocation)

Optionale Tabellenzellenumgebung, wenn der Text in eine Tabellenzelle eingefügt werden soll. Sofern vorhanden, muss sich das objectId auf eine Tabelle beziehen.

text

string

Der einzufügende Text.

Wenn Sie einen Zeilenumbruch einfügen, wird an dieser Stelle implizit ein neuer ParagraphMarker erstellt. Der Absatzstil des neuen Absatzes wird aus dem Absatz am aktuellen Einfügeindex kopiert, einschließlich Listen und Aufzählungszeichen.

Textstile für eingefügten Text werden automatisch bestimmt. Dabei wird in der Regel der Stil des benachbarten Texts beibehalten. In den meisten Fällen wird der Text dem TextRun hinzugefügt, das sich am Einfügeindex befindet.

Einige Steuerzeichen (U+0000–U+0008, U+000C–U+001F) und Zeichen aus dem privaten Bereich der Unicode Basic Multilingual Plane (U+E000–U+F8FF) werden aus dem eingefügten Text entfernt.

insertionIndex

integer

Der Index, an dem der Text eingefügt wird, in Unicode-Codeeinheiten, basierend auf TextElement-Indexen.

Der Index beginnt bei null und wird vom Anfang des Strings aus berechnet. Der Index kann angepasst werden, um Einfügungen innerhalb von Unicode-Grapheme-Clustern zu verhindern. In diesen Fällen wird der Text direkt nach dem Graphemcluster eingefügt.

InsertTableRowsRequest

Zeilen in eine Tabelle einfügen

JSON-Darstellung 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Felder
tableObjectId

string

Tabelle, in die Zeilen eingefügt werden sollen.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Referenztabelle, von der aus Zeilen eingefügt werden.

Eine neue Zeile wird über oder unter der Zeile eingefügt, in der sich die Referenzzelle befindet. Wenn es sich bei der Referenzzelle um eine zusammengeführte Zelle handelt, wird eine neue Zeile über oder unter der zusammengeführten Zelle eingefügt.

insertBelow

boolean

Gibt an, ob neue Zeilen unter der Referenzzelle eingefügt werden sollen.

  • True : Einfügen unter der Zelle.
  • False : Einfügen über der Zelle.
number

integer

Die Anzahl der einzufügenden Zeilen. Maximal 20 pro Anfrage.

InsertTableColumnsRequest

Damit werden Spalten in eine Tabelle eingefügt.

Die Größe der anderen Spalten in der Tabelle wird an die neue Spalte angepasst.

JSON-Darstellung 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Felder
tableObjectId

string

Tabelle, in die Spalten eingefügt werden sollen.

cellLocation

object (TableCellLocation)

Die Position der Referenztabellenzelle, von der aus Spalten eingefügt werden.

Eine neue Spalte wird links (oder rechts) neben der Spalte eingefügt, in der sich die Referenzzelle befindet. Wenn es sich bei der Referenzzelle um eine zusammengeführte Zelle handelt, wird die neue Spalte links (oder rechts) neben der zusammengeführten Zelle eingefügt.

insertRight

boolean

Gibt an, ob neue Spalten rechts neben der Referenzzelle eingefügt werden sollen.

  • True : Einfügen nach rechts.
  • False : Einfügen links.
number

integer

Die Anzahl der einzufügenden Spalten. Maximal 20 pro Anfrage.

DeleteTableRowRequest

Löscht eine Zeile aus einer Tabelle.

JSON-Darstellung 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Felder
tableObjectId

string

Die Tabelle, aus der Zeilen gelöscht werden sollen.

cellLocation

object (TableCellLocation)

Die Position der Referenztabellenzelle, aus der eine Zeile gelöscht wird.

Die Zeile, die diese Zelle umfasst, wird gelöscht. Wenn es sich um eine zusammengeführte Zelle handelt, werden mehrere Zeilen gelöscht. Wenn nach diesem Löschvorgang keine Zeilen mehr in der Tabelle vorhanden sind, wird die gesamte Tabelle gelöscht.

DeleteTableColumnRequest

Löscht eine Spalte aus einer Tabelle.

JSON-Darstellung 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Felder
tableObjectId

string

Die Tabelle, aus der Spalten gelöscht werden sollen.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Referenztabelle, aus der eine Spalte gelöscht wird.

Die Spalte, die diese Zelle umfasst, wird gelöscht. Wenn es sich um eine zusammengeführte Zelle handelt, werden mehrere Spalten gelöscht. Wenn nach diesem Löschvorgang keine Spalten mehr in der Tabelle vorhanden sind, wird die gesamte Tabelle gelöscht.

ReplaceAllTextRequest

Ersetzt alle Textinstanzen, die einem bestimmten Kriterium entsprechen, durch replace text.

JSON-Darstellung 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Felder
replaceText

string

Der Text, der den übereinstimmenden Text ersetzt.

pageObjectIds[]

string

Wenn das Feld nicht leer ist, werden die Übereinstimmungen auf Seitenelemente auf den angegebenen Seiten beschränkt.

Gibt den Fehler 400 „Bad Request“ zurück, wenn die Seitenobjekt-ID eines notes master angegeben wird oder wenn in der Präsentation keine Seite mit dieser Objekt-ID vorhanden ist.

Union-Feld criteria. Die Kriterien, anhand derer der zu ersetzende Text abgeglichen wird. criteria darf nur einen der folgenden Werte haben:
containsText

object (SubstringMatchCriteria)

Hiermit wird Text in einer Form gesucht, der mit diesem Teilstring übereinstimmt.

SubstringMatchCriteria

Ein Kriterium, das mit einem bestimmten Textstring in einer Form oder Tabelle übereinstimmt.

JSON-Darstellung 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Felder
text

string

Der Text, nach dem in der Form oder Tabelle gesucht werden soll.

matchCase

boolean

Gibt an, ob die Groß-/Kleinschreibung bei der Suche berücksichtigt werden soll:

  • True : Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.
  • False : Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.
searchByRegex

boolean

Optional. „Wahr“, wenn der Suchwert als regulärer Ausdruck behandelt werden soll. Alle umgekehrten Schrägstriche im Muster müssen maskiert werden.

  • True : Der Suchtext wird als regulärer Ausdruck behandelt.
  • False : Der Suchtext wird als Teilstring für die Übereinstimmung behandelt.

DeleteObjectRequest

Löscht ein Objekt (pages oder page elements) aus der Präsentation.

JSON-Darstellung 
{
  "objectId": string
}
Felder
objectId

string

Die Objekt-ID der Seite oder des Seitenelements, das gelöscht werden soll.

Wenn nach einem Löschvorgang eine group nur ein oder keine Seitenelemente enthält, wird auch die Gruppe gelöscht.

Wenn ein Platzhalter in einem Layout gelöscht wird, werden auch alle leeren vererbten Platzhalter gelöscht.

UpdatePageElementTransformRequest

Aktualisiert die Transformation eines Seitenelements.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich die absolute Transformation der Seitenelemente in dieser Gruppe, was sich auf ihr visuelles Erscheinungsbild auswirken kann. Weitere Informationen finden Sie in der Dokumentation zu PageElement.transform.

JSON-Darstellung 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Felder
objectId

string

Die Objekt-ID des zu aktualisierenden Seitenelements.

transform

object (AffineTransform)

Die Eingabetransformationsmatrix, die zum Aktualisieren des Seitenelements verwendet wird.

applyMode

enum (ApplyMode)

Der Anwendungsmodus der Transformationsaktualisierung.

ApplyMode

Die Anwendungsmodi der Transformationsaktualisierung.

Enums
APPLY_MODE_UNSPECIFIED Nicht angegebener Modus.
RELATIVE Die neue AffineTransform-Matrix wird auf die vorhandene angewendet und ersetzt sie durch die resultierende Konkatenierung.
ABSOLUTE Ersetzt die vorhandene AffineTransform-Matrix durch die neue.

UpdateSlidesPositionRequest

Aktualisiert die Position der Folien in der Präsentation.

JSON-Darstellung 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Felder
slideObjectIds[]

string

Die IDs der Folien in der Präsentation, die verschoben werden sollen. Die Folien in dieser Liste müssen in der Reihenfolge der Präsentation und ohne Duplikate sein.

insertionIndex

integer

Der Index, an dem die Folien eingefügt werden sollen, basierend auf der Folienanordnung vor dem Verschieben. Muss zwischen null und der Anzahl der Folien in der Präsentation liegen.

DeleteTextRequest

Löscht Text aus einer Form oder einer Tabellenzelle.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle, aus der der Text gelöscht werden soll.

cellLocation

object (TableCellLocation)

Optionale Tabellenzellposition, wenn der Text aus einer Tabellenzelle gelöscht werden soll. Sofern vorhanden, muss sich das objectId auf eine Tabelle beziehen.

textRange

object (Range)

Der zu löschende Textbereich basierend auf TextElement-Indexen.

Am Ende des Texts einer Form oder Tabellenzelle befindet sich immer ein implizites Zeilenvorschubzeichen, das nicht gelöscht werden kann. Bei Range.Type.ALL werden die richtigen Grenzen verwendet. Bei expliziten Grenzen für die Bereichstypen FROM_START_INDEX und FIXED_RANGE ist jedoch Vorsicht geboten. Wenn der Text beispielsweise „ABC“ gefolgt von einem impliziten Zeilenumbruch ist, ist der maximale Wert 2 für textRange.start_index und 3 für textRange.end_index.

Wenn Sie Text löschen, der eine Absatzgrenze überschreitet, kann dies zu Änderungen an Absatzstilen und Listen führen, da die beiden Absätze zusammengeführt werden.

Bereiche, die nur eine Codeeinheit eines Surrogatenpaars enthalten, werden auf beide Codeeinheiten erweitert.

Bereich

Gibt einen zusammenhängenden Bereich einer indexierten Sammlung an, z. B. Zeichen in Text.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Felder
startIndex

integer

Der optionale nullbasierte Index des Beginns der Sammlung. Erforderlich für Bereiche vom Typ FIXED_RANGE und FROM_START_INDEX.

endIndex

integer

Der optionale nullbasierte Index des Endes der Sammlung. Erforderlich für FIXED_RANGE-Bereiche.

type

enum (Type)

Der Bereichstyp.

Typ

Die Arten von Bereichen.

Enums
RANGE_TYPE_UNSPECIFIED Nicht angegebener Bereichstyp. Dieser Wert darf nicht verwendet werden.
FIXED_RANGE Ein fester Bereich. Sowohl startIndex als auch endIndex müssen angegeben werden.
FROM_START_INDEX Der Bereich beginnt bei startIndex und dauert bis zum Ende der Sammlung. endIndex darf nicht angegeben werden.
ALL Legt den Bereich auf die gesamte Länge der Sammlung fest. Weder startIndex noch endIndex dürfen angegeben werden.

CreateImageRequest

Erstellt ein Bild.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Bild.

Wenn das Seitenverhältnis der angegebenen Größe nicht mit dem Seitenverhältnis des Bildes übereinstimmt, wird das Bild skaliert und zentriert, um das Seitenverhältnis beizubehalten. Die angegebene Transformation wird nach diesem Vorgang angewendet.

Das Attribut PageElementProperties.size ist optional. Wenn Sie die Größe nicht angeben, wird die Standardgröße des Bildes verwendet.

Das Attribut PageElementProperties.transform ist optional. Wenn Sie keine Transformation angeben, wird das Bild links oben auf der Seite platziert.

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einen der folgenden Werte haben:
url

string

Die Bild-URL.

Das Bild wird beim Einfügen einmal abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen maximal 50 MB groß und 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL muss öffentlich zugänglich und maximal 2 KB lang sein. Die URL wird mit dem Bild gespeichert und über das Feld Image.source_url bereitgestellt.

CreateVideoRequest

Erstellt ein Video.

HINWEIS: Zum Erstellen eines Videos über Google Drive muss die anfragende App mindestens einen der OAuth-Bereiche „drive“, „drive.readonly“ oder „drive.file“ haben.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Video.

Das Attribut PageElementProperties.size ist optional. Wenn Sie keine Größe angeben, wird vom Server eine Standardgröße ausgewählt.

Das Attribut PageElementProperties.transform ist optional. Die Transformation darf keine Scherkomponenten haben. Wenn Sie keine Transformation angeben, wird das Video links oben auf der Seite platziert.

source

enum (Source)

Die Videoquelle.

id

string

Die eindeutige Kennung der Videoquelle für dieses Video.

Beispiel: Die ID des YouTube-Videos https://www.youtube.com/watch?v=7U3axjORYZ0 lautet 7U3axjORYZ0. Bei einem Google Drive-Video mit der URL https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q lautet die ID 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Wenn du auf eine Google Drive-Videodatei zugreifen möchtest, musst du dem HTTP-Header für einen Teil der alten Dateien möglicherweise einen Ressourcenschlüssel hinzufügen. Weitere Informationen finden Sie unter Über Ressourcenschlüssel auf per Link freigegebene Dateien zugreifen.

CreateSheetsChartRequest

Erstellt ein eingebettetes Google Tabellen-Diagramm.

HINWEIS: Für das Erstellen von Diagrammen ist mindestens einer der OAuth-Bereiche „spreadsheets.readonly“, „spreadsheets“, „drive.readonly“, „drive.file“ oder „drive“ erforderlich.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Falls angegeben, muss die ID unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID sollte mit einem Wortzeichen [a-zA-Z0-9_] beginnen und dann beliebig viele der folgenden Zeichen enthalten [a-zA-Z0-9_-:]. Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Diagramm.

Wenn das Seitenverhältnis der angegebenen Größe nicht mit dem Seitenverhältnis des Diagramms übereinstimmt, wird das Diagramm skaliert und entsprechend der Größe zentriert, um das Seitenverhältnis beizubehalten. Die angegebene Transformation wird nach diesem Vorgang angewendet.

spreadsheetId

string

Die ID der Google Tabellen-Tabelle, die das Diagramm enthält.

Möglicherweise musst du dem HTTP-Header einen Ressourcenschlüssel für einen Teil der alten Dateien hinzufügen. Weitere Informationen finden Sie unter Über Ressourcenschlüssel auf per Link freigegebene Dateien zugreifen.

chartId

integer

Die ID des jeweiligen Diagramms in der Google Tabellen-Tabelle.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn Sie keine Angabe machen, wird das Diagramm als nicht verknüpftes Bild angezeigt.

LinkingMode

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist.

Enums
NOT_LINKED_IMAGE Das Diagramm ist nicht mit der Quelltabelle verknüpft und kann nicht aktualisiert werden. Ein nicht verknüpftes Diagramm wird als Bild eingefügt.
LINKED Wenn Sie das Diagramm verknüpfen, kann es aktualisiert werden. Andere Mitbearbeiter sehen dann einen Link zur Tabelle.

CreateLineRequest

Erstellt eine Linie.

JSON-Darstellung 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Felder
objectId

string

Eine vom Nutzer angegebene Objekt-ID.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Zeile.

lineCategory
(deprecated)

enum (Category)

Die Kategorie der zu erstellenden Linie.

Verworfen : Verwenden Sie stattdessen category.

Welche line type genau erstellt wird, hängt von der Kategorie und der Weiterleitung zu anderen Seitenelementen ab.

Wenn Sie sowohl category als auch lineCategory angeben, hat category Vorrang.

category

enum (LineCategory)

Die Kategorie der zu erstellenden Linie.

Welche line type genau erstellt wird, hängt von der Kategorie und der Weiterleitung zu anderen Seitenelementen ab.

Wenn Sie sowohl category als auch lineCategory angeben, hat category Vorrang.

Wenn Sie keinen Wert für category, aber einen Wert für lineCategory angeben, wird der angegebene Wert für lineCategory verwendet.

Wenn Sie keines von beiden angeben, wird STRAIGHT verwendet.

Kategorie

Die Linienkategorien.

Enums
STRAIGHT Gerade Anschlüsse, einschließlich gerader Anschluss 1. Dies ist die Standardkategorie, wenn keine angegeben wird.
BENT Verbogene Anschlüsse, einschließlich der Anschlüsse 2 bis 5.
CURVED Gekrümmte Anschlüsse, einschließlich der Anschlüsse 2 bis 5.

RefreshSheetsChartRequest

Ein eingebettetes Google Tabellen-Diagramm wird aktualisiert, indem es durch die aktuelle Version des Diagramms aus Google Tabellen ersetzt wird.

HINWEIS: Zum Aktualisieren von Diagrammen ist mindestens einer der OAuth-Bereiche „spreadsheets.readonly“, „spreadsheets“, „drive.readonly“ oder „drive“ erforderlich.

JSON-Darstellung 
{
  "objectId": string
}
Felder
objectId

string

Die Objekt-ID des Diagramms, das aktualisiert werden soll.

UpdateShapePropertiesRequest

Aktualisieren Sie die Eigenschaften einer Shape.

JSON-Darstellung 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Form, auf die die Änderungen angewendet werden.

shapeProperties

object (ShapeProperties)

Die zu aktualisierenden Formeigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten shapeProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe der durchgehenden Füllung des Formhintergrunds aktualisieren möchten, legen Sie fields auf "shapeBackgroundFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdateImagePropertiesRequest

Aktualisieren Sie die Eigenschaften einer Image.

JSON-Darstellung 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID des Bilds, auf das die Updates angewendet werden.

imageProperties

object (ImageProperties)

Die zu aktualisierenden Bildeigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten imageProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe des Bildumrisses aktualisieren möchten, legen Sie fields auf "outline.outlineFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdateVideoPropertiesRequest

Aktualisieren Sie die Eigenschaften einer Video.

JSON-Darstellung 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID des Videos, auf das die Änderungen angewendet werden.

videoProperties

object (VideoProperties)

Die zu aktualisierenden Video-Attribute.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten videoProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe des Video-Umrisses aktualisieren möchten, legen Sie fields auf "outline.outlineFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdatePagePropertiesRequest

Aktualisiert die Eigenschaften einer Page.

JSON-Darstellung 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Seite, auf die die Aktualisierung angewendet wird.

pageProperties

object (PageProperties)

Die zu aktualisierenden Seiteneigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten pageProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe der durchgehenden Füllung des Seitenhintergrunds aktualisieren möchten, legen Sie fields auf "pageBackgroundFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdateTableCellPropertiesRequest

Aktualisieren Sie die Eigenschaften einer TableCell.

JSON-Darstellung 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der den Teil der Tabelle darstellt, auf den die Aktualisierungen angewendet werden. Wenn kein Tabellenbereich angegeben ist, werden die Änderungen auf die gesamte Tabelle angewendet.

tableCellProperties

object (TableCellProperties)

Die zu aktualisierenden Tabellenzelleigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableCellProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe der durchgehenden Füllung des Tabellenzellenhintergrunds aktualisieren möchten, setzen Sie fields auf "tableCellBackgroundFill.solidFill.color".

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

TableRange

Ein Tabellenbereich ist ein Verweis auf einen Teil einer Tabelle.

Die Zellen, die durch einen Tabellenbereich angegeben werden, bilden nicht unbedingt ein Rechteck. Angenommen, wir haben eine Tabelle mit 3 × 3 Zeilen, in der alle Zellen der letzten Zeile zusammengeführt sind. Die Tabelle sieht so aus: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Ein Tabellenbereich mit dem Startpunkt (0, 0), einer Zeilenspanne von 3 und einer Spaltenspanne von 2 umfasst die folgenden Zellen: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON-Darstellung 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Felder
location

object (TableCellLocation)

Der Startpunkt des Tabellenbereichs.

rowSpan

integer

Die Zeilenspanne des Tabellenbereichs.

columnSpan

integer

Die Spaltenspanne des Tabellenbereichs.

UpdateLinePropertiesRequest

Aktualisiert die Eigenschaften einer Line.

JSON-Darstellung 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Zeile, auf die das Update angewendet wird.

lineProperties

object (LineProperties)

Die zu aktualisierenden Linieneigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten lineProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe der durchgehenden Füllung der Linie aktualisieren möchten, legen Sie fields auf "lineFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

CreateParagraphBulletsRequest

Erstellt Aufzählungspunkte für alle Absätze, die sich mit dem angegebenen Textindexbereich überschneiden.

Die Verschachtelungsebene jedes Absatzes wird durch das Zählen der Tabulatorzeichen vor jedem Absatz bestimmt. Um zu vermeiden, dass zu viel Platz zwischen dem Aufzählungspunkt und dem entsprechenden Absatz entsteht, werden diese Tabulatorzeichen durch diese Anfrage entfernt. Dadurch können sich die Indizes von Textteilen ändern.

Wenn sich der Absatz direkt vor den zu aktualisierenden Absätzen in einer Liste mit einer übereinstimmenden Voreinstellung befindet, werden die zu aktualisierenden Absätze dieser Liste hinzugefügt.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle, die den Text enthält, dem Aufzählungspunkte hinzugefügt werden sollen.

cellLocation

object (TableCellLocation)

Optionaler Tabellenzellenstandort, wenn sich der zu ändernde Text in einer Tabellenzelle befindet. Sofern vorhanden, muss sich das objectId auf eine Tabelle beziehen.

textRange

object (Range)

Der Textbereich, auf den die Aufzählungsvorlagen basierend auf TextElement-Indexen angewendet werden sollen.

bulletPreset

enum (BulletGlyphPreset)

Die Art der zu verwendenden Aufzählungszeichen. Die Standardeinstellung ist die Voreinstellung BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Vordefinierte Muster von Aufzählungszeichen für Listen im Text.

Bei diesen Mustern werden folgende Arten von Aufzählungszeichen verwendet:

  • ARROW : Ein Pfeil, der dem Unicode-Codepunkt U+2794 entspricht
  • ARROW3D : Ein Pfeil mit 3D-Schattierung, der dem Unicode-Codepunkt U+27a2 entspricht
  • CHECKBOX : Ein leeres Quadrat, das dem Unicode-Codepunkt U+274f entspricht
  • CIRCLE : Ein hohler Kreis, der dem Unicode-Codepunkt U+25cb entspricht
  • DIAMOND : Eine durchgezogene Raute, die dem Unicode-Codepunkt U+25c6 entspricht
  • DIAMONDX : Raute mit einem „x“, entspricht dem Unicode-Codepunkt U+2756
  • HOLLOWDIAMOND : Eine gefüllte Raute, die dem Unicode-Codepunkt U+25c7 entspricht
  • DISC : Ein solider Kreis, der dem Unicode-Codepunkt U+25cf entspricht
  • SQUARE : Ein durchgezogenes Quadrat, das dem Unicode-Codepunkt U+25a0 entspricht
  • STAR : Ein Stern, der dem Unicode-Codepunkt U+2605 entspricht
  • ALPHA : Ein Kleinbuchstabe wie „a“, „b“ oder „c“.
  • UPPERALPHA : Ein Großbuchstabe wie „A“, „B“ oder „C“.
  • DIGIT : Eine Zahl wie „1“, „2“ oder „3“.
  • ZERODIGIT : Eine Zahl, bei der Einstellige mit einer Null vorangestellt sind, z. B. „01“, „02“ oder „03“. Zahlen mit mehr als einer Ziffer werden nicht mit einer Null vorangestellt.
  • ROMAN : Ein Kleinbuchstabe einer römischen Ziffer, z. B. „i“, „ii“ oder „iii“.
  • UPPERROMAN : Ein Großbuchstabe aus dem römischen Zahlensystem, z. B. „I“, „II“ oder „III“.
  • LEFTTRIANGLE : Ein nach links zeigendes Dreieck, das dem Unicode-Codepunkt U+25c4 entspricht
Enums
BULLET_DISC_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DISC, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMONDX, ARROW3D und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
BULLET_CHECKBOX Eine Aufzählungsliste mit CHECKBOX Aufzählungszeichen für alle Listenverschachtelungsebenen.
BULLET_ARROW_DIAMOND_DISC Eine Aufzählungsliste mit den Aufzählungszeichen ARROW, DIAMOND und DISC für die ersten drei Verschachtelungsebenen der Liste.
BULLET_STAR_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen STAR, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen ARROW3D, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit den Aufzählungszeichen LEFTTRIANGLE, DIAMOND und DISC für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMONDX, HOLLOWDIAMOND und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMOND, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen der Liste.
NUMBERED_DIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Zeichen DIGIT, ALPHA und ROMAN für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Eine nummerierte Liste mit den Ziffern DIGIT, ALPHA und ROMAN für die ersten drei Listenverschachtelungsebenen, gefolgt von Klammern.
NUMBERED_DIGIT_NESTED Eine nummerierte Liste mit DIGIT-Zahlensymbolen, die durch Punkte getrennt sind. Dabei wird für jede Verschachtelungsebene das Symbol der vorherigen Verschachtelungsebene als Präfix verwendet. Beispiel: „1.“ '1.1.', '2.', 2.2.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Zeichen UPPERALPHA, ALPHA und ROMAN für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Eine nummerierte Liste mit den numerischen Zeichen UPPERROMAN, UPPERALPHA und DIGIT für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Zeichen ZERODIGIT, ALPHA und ROMAN für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.

ReplaceAllShapesWithImageRequest

Ersetzt alle Formen, die den angegebenen Kriterien entsprechen, durch das bereitgestellte Bild.

Die Bilder, die die Formen ersetzen, sind nach dem Einfügen in die Präsentation rechteckig und nehmen nicht die Form der Formen an.

JSON-Darstellung 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
Felder
replaceMethod
(deprecated)

enum (ReplaceMethod)

Die replace-Methode.

Verworfen : Verwenden Sie stattdessen imageReplaceMethod.

Wenn Sie sowohl replaceMethod als auch imageReplaceMethod angeben, hat imageReplaceMethod Vorrang.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Bildersetzungsmethode.

Wenn Sie sowohl replaceMethod als auch imageReplaceMethod angeben, hat imageReplaceMethod Vorrang.

Wenn Sie keinen Wert für imageReplaceMethod, aber einen Wert für replaceMethod angeben, wird der angegebene Wert für replaceMethod verwendet.

Wenn Sie keines von beiden angeben, wird CENTER_INSIDE verwendet.

pageObjectIds[]

string

Wenn das Feld nicht leer ist, werden die Übereinstimmungen auf Seitenelemente auf den angegebenen Seiten beschränkt.

Es wird der Fehler 400 „Bad Request“ zurückgegeben, wenn die Seitenobjekt-ID einer notes page oder notes master angegeben wird oder wenn in der Präsentation keine Seite mit dieser Objekt-ID vorhanden ist.

Union-Feld criteria. Die Kriterien, die die Formen erfüllen müssen, um ersetzt zu werden. criteria darf nur einen der folgenden Werte haben:
containsText

object (SubstringMatchCriteria)

Wenn diese Option festgelegt ist, werden mit dieser Anfrage alle Formen ersetzt, die den angegebenen Text enthalten.

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einen der folgenden Werte haben:
imageUrl

string

Die Bild-URL.

Das Bild wird beim Einfügen einmal abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL darf maximal 2 KB lang sein. Die URL selbst wird mit dem Bild gespeichert und über das Feld Image.source_url freigegeben.

ReplaceMethod

Die replace-Methode.

Enums
CENTER_INSIDE Das Bild wird skaliert und zentriert, damit es in die Grenzen der ursprünglichen Form passt. Das Seitenverhältnis des Bildes bleibt dabei erhalten. Die gerenderte Größe des Bilds kann kleiner als die Größe der Form sein. Dies ist die Standardmethode, wenn keine andere angegeben wird.
CENTER_CROP Das Bild wird skaliert und zentriert, um die Begrenzungen der ursprünglichen Form zu füllen. Das Bild wird möglicherweise zugeschnitten, um die Form auszufüllen. Die gerenderte Größe des Bilds entspricht der Größe der ursprünglichen Form.

ImageReplaceMethod

Die Bildersetzungsmethode.

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Nicht angegebene Methode zum Ersetzen von Bildern. Dieser Wert darf nicht verwendet werden.
CENTER_INSIDE Das Bild wird skaliert und zentriert, damit es in die Grenzen der ursprünglichen Form passt. Das Seitenverhältnis des Bildes bleibt dabei erhalten. Die gerenderte Größe des Bilds kann kleiner als die Größe der Form sein. Dies ist die Standardmethode, wenn keine andere angegeben wird.
CENTER_CROP Das Bild wird skaliert und zentriert, um die Begrenzungen der ursprünglichen Form zu füllen. Das Bild wird möglicherweise zugeschnitten, um die Form auszufüllen. Die gerenderte Größe des Bildes entspricht der ursprünglichen Form.

DuplicateObjectRequest

Dupliziert ein Folien- oder Seitenelement.

Wenn Sie eine Folie duplizieren, wird die duplizierte Folie direkt nach der angegebenen Folie erstellt. Wenn Sie ein Seitenelement duplizieren, wird das Duplikat an derselben Position auf derselben Seite wie das Original platziert.

JSON-Darstellung 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Felder
objectId

string

Die ID des Objekts, das dupliziert werden soll.

objectIds

map (key: string, value: string)

Das duplizierte Objekt kann andere Objekte enthalten, z. B. wenn Sie eine Folie oder ein Gruppenseitenelement duplizieren. In dieser Zuordnung wird festgelegt, wie die IDs der duplizierten Objekte generiert werden: Die Schlüssel sind die IDs der ursprünglichen Objekte und die Werte sind die IDs, die dem entsprechenden duplizierten Objekt zugewiesen werden. Die ID des Duplikats des Quellobjekts kann auch in dieser Zuordnung angegeben werden. Verwenden Sie dazu denselben Wert des Felds objectId als Schlüssel und die neue gewünschte ID als Wert.

Alle Schlüssel müssen vorhandenen IDs in der Präsentation entsprechen. Alle Werte müssen in der Präsentation eindeutig sein und mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (stimmt mit dem regulären Ausdruck [a-zA-Z0-9_] überein). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck [a-zA-Z0-9_-:] überein). Die neue ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn IDs von Quellobjekten in der Karte fehlen, wird eine neue zufällige ID zugewiesen. Wenn die Zuordnungstabelle leer oder nicht festgelegt ist, erhalten alle duplizierten Objekte eine neue zufällige ID.

UpdateTextStyleRequest

Aktualisieren Sie das Textformat in einer Shape oder Table.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle mit dem zu formatierenden Text.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle, die den zu formatierenden Text enthält. Wenn sich objectId auf eine Tabelle bezieht, muss cellLocation einen Wert haben. Andernfalls darf es das nicht.

style

object (TextStyle)

Die Stile, die für den Text festgelegt werden sollen.

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Stils übereinstimmt, wird dieser Stil übernommen.

Bestimmte Änderungen am Textstil können andere Änderungen verursachen, die dem Verhalten des Google Präsentationen-Editors entsprechen sollen. Weitere Informationen finden Sie in der Dokumentation zu TextStyle.

textRange

object (Range)

Der Textbereich, der formatiert werden soll.

Der Bereich kann um benachbarte Zeilenumbrüche erweitert werden.

Wenn der Bereich einen ganzen Absatz enthält, der zu einer Liste gehört, wird auch der Aufzählungspunkt des Absatzes mit dem entsprechenden Textstil aktualisiert.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten style ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise den Textstil fett formatieren möchten, setzen Sie fields auf "bold".

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

ReplaceAllShapesWithSheetsChartRequest

Ersetzt alle Formen, die den angegebenen Kriterien entsprechen, durch das bereitgestellte Google Tabellen-Diagramm. Das Diagramm wird skaliert und zentriert, damit es in die Grenzen der ursprünglichen Form passt.

HINWEIS: Für das Ersetzen von Formen durch ein Diagramm ist mindestens einer der OAuth-Bereiche „spreadsheets.readonly“, „spreadsheets“, „drive.readonly“ oder „drive“ erforderlich.

JSON-Darstellung 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Felder
containsText

object (SubstringMatchCriteria)

Die Kriterien, die die Formen erfüllen müssen, um ersetzt zu werden. Durch die Anfrage werden alle Formen ersetzt, die den angegebenen Text enthalten.

spreadsheetId

string

Die ID der Google Tabellen-Tabelle, die das Diagramm enthält.

chartId

integer

Die ID des jeweiligen Diagramms in der Google Tabellen-Tabelle.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn Sie keine Angabe machen, wird das Diagramm als nicht verknüpftes Bild angezeigt.

pageObjectIds[]

string

Wenn das Feld nicht leer ist, werden die Übereinstimmungen auf Seitenelemente auf den angegebenen Seiten beschränkt.

Es wird der Fehler 400 „Bad Request“ zurückgegeben, wenn die Seitenobjekt-ID einer notes page oder einer notes master angegeben wird oder wenn in der Präsentation keine Seite mit dieser Objekt-ID vorhanden ist.

LinkingMode

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist.

Enums
NOT_LINKED_IMAGE Das Diagramm ist nicht mit der Quelltabelle verknüpft und kann nicht aktualisiert werden. Ein nicht verknüpftes Diagramm wird als Bild eingefügt.
LINKED Wenn Sie das Diagramm verknüpfen, kann es aktualisiert werden. Andere Mitbearbeiter sehen dann einen Link zur Tabelle.

DeleteParagraphBulletsRequest

Löscht Aufzählungspunkte aus allen Absätzen, die sich mit dem angegebenen Textindex range überschneiden.

Die Verschachtelungsebene jedes Absatzes wird visuell beibehalten, indem der Anfang des entsprechenden Absatzes eingerückt wird.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle, die den Text enthält, aus dem Aufzählungspunkte gelöscht werden sollen.

cellLocation

object (TableCellLocation)

Optionaler Tabellenzellenstandort, wenn sich der zu ändernde Text in einer Tabellenzelle befindet. Sofern vorhanden, muss sich das objectId auf eine Tabelle beziehen.

textRange

object (Range)

Der Textbereich, aus dem Aufzählungspunkte anhand von TextElement-Indexen gelöscht werden sollen.

UpdateParagraphStyleRequest

Aktualisiert das Styling für alle Absätze innerhalb einer Shape oder Table, die sich mit dem angegebenen Textindexbereich überschneiden.

JSON-Darstellung 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Form oder Tabelle mit dem zu formatierenden Text.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle, die die zu formatierenden Absätze enthält. Wenn sich objectId auf eine Tabelle bezieht, muss cellLocation einen Wert haben. Andernfalls darf es das nicht.

style

object (ParagraphStyle)

Der Stil des Absatzes.

textRange

object (Range)

Der Textbereich mit den Absätzen, die formatiert werden sollen.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten style ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Absatzausrichtung aktualisieren möchten, legen Sie fields auf "alignment" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdateTableBorderPropertiesRequest

Aktualisiert die Eigenschaften der Tabellenränder in einer Table.

JSON-Darstellung 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der den Teil der Tabelle darstellt, auf den die Aktualisierungen angewendet werden. Wenn kein Tabellenbereich angegeben ist, werden die Änderungen auf die gesamte Tabelle angewendet.

borderPosition

enum (BorderPosition)

Die Position des Rahmens im Tabellenbereich, auf den die Aktualisierungen angewendet werden sollen. Wenn keine Rahmenposition angegeben ist, werden die Änderungen auf alle Rahmen im Tabellenbereich angewendet.

tableBorderProperties

object (TableBorderProperties)

Die zu aktualisierenden Eigenschaften des Tabellenrahmens.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableBorderProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe der durchgehenden Füllung des Tabellenrahmens aktualisieren möchten, setzen Sie fields auf "tableBorderFill.solidFill.color".

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

BorderPosition

Die Position des Tabellenrahmens.

Enums
ALL Alle Grenzen im Bereich.
BOTTOM Ränder am unteren Rand des Bereichs
INNER Rahmen innerhalb des Bereichs.
INNER_HORIZONTAL Horizontale Rahmenlinien innerhalb des Bereichs.
INNER_VERTICAL Vertikale Rahmenlinien innerhalb des Bereichs.
LEFT Rahmen links vom Bereich
OUTER Rahmen an der Außenseite des Bereichs.
RIGHT Rahmen rechts neben dem Bereich
TOP Ränder am oberen Rand des Bereichs

UpdateTableColumnPropertiesRequest

Aktualisiert die Eigenschaften einer Table-Spalte.

JSON-Darstellung 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

columnIndices[]

integer

Die Liste der nullbasierten Indizes, die angeben, welche Spalten aktualisiert werden sollen. Wenn keine Indizes angegeben werden, werden alle Spalten in der Tabelle aktualisiert.

tableColumnProperties

object (TableColumnProperties)

Die zu aktualisierenden Eigenschaften der Tabellenspalte.

Wenn der Wert von tableColumnProperties#columnWidth in der Anfrage unter 406.400 EMU (32 Punkte) liegt, wird der Fehler 400 zurückgegeben.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableColumnProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Spaltenbreite aktualisieren möchten, setzen Sie fields auf "columnWidth".

Wenn „columnWidth“ in der Feldmaske enthalten ist, die Property aber nicht festgelegt ist,wird die Spaltenbreite standardmäßig auf 406.400 EMU (32 Punkte) festgelegt.

UpdateTableRowPropertiesRequest

Aktualisiert die Eigenschaften einer Table-Zeile.

JSON-Darstellung 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

rowIndices[]

integer

Die Liste der nullbasierten Indizes, die angeben, welche Zeilen aktualisiert werden sollen. Wenn keine Indizes angegeben werden, werden alle Zeilen in der Tabelle aktualisiert.

tableRowProperties

object (TableRowProperties)

Die zu aktualisierenden Eigenschaften der Tabellenzeile.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableRowProperties ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Mindestzeilenhöhe aktualisieren möchten, setzen Sie fields auf "minRowHeight".

Wenn „minRowHeight“ in der Feldmaske enthalten ist, die Property aber nicht festgelegt ist, wird die Mindestzeilenhöhe standardmäßig auf „0“ gesetzt.

MergeTableCellsRequest

Zellen in einer Table zusammenführen

JSON-Darstellung 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der angibt, welche Zellen der Tabelle zusammengeführt werden sollen.

Der Text in den zusammengeführten Zellen wird zusammengefügt und in der linken oberen Zelle („Header“) des Bereichs gespeichert. Wenn der Bereich nicht rechteckig ist (was in einigen Fällen vorkommen kann, wenn der Bereich Zellen umfasst, die bereits zusammengeführt wurden), wird der Fehler 400 „Bad Request“ zurückgegeben.

UnmergeTableCellsRequest

Heben Sie den Zellenverbund in einer Table auf.

JSON-Darstellung 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Felder
objectId

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der angibt, welche Zellen der Tabelle getrennt werden sollen.

Alle zusammengeführten Zellen in diesem Bereich werden getrennt. Zellen, die bereits getrennt sind, sind davon nicht betroffen. Wenn der Bereich keine zusammengeführten Zellen enthält, geschieht durch die Anfrage nichts. Wenn eine der verbundenen Zellen Text enthält, bleibt der Text in der Zelle links oben („Anfang“) des resultierenden Blocks nicht zusammengeführter Zellen erhalten.

GroupObjectsRequest

Hiermit werden Objekte zu einer Objektgruppe gruppiert. Beispiel: Gruppen PageElements, um eine Group auf derselben Seite wie alle untergeordneten Elemente zu erstellen.

JSON-Darstellung 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Felder
groupObjectId

string

Eine vom Nutzer angegebene Objekt-ID für die zu erstellende Gruppe.

Wenn Sie eine ID angeben, muss sie unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die restlichen Zeichen können diese Zeichen sowie einen Bindestrich oder einen Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige ID generiert.

childrenObjectIds[]

string

Die Objekt-IDs der zu gruppierenden Objekte.

Nur Seitenelemente können gruppiert werden. Auf derselben Seite sollten mindestens zwei Seitenelemente vorhanden sein, die sich nicht bereits in einer anderen Gruppe befinden. Einige Seitenelemente wie videos, tables und placeholders können nicht gruppiert werden.

UngroupObjectsRequest

Heben Sie die Gruppierung von Objekten wie groups auf.

JSON-Darstellung 
{
  "objectIds": [
    string
  ]
}
Felder
objectIds[]

string

Die Objekt-IDs der Objekte, deren Gruppierung aufgehoben werden soll.

Nur groups, die sich nicht in anderen groups befinden, können aufgelöst werden. Alle Gruppen sollten sich auf derselben Seite befinden. Die Gruppe selbst wird gelöscht. Die visuellen Größen und Positionen aller untergeordneten Elemente bleiben erhalten.

UpdatePageElementAltTextRequest

Aktualisiert den Titel und/oder die Beschreibung des Alt-Texts einer page element.

JSON-Darstellung 
{
  "objectId": string,
  "title": string,
  "description": string
}
Felder
objectId

string

Die Objekt-ID des Seitenelements, auf das die Änderungen angewendet werden.

title

string

Der aktualisierte Alt-Text des Seitenelements. Wenn der Wert nicht festgelegt ist, bleibt der vorhandene Wert erhalten. Der Titel ist für Screenreader und andere Bedienungshilfen sichtbar. Verwenden Sie nur für Nutzer lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

description

string

Die aktualisierte Alt-Text-Beschreibung des Seitenelements. Wenn der Wert nicht festgelegt ist, bleibt der vorhandene Wert erhalten. Die Beschreibung wird für Screenreader und andere Bedienungshilfen angezeigt. Verwenden Sie nur für Nutzer lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

ReplaceImageRequest

Ersetzt ein vorhandenes Bild durch ein neues.

Wenn Sie ein Bild ersetzen, werden einige image effects aus dem vorhandenen Bild entfernt.

JSON-Darstellung 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Felder
imageObjectId

string

Die ID des vorhandenen Bildes, das ersetzt werden soll. Die ID kann aus der Antwort einer GET-Anfrage abgerufen werden.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Ersetzungsmethode.

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einen der folgenden Werte haben:
url

string

Die Bild-URL.

Das Bild wird beim Einfügen einmal abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL darf maximal 2 KB lang sein. Die URL wird mit dem Bild gespeichert und über das Feld Image.source_url bereitgestellt.

UpdateSlidePropertiesRequest

Aktualisiert die Eigenschaften einer Folie.

JSON-Darstellung 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Felder
objectId

string

Die Objekt-ID der Folie, auf die das Update angewendet wird.

slideProperties

object (SlideProperties)

Die zu aktualisierenden Folieneigenschaften.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Das Stammelement „slideProperties“ ist implizit und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise festlegen möchten, ob eine Folie übersprungen werden soll, setzen Sie fields auf "isSkipped".

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

UpdatePageElementsZOrderRequest

Aktualisiert die Z-Reihenfolge der Seitenelemente. Die Z-Reihenfolge ist eine Anordnung der Elemente auf der Seite von hinten nach vorne. Das vordere Seitenelement kann die Elemente dahinter verdecken.

JSON-Darstellung 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Felder
pageElementObjectIds[]

string

Die Objekt-IDs der zu aktualisierenden Seitenelemente.

Alle Seitenelemente müssen sich auf derselben Seite befinden und dürfen nicht gruppiert sein.

operation

enum (ZOrderOperation)

Die Z-Reihenfolge, die auf die Seitenelemente angewendet werden soll.

Wenn der Vorgang auf mehrere Seitenelemente angewendet wird, bleiben die relativen Z-Reihenfolgen innerhalb dieser Seitenelemente vor dem Vorgang erhalten.

ZOrderOperation

Der Vorgang zum Aktualisieren der Z-Reihenfolge eines Seitenelements.

Enums
Z_ORDER_OPERATION_UNSPECIFIED Nicht angegebener Vorgang.
BRING_TO_FRONT Die Seitenelemente werden in den Vordergrund der Seite gebracht.
BRING_FORWARD Die Seitenelemente werden auf der Seite um ein Element nach vorne verschoben, bezogen auf das jeweils vorderste Element der angegebenen Seitenelemente.
SEND_BACKWARD Versetzt die Seitenelemente auf der Seite um ein Element nach hinten, bezogen auf das Element, das am weitesten hinten in den angegebenen Seitenelementen liegt.
SEND_TO_BACK Versetzt die Seitenelemente in den Hintergrund.

UpdateLineCategoryRequest

Aktualisiert die Kategorie eines line.

JSON-Darstellung 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Felder
objectId

string

Die Objekt-ID der Zeile, auf die das Update angewendet wird.

Nur eine Linie mit einem category, das für einen „Verbinder“ steht, kann aktualisiert werden.

Die Linie wird möglicherweise nach der Aktualisierung der Kategorie umgeleitet.

lineCategory

enum (LineCategory)

Die zu aktualisierende Position.

Die genaue line type wird anhand der Kategorie bestimmt, auf die aktualisiert werden soll, und der Weiterleitung an andere Seitenelemente.

RerouteLineRequest

Eine line wird so umgeleitet, dass sie an den beiden Verbindungsstellen auf den verbundenen Seitenelementen verbunden ist.

JSON-Darstellung 
{
  "objectId": string
}
Felder
objectId

string

Die Objekt-ID der Linie, die umgeleitet werden soll.

Nur eine Linie mit einem category, das für einen „Verbinder“ steht, kann umgeleitet werden. Die Start- und Endverbindungen der Linie müssen sich auf verschiedenen Seitenelementen befinden.