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 Die Art des Updates. Es ist genau ein Feld erforderlich. kind darf nur einen der folgenden Werte haben:
createSlide

object (CreateSlideRequest)

Erstellt eine neue Folie.

createShape

object (CreateShapeRequest)

Erstellt eine neue Form.

createTable

object (CreateTableRequest)

: Erstellt eine neue Tabelle.

insertText

object (InsertTextRequest)

Fügt Text in eine Form oder eine Tabellenzelle ein.

insertTableRows

object (InsertTableRowsRequest)

Zeilen in eine Tabelle einfügen

insertTableColumns

object (InsertTableColumnsRequest)

Fügt Spalten in eine Tabelle ein.

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 Tabellenzelle.

createImage

object (CreateImageRequest)

Erstellt ein Image.

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 Tabellen-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ählungszeichen 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 den Stil von Text 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ählungszeichen aus Absätzen.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualisiert den Stil von Absätzen in einem 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)

Verbindet Zellen in einem Table

unmergeTableCells

object (UnmergeTableCellsRequest)

Hebt den Zellenverbund in einem auf Table

groupObjects

object (GroupObjectsRequest)

Gruppiert Objekte wie Seitenelemente.

ungroupObjects

object (UngroupObjectsRequest)

Hebt die Gruppierung von Objekten auf, z. B. groups

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Aktualisiert den Titel und/oder die Beschreibung eines page element

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Image 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 (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_]); Die verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein) [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 Folie, die eingefügt werden soll, basierend auf dem aktueller Master. Dies ist einer der folgenden Werte:

  • Der Master des vorherigen Folienindex.
  • Der Master der ersten Folie, wenn der „insertionIndex“ null ist.
  • Der erste Master der Präsentation, falls 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 auf Folgendes verweisen:

  • 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 kann nur einer der folgenden Werte sein:
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 spezifiziertes Layout.
BLANK Leeres Layout ohne Platzhalter.
CAPTION_ONLY Layout mit einer Bildunterschrift am unteren Rand.
TITLE Layout mit Titel und 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 Titel und Unterüberschrift auf der einen Seite und 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 Zahl als Ü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 bereitgestellte Objekt-ID für den oben angegebenen Platzhalter, der auf einer Folie erstellt werden soll.

Wenn Sie eine ID angeben, muss diese unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_]); Die verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 oder größer als 50 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 kann nur einer der folgenden Werte sein:
layoutPlaceholder

object (Placeholder)

Der Platzhalter in einem Layout, der auf eine Folie angewendet wird. Nur type und index erforderlich sind. Ein vordefinierter TITLE_AND_BODY kann das Layout einen TITLE-Platzhalter mit Index 0 und einen BODY-Platzhalter mit Index 0 haben.

layoutPlaceholderObjectId

string

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

CreateShapeRequest

Erstellt eine neue Form.

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 diese unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_]); Die verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_-:]). Die ID darf nicht kürzer als 5 oder größer als 50 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 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 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 Sie keine Größe angeben, wird die Größe der Tabelle automatisch angepasst.

Tabellentransformationen müssen den Maßstab 1 haben und dürfen 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 wird.

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 im aktuellen Einfügungsindex kopiert, einschließlich Listen und Aufzählungszeichen.

Textstile für eingefügten Text werden automatisch ermittelt, wobei im Allgemeinen der Stil des angrenzenden Textes beibehalten wird. 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 Bereich „Private Use“ der Unicode Basic Multilingual Plane (U+E000–U+F8FF) werden aus dem eingefügten Text entfernt.

insertionIndex

integer

Der Index, in den der Text eingefügt wird, in Unicode-Codeeinheiten, basierend auf TextElement Indexe.

Der Index ist nullbasiert und wird ab dem Beginn des Strings 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 Graphem-Cluster 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 Zellen 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 : über der Zelle einfügen.
number

integer

Die Anzahl der Zeilen, die eingefügt werden sollen. Maximal 20 pro Anfrage.

InsertTableColumnsRequest

Fügt Spalten in eine Tabelle ein.

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

Die Tabelle, in die Spalten eingefügt werden sollen.

cellLocation

object (TableCellLocation)

Die Zellenposition der Referenztabelle, 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 von der Position der Referenzzelle eingefügt werden sollen.

  • True : rechts einfügen.
  • 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 Referenztabelle, von der aus 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 Zelle 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, durch den der übereinstimmende Text ersetzt wird.

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 oder wenn eine Seite mit dieser Objekt-ID nicht in der Präsentation vorhanden ist.

Union-Feld criteria Die Kriterien, anhand derer der zu ersetzende Text abgeglichen wird. criteria kann nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

Findet Text in einer Form, die mit dieser Teilzeichenfolge übereinstimmt.

SubstringMatchCriteria

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

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

string

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.

DeleteObjectRequest

Löscht ein Objekt, entweder 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 übernehmenden 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 Wendet die neue AffineTransform-Matrix auf die vorhandene an und ersetzt die vorhandene durch die resultierende Verkettung.
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 vorhandenen Präsentationsreihenfolge vorliegen (ohne Duplikate).

insertionIndex

integer

Der Index, an dem die Folien eingefügt werden sollen, basierend auf der Folienanordnung vor dem Verschieben. Der Wert muss zwischen 0 und der Anzahl der Folien der Präsentation (einschließlich) liegen.

DeleteTextRequest

Löscht Text aus einer Form oder 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 wird.

cellLocation

object (TableCellLocation)

Die optionale Position der Tabellenzelle, wenn der Text aus einer Tabellenzelle gelöscht werden soll. Falls vorhanden, muss die Objekt-ID auf eine Tabelle verweisen.

textRange

object (Range)

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

Am Ende des Textes einer Form oder einer Tabellenzelle steht immer ein implizites Zeilenumbruchzeichen, das nicht gelöscht werden kann. Range.Type.ALL verwendet die richtigen Grenzen, aber Sie müssen vorsichtig sein, wenn Sie explizite Grenzen für Bereichstypen festlegen. FROM_START_INDEX und FIXED_RANGE 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 Ersatzwertpaars 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 Typ des Bereichs.

Typ

Die Bereichstypen.

Enums
RANGE_TYPE_UNSPECIFIED Nicht angegebener Bereichstyp. Dieser Wert darf nicht verwendet werden.
FIXED_RANGE Ein fester Bereich. Sowohl die startIndex und endIndex angegeben werden.
FROM_START_INDEX Beginn des Bereichs bei startIndex bis zum Ende der Sammlung. Die 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 Image.

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 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 darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige 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.

Die 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 kann nur einer der folgenden Werte sein:
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ß sein, dürfen nicht mehr als 25 Megapixel haben und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

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

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 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 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.

Die 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 oben links auf der Seite platziert.

source

enum (Source)

Die Videoquelle.

id

string

Die eindeutige Kennung der Videoquelle für dieses Video.

z.B. Für YouTube-Videos https://www.youtube.com/watch?v=7U3axjORYZ0 lautet die ID 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.

Um auf eine Google Drive-Videodatei zuzugreifen, müssen Sie möglicherweise für eine Teilmenge der alten Dateien einen Ressourcenschlüssel zum HTTP-Header hinzufügen. Weitere Informationen finden Sie unter Mit Ressourcenschlüsseln auf per Link freigegebene Dateien zugreifen

CreateSheetsChartRequest

Erstellt ein eingebettetes Google Tabellen-Diagramm.

HINWEIS: Zum Erstellen von Diagrammen ist mindestens einer der folgenden OAuth-Bereiche erforderlich: spreadsheet.readonly, spreadsheet, drive.readonly, drive.file oder drive.

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

Falls die ID angegeben wird, muss sie für alle Seiten und Seitenelemente in der Präsentation eindeutig sein. Die ID sollte mit einem Wortzeichen [a-zA-Z0-9_] beginnen und dann von einer beliebigen Anzahl der folgenden Zeichen [a-zA-Z0-9_-:] gefolgt werden. 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-Tabelle, die das Diagramm enthält.

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

chartId

integer

Die ID des Diagramms in der Tabelle in Google Tabellen.

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. Nicht verknüpfte Diagramme werden 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 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 darf nicht kürzer als 5 Zeichen und nicht länger als 50 Zeichen sein.

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Linie.

lineCategory
(deprecated)

enum (Category)

Die Kategorie der zu erstellenden Linie.

Verworfen : Verwenden Sie stattdessen category.

Die genaue line type erstellt wird, hängt von der Kategorie ab und davon, wie sie weitergeleitet wird, um eine Verbindung zu anderen Seitenelementen herzustellen.

Wenn Sie sowohl ein category und lineCategory, der category hat 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 für jedes Element category, aber geben Sie einen Wert für lineCategory, dann die angegebene lineCategory -Wert verwendet.

Wenn Sie keines von beiden angeben, wird STRAIGHT verwendet.

Kategorie

Die Linienkategorien.

Enums
STRAIGHT Gerade Leitungsverbinder, einschließlich gerader Leitungsverbinder 1. Dies ist die Standardkategorie, wenn keine angegeben wird.
BENT Gebogene Verbindungen, einschließlich der gebogenen Verbindungen 2 bis 5.
CURVED Gekrümmte Verbindungen, einschließlich gebogener Verbindung 2 bis 5.

RefreshSheetsChartRequest

Aktualisiert ein eingebettetes Google Tabellen-Diagramm, indem es durch die neueste 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 Aktualisierungen 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. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Volltonfarbe für den Hintergrund einer Form zu aktualisieren, legen Sie fields bis "shapeBackgroundFill.solidFill.color".

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

UpdateImagePropertiesRequest

Aktualisieren Sie die Eigenschaften eines Image

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

string

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

imageProperties

object (ImageProperties)

Die Bildeigenschaften, die aktualisiert werden sollen.

fields

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stamm imageProperties ist impliziert und sollte 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

Die Eigenschaften eines 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 Stamm videoProperties ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Umrissfarbe des Videos zu aktualisieren, fields bis "outline.outlineFill.solidFill.color".

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

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 Änderung 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 Stamm pageProperties ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Um beispielsweise die Volltonfarbe für den Seitenhintergrund zu aktualisieren, legen Sie fields bis "pageBackgroundFill.solidFill.color".

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

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 die Teilmenge der Tabelle darstellt, auf die die Aktualisierungen angewendet werden. Wenn kein Tabellenbereich angegeben ist, werden die Änderungen auf die gesamte Tabelle angewendet.

tableCellProperties

object (TableCellProperties)

Die Eigenschaften der Tabellenzellen, die aktualisiert werden sollen.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableCellProperties ist implizit und muss nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Volltonfarbe für den Hintergrund der Tabellenzelle zu aktualisieren, fields bis "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 stellt einen Verweis auf eine Teilmenge einer Tabelle dar.

Beachten Sie, dass die durch einen Tabellenbereich angegebenen Zellen nicht unbedingt ein Rechteck bilden. Nehmen wir beispielsweise an, wir haben eine 3 x 3-Tabelle, in der alle Zellen der letzten Zeile zusammengeführt sind. Die Tabelle sieht so aus: 

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

Ein Tabellenbereich mit Standort = (0, 0), Zeilenspanne = 3 und Spaltenspanne = 2 gibt die folgenden Zellen an: 

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

object (TableCellLocation)

Der Ausgangspunkt des Tabellenbereichs.

rowSpan

integer

Der Zeilenumfang des Tabellenbereichs.

columnSpan

integer

Die Spaltenspanne des Tabellenbereichs.

UpdateLinePropertiesRequest

Aktualisiert die Eigenschaften eines 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 Stamm lineProperties ist impliziert und sollte 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 Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

CreateParagraphBulletsRequests

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 unnötigen Abstand zwischen dem Aufzählungszeichen und dem entsprechenden Absatz zu vermeiden, werden diese führenden Tabulatoren im Rahmen dieser Anfrage entfernt. Dadurch können sich die Indizes der Teile des Textes ä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. Falls vorhanden, muss die Objekt-ID auf eine Tabelle verweisen.

textRange

object (Range)

Der Textbereich, auf den die Voreinstellungen für Aufzählungszeichen angewendet werden sollen, basierend auf TextElement Indexe.

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.

In diesen Mustern werden folgende Arten von Aufzählungspunkten 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 einem 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 leere Raute, die einem Unicode-U+25c7-Codepunkt entspricht
  • DISC : Ein solider Kreis, der dem Unicode-Codepunkt U+25cf entspricht
  • SQUARE : Ein ausgefülltes Quadrat, das einem Codepunkt in Unicode U+25a0 entspricht
  • STAR : Ein Stern, der dem Unicode-Codepunkt U+2605 entspricht
  • ALPHA : Ein Kleinbuchstabe wie „a“, „b“ oder „c“.
  • UPPERALPHA : Ein Großbuchstaben 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 wird keine Null vorangestellt.
  • ROMAN : Eine kleine römische Zahl wie „i“, „ii“ oder „iii“.
  • UPPERROMAN : Eine große römische Zahl wie "I", "II" oder "III".
  • LEFTTRIANGLE : Ein nach links zeigendes Dreieck, das einem Unicode-U+25c4-Codepunkt 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 einem STAR, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit einem ARROW3D, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit einem LEFTTRIANGLE, DIAMOND und DISC Aufzählungszeichen 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 DIGIT, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Eine nummerierte Liste mit DIGIT, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Klammern.
NUMBERED_DIGIT_NESTED Eine nummerierte Liste mit DIGIT numerische Glyphen, die durch Punkte getrennt sind, wobei für jede Verschachtelungsebene das Glyphe der vorherigen Verschachtelungsebene als Präfix verwendet wird. Beispiel: '1.', "1.1.", '2.', „2.2.“.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Eine nummerierte Liste mit UPPERALPHA, ALPHA und ROMAN numerische Glyphen 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 ZERODIGIT, ALPHA und ROMAN numerische Glyphen 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 Formen 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.

Eingestellt : Verwenden Sie imageReplaceMethod .

Wenn Sie sowohl ein replaceMethod und imageReplaceMethod, der imageReplaceMethod hat Vorrang.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Methode zum Ersetzen von Bildern.

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

Wenn Sie für jedes Element imageReplaceMethod, aber geben Sie einen Wert für replaceMethod, dann die angegebene replaceMethod -Wert 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, denen die Formen entsprechen müssen, damit sie ersetzt werden können. criteria kann nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

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

Union-Feld image_source. Die Art der Bildquelle. image_source kann nur einer der folgenden Werte sein:
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 nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die bereitgestellte URL darf höchstens 2 KB lang sein. Die URL selbst wird mit dem Bild gespeichert und über das Image.source_url ein.

ReplaceMethod

Die Ersetzungsmethode.

Enums
CENTER_INSIDE Skaliert und zentriert das Bild, sodass es in die Grenzen der ursprünglichen Form passt und das Seitenverhältnis des Bildes beibehalten wird. 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. Das gerenderte Bild des Bildes ist möglicherweise kleiner als die Größe der Form. Dies ist die Standardmethode, wenn keine angegeben wurde.
CENTER_CROP Skaliert und zentriert das Bild, damit es die Grenzen der ursprünglichen Form ausfüllt. Das Bild wird möglicherweise zugeschnitten, um die Form auszufüllen. Das Bild wird in derselben Größe wie die ursprüngliche Form gerendert.

DuplicateObjectRequest

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

Beim Duplizieren einer Folie wird das Duplikat direkt nach der angegebenen Folie erstellt. Beim Duplizieren eines Seitenelements wird das Duplikat an derselben Position wie das Original auf derselben Seite platziert.

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

string

Die ID des zu duplizierenden Objekts.

objectIds

map (key: string, value: string)

Das zu duplizierende Objekt kann andere Objekte enthalten, z. B. beim Duplizieren einer Folie oder eines Gruppenseitenelements. 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 Länge der neuen ID darf nicht weniger als 5 und nicht mehr als 50 Zeichen betragen.

Wenn IDs von Quellobjekten in der Zuordnung fehlen, wird eine neue zufällige ID zugewiesen. Wenn die Karte leer oder nicht konfiguriert ist, erhalten alle doppelten Objekte eine neue Zufalls-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 Text, der formatiert werden soll.

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 auf die Übernahme festgelegt.

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 auf 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 Felder, die aktualisiert werden sollen.

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

Um den Textstil beispielsweise in Fettdruck zu ändern, setzen Sie fields bis "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 angegebene Google Tabellen-Diagramm. Das Diagramm wird so skaliert und zentriert, dass 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. Die Anforderung ersetzt alle Formen, die den gegebenen Text enthalten.

spreadsheetId

string

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

chartId

integer

Die ID des Diagramms in der Tabelle in Google Tabellen.

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 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. Nicht verknüpfte Diagramme werden als Bild eingefügt.
LINKED Wenn Sie das Diagramm verknüpfen, kann es aktualisiert werden. Andere Mitbearbeiter sehen einen Link zur Tabelle.

DeleteParagraphBulletsRequests

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

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 mit dem Text, aus dem Aufzählungspunkte gelöscht werden sollen.

cellLocation

object (TableCellLocation)

Optionaler Tabellenzellenspeicherort, wenn sich der zu ändernde Text in einer Tabellenzelle befindet. Falls vorhanden, muss die Objekt-ID auf eine Tabelle verweisen.

textRange

object (Range)

Der Textbereich, aus dem Aufzählungspunkte gelöscht werden sollen, basierend auf TextElement Indexe.

UpdateParagraphStyleRequest

Aktualisiert den Stil für alle Absätze in einem Shape oder Table die sich mit dem angegebenen Textindexbereich überlappen.

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 Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten style ist implizit und muss nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Absatzausrichtung zu aktualisieren, legen Sie fields bis "alignment".

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

UpdateTableBorderPropertiesRequest

Aktualisiert die Eigenschaften der Tabellenrahmen in einem 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 die Teilmenge der Tabelle darstellt, auf die 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 Sie keine Rahmenposition angeben, 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.

Um beispielsweise die Volltonfarbe für den Tabellenrahmen zu aktualisieren, fields bis "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 Rahmen am unteren Rand des Bereichs.
INNER Rahmenlinien innerhalb des Bereichs.
INNER_HORIZONTAL Horizontale Rahmenlinien innerhalb des Bereichs.
INNER_VERTICAL Vertikale Rahmenlinien innerhalb des Bereichs.
LEFT Rahmenlinien links neben dem Bereich.
OUTER Rahmenlinien außerhalb des Bereichs.
RIGHT Rahmen rechts neben dem Bereich
TOP Rahmenlinien 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 Indexe 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 kleiner als 406.400 EMU (32 Punkte) ist, wird der Fehler 400 zurückgegeben.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Um beispielsweise die Spaltenbreite zu aktualisieren, fields bis "columnWidth".

Wenn „columnWidth“ in der Feldmaske enthalten ist, aber die Eigenschaft 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 Indexe angegeben werden, werden alle Zeilen in der Tabelle aktualisiert.

tableRowProperties

object (TableRowProperties)

Die zu aktualisierenden Tabellenzeileneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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, aber die Eigenschaft nicht festgelegt ist, wird die minimale Zeilenhöhe standardmäßig auf 0 gesetzt.

MergeTableCellsRequest

Verbindet Zellen in einem Table

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, in denen der Bereich Zellen umfasst, die bereits verbunden sind), wird der Fehler 400 ungültig.

UnmergeTableCellsRequest

Hebt den Zellenverbund in einem auf Table

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der angibt, für welche Zellen der Tabelle der Zellenverbund aufgehoben werden soll.

Alle zusammengeführten Zellen in diesem Bereich werden getrennt. Zellen, die bereits getrennt sind, sind davon nicht betroffen. Wenn der Bereich keine verbundenen Zellen enthält, führt die Anfrage nichts aus. Wenn sich in einer der zusammengeführten Zellen Text befindet, bleibt der Text in der oberen linken Zelle (Hauptzelle) des resultierenden Blocks mit nicht verbundenen Zellen.

GroupObjectsRequest

Gruppiert Objekte, um eine Objektgruppe zu erstellen. 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 bereitgestellte Objekt-ID für die zu erstellende Gruppe.

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

childrenObjectIds[]

string

Die Objekt-IDs der zu gruppierenden Objekte.

Nur Seitenelemente können gruppiert werden. Es sollte mindestens zwei Seitenelemente auf derselben Seite geben, die sich nicht bereits in einer anderen Gruppe befinden. Einige Seitenelemente wie videos, tables und placeholders kann 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 nicht in anderen groups Gruppierung aufheben können. 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 eines page element

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

string

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

title

string

Der aktualisierte Titel des Alt-Textes des Seitenelements. Wenn kein Wert festgelegt ist, wird der vorhandene Wert beibehalten. Der Titel ist für Screenreader und andere Bedienungshilfen zugänglich. 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 ist für Screenreader und andere Bedienungshilfen zugänglich. Verwenden Sie nur für Nutzer lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

ReplaceImageRequest

Ersetzt ein vorhandenes Image 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 einmal beim Einfügen abgerufen und eine Kopie wird gespeichert, um in der Präsentation angezeigt zu werden. 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 Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stamm "slideProperties" ist impliziert 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 wird, stellen Sie fields bis "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 werden.

operation

enum (ZOrderOperation)

Operation der Z-Reihenfolge, die auf die Seitenelemente angewendet werden soll

Wenn Sie den Vorgang auf mehrere Seitenelemente anwenden, werden die relativen Z-Reihenfolgen innerhalb dieser Seitenelemente vor dem Vorgang beibehalten.

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 Bringt die Seitenelemente auf der Seite um ein Element nach vorn, bezogen auf das vorste Element in den angegebenen Seitenelementen.
SEND_BACKWARD Versetzt die Seitenelemente auf der Seite um ein Element zurück, das sich in den angegebenen Seitenelementen am weitesten hinten befindet.
SEND_TO_BACK Die Seitenelemente werden an den hinteren Teil der Seite verschoben.

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 auf einen „Anschluss“ hinweist, kann aktualisiert werden.

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

lineCategory

enum (LineCategory)

Die Linienkategorie, auf die aktualisiert werden soll.

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

RerouteLineRequest

Umleitung a line so, dass sie an den beiden nächstgelegenen Verbindungsstellen der verbundenen Seitenelemente verbunden sind.

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.