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. Für kind ist nur einer der folgenden Werte zulässig:
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 Tabellenzelle ein.

insertTableRows

object (InsertTableRowsRequest)

Fügt Zeilen in eine Tabelle ein.

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

createImage

object (CreateImageRequest)

Erstellt ein Bild.

createVideo

object (CreateVideoRequest)

Erstellt ein Video.

createSheetsChart

object (CreateSheetsChartRequest)

Erstellt ein eingebettetes Google Sheets-Diagramm.

createLine

object (CreateLineRequest)

Erstellt eine Linie.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aktualisiert ein Google Sheets-Diagramm.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualisiert die Attribute eines Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualisiert die Eigenschaften eines Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualisiert die Attribute eines Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualisiert die Attribute eines Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualisiert die Attribute eines TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aktualisiert die Attribute eines 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)

Dupliziert eine Folie oder ein Seitenelement.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert das Formatieren von Text in einem Shape- oder Table-Element.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Entfernt Aufzählungszeichen aus Absätzen.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

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

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualisiert die Eigenschaften der Tabellenränder in einem Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Attribute einer Table-Spalte.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aktualisiert die Attribute einer Table-Zeile.

mergeTableCells

object (MergeTableCellsRequest)

Führt Zellen in einem Table zusammen.

unmergeTableCells

object (UnmergeTableCellsRequest)

Hebt den Zellenverbund in einer Table auf.

groupObjects

object (GroupObjectsRequest)

Gruppiert Objekte wie Seitenelemente.

ungroupObjects

object (UngroupObjectsRequest)

Hebt die Gruppierung von Objekten wie groups auf.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Aktualisiert den Titel und/oder die Beschreibung des Alternativtexts eines page element.

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Bild durch ein neues Bild.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aktualisiert die Attribute 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 nächstgelegenen Verbindungspunkten der verbundenen Seitenelemente angeschlossen wird.

CreateSlideRequest

Erstellt eine Folie.

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

string

Eine vom Nutzer bereitgestellte 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 verbleibenden Zeichen dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [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 einer der folgenden Werte sein kann:

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

Wenn die LayoutReference im aktuellen Master nicht gefunden wird, wird der Fehler „400 Bad Request“ zurückgegeben.

Wenn Sie keine Layoutreferenz angeben, wird das vordefinierte Layout BLANK verwendet.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Eine optionale Liste von Objekt-ID-Zuordnungen aus dem placeholder (s) im 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. Das 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. Für kind ist nur einer der folgenden Werte zulässig:
predefinedLayout

enum (PredefinedLayout)

Vordefiniertes Layout

layoutId

string

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

PredefinedLayout

Vordefinierte Layouttypen Das sind häufig verwendete Layouts in Präsentationen. Es gibt jedoch keine Garantie dafür, dass diese Layouts im aktuellen Master vorhanden sind, da sie möglicherweise gelöscht wurden oder nicht Teil des verwendeten Designs sind. 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 Text.
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 Untertitel auf der einen Seite und Beschreibung auf der anderen Seite.
ONE_COLUMN_TEXT Layout mit einem Titel und einem Textkörper, die in einer einzelnen Spalte angeordnet sind.
MAIN_POINT Layout mit einem Hauptpunkt.
BIG_NUMBER Layout mit einer großen Überschrift mit einer Zahl.

LayoutPlaceholderIdMapping

Die vom Nutzer angegebene ID-Zuordnung für einen Platzhalter, der auf einer Folie aus einem angegebenen 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 identifizierten 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

Union-Feld kind. Die Art, mit der ein Platzhalter in einem Layout identifiziert wird. Für kind ist nur einer der folgenden Werte zulässig:
layoutPlaceholder

object (Placeholder)

Der Platzhalter in einem Layout, das auf eine Folie angewendet wird. Nur type und index sind erforderlich. Ein vordefiniertes TITLE_AND_BODY-Layout kann beispielsweise einen TITLE-Platzhalter mit dem Index 0 und einen BODY-Platzhalter mit dem 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 bereitgestellte 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementattribute für die Form.

shapeType

enum (Type)

Der Formtyp.

PageElementProperties

Allgemeine Eigenschaften für ein Seitenelement.

Hinweis: Wenn Sie ein PageElement erstellen, kann die API die Werte von size und transform ändern, 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 bereitgestellte 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

elementProperties

object (PageElementProperties)

Die Elementattribute für die Tabelle.

Die Tabelle wird in der angegebenen Größe erstellt, wobei eine Mindestgröße gilt. Wenn keine Größe angegeben ist, wird die Tabelle automatisch angepasst.

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

rows

integer

Anzahl der Zeilen in der Tabelle.

columns

integer

Anzahl der Spalten in der Tabelle.

InsertTextRequest

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

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)

Der optionale Speicherort der Tabellenzelle, wenn der Text in eine Tabellenzelle eingefügt werden soll. Falls vorhanden, muss sich die objectId auf eine Tabelle beziehen.

text

string

Der einzufügende Text.

Wenn Sie ein Zeilenumbruchzeichen einfügen, wird implizit ein neues ParagraphMarker an diesem Index 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 festgelegt. Dabei wird in der Regel der Stil des benachbarten Textes 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 Unicode Basic Multilingual Plane Private Use Area (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-Indizes.

Der Index ist nullbasiert und wird ab dem Anfang des Strings berechnet. Der Index kann angepasst werden, um Einfügungen in Unicode-Graphemclustern zu verhindern. In diesen Fällen wird der Text direkt nach dem Graphemcluster eingefügt.

InsertTableRowsRequest

Fügt Zeilen in eine Tabelle ein.

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

string

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

cellLocation

object (TableCellLocation)

Die Position der Referenztabellenzelle, ab der Zeilen eingefügt werden.

Eine neue Zeile wird über (oder unter) der Zeile eingefügt, in der sich die Referenzzelle befindet. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird eine neue Zeile über (oder unter) der zusammengeführten Zelle eingefügt.

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

Fügt Spalten in eine Tabelle ein.

Die Größe anderer 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 Position der Referenztabellenzelle, ab der Spalten eingefügt werden.

Eine neue Spalte wird links (oder rechts) von der Spalte eingefügt, in der sich die Referenzzelle befindet. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird eine neue Spalte links (oder rechts) von 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 : links einfügen.
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, über die sich diese Zelle erstreckt, wird gelöscht. Wenn es sich um eine zusammengeführte Zelle handelt, werden mehrere Zeilen gelöscht. Wenn nach dem Löschen 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 Referenztabellenzelle, aus der eine Spalte gelöscht wird.

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

ReplaceAllTextRequest

Ersetzt alle Instanzen von Text, der einem Kriterium entspricht, 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 abgeglichenen Text ersetzt.

pageObjectIds[]

string

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

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

Union-Feld criteria. Die Kriterien, die zum Abgleichen des zu ersetzenden Texts verwendet werden. Für criteria ist nur einer der folgenden Werte zulässig:
containsText

object (SubstringMatchCriteria)

Sucht nach Text in einer Form, 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 bei der Suche die Groß-/Kleinschreibung 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. „True“, 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 den Abgleich behandelt.

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 zu löschenden Seite oder des zu löschenden Seitenelements.

Wenn group nach einem Löschvorgang nur ein oder kein Seitenelement enthält, wird die Gruppe ebenfalls gelöscht.

Wenn ein Platzhalter in einem Layout gelöscht wird, werden auch alle leeren Platzhalter, die von diesem Layout abgeleitet werden, 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 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 Eingabe-Transformationsmatrix, die zum Aktualisieren des Seitenelements verwendet wird.

applyMode

enum (ApplyMode)

Der Anwendungsmodus des Transform-Updates.

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 von 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 und ohne Duplikate angegeben werden.

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 (jeweils einschließlich).

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

cellLocation

object (TableCellLocation)

Die optionale Position der Tabellenzelle, wenn der Text aus einer Tabellenzelle gelöscht werden soll. Falls vorhanden, muss sich die objectId auf eine Tabelle beziehen.

textRange

object (Range)

Der Bereich des zu löschenden Texts, basierend auf TextElement-Indexen.

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

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

Bereiche, die nur eine Codeeinheit eines Ersatzpaars enthalten, werden so erweitert, dass beide Codeeinheiten enthalten sind.

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 die Bereiche 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 Typen 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 Beginnt den Bereich bei startIndex und wird bis zum Ende der Sammlung fortgesetzt. endIndex darf nicht angegeben werden.
ALL Legt den Bereich auf die gesamte Länge der Sammlung fest. Sowohl startIndex als auch endIndex dürfen nicht 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 bereitgestellte 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

elementProperties

object (PageElementProperties)

Die Elementattribute 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 in Bezug auf die Größe 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 in der linken oberen Ecke der Seite platziert.

Union-Feld image_source. Die Art der Bildquelle. Für image_source ist nur einer der folgenden Werte zulässig:
url

string

Die Bild-URL.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird für die Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB 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 Feld Image.source_url bereitgestellt.

CreateVideoRequest

Erstellt ein Video.

HINWEIS: Zum Erstellen eines Videos aus 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 bereitgestellte 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

elementProperties

object (PageElementProperties)

Die Elementattribute für das Video.

Das Attribut PageElementProperties.size ist optional. Wenn Sie keine Größe angeben, wählt der Server eine Standardgröße aus.

Das Attribut PageElementProperties.transform ist optional. Die Transformation darf keine Scherkomponenten haben. Wenn Sie keine Transformation angeben, wird das Video in der linken oberen Ecke der Seite platziert.

source

enum (Source)

Die Videoquelle.

id

string

Die eindeutige Kennung der Videoquelle für dieses Video.

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

Für den Zugriff auf eine Google Drive-Videodatei müssen Sie möglicherweise den HTTP-Header für eine Teilmenge alter Dateien mit einem Ressourcenschlüssel versehen. Weitere Informationen finden Sie unter Über Ressourcen-Schlüssel auf über Links freigegebene Dateien zugreifen.

CreateSheetsChartRequest

Erstellt ein eingebettetes Google Sheets-Diagramm.

HINWEIS: Zum 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 bereitgestellte Objekt-ID.

Falls angegeben, muss die ID unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem Wortzeichen [a-zA-Z0-9_] beginnen, gefolgt von einer beliebigen Anzahl der folgenden Zeichen [a-zA-Z0-9_-:]. Die Länge der ID darf nicht weniger als 5 und nicht mehr als 50 Zeichen betragen. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementattribute für das Diagramm.

Wenn das Seitenverhältnis der angegebenen Größe nicht mit dem Seitenverhältnis des Diagramms übereinstimmt, wird das Diagramm in Bezug auf die Größe skaliert und 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 für eine Teilmenge alter Dateien einen Ressourcenschlüssel zum HTTP-Header hinzufügen. Weitere Informationen finden Sie unter Über Ressourcen-Schlüssel auf über Links freigegebene Dateien zugreifen.

chartId

integer

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

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn nichts angegeben ist, ist das Diagramm ein Bild, das nicht verknüpft 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 Diagramm, das nicht verknüpft ist, wird als Bild eingefügt.
LINKED Wenn Sie das Diagramm verknüpfen, kann es aktualisiert werden und andere Mitbearbeiter sehen 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 bereitgestellte 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

elementProperties

object (PageElementProperties)

Die Elementattribute für die Linie.

lineCategory
(deprecated)

enum (Category)

Die Kategorie der zu erstellenden Zeile.

Verworfen : Verwenden Sie stattdessen category.

Die genaue line type wird basierend auf der Kategorie und der Weiterleitung zur Verbindung mit anderen Seitenelementen bestimmt.

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

category

enum (LineCategory)

Die Kategorie der zu erstellenden Zeile.

Die genaue line type wird basierend auf der Kategorie und der Weiterleitung zur Verbindung mit anderen Seitenelementen bestimmt.

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

Enums
STRAIGHT Gerade Verbinder, einschließlich des geraden Verbinders 1. Dies ist die Standardkategorie, wenn keine angegeben ist.
BENT Gebogene Anschlüsse, einschließlich der gebogenen Anschlüsse 2 bis 5.
CURVED Gekrümmte Verbindungselemente, einschließlich der gekrümmten Verbindungselemente 2 bis 5.

RefreshSheetsChartRequest

Aktualisiert ein eingebettetes Google-Tabellen-Diagramm, indem es durch die aktuelle Version des Diagramms aus Google Sheets ersetzt wird.

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

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

string

Die Objekt-ID des zu aktualisierenden Diagramms.

UpdateShapePropertiesRequest

Aktualisieren Sie die Attribute eines 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 Formattribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die einfarbige Füllfarbe 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 ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdateImagePropertiesRequest

Aktualisieren Sie die Attribute eines Image.

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

string

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

imageProperties

object (ImageProperties)

Die zu aktualisierenden Bildeigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die Farbe der Bildkontur 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 ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdateVideoPropertiesRequest

Aktualisieren Sie die Attribute eines Video.

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

string

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

videoProperties

object (VideoProperties)

Die zu aktualisierenden Video-Attribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die Farbe des Videorahmens 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 ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdatePagePropertiesRequest

Aktualisiert die Attribute einer Page.

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

string

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

pageProperties

object (PageProperties)

Die zu aktualisierenden Seiteneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die einfarbige Füllfarbe 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 ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdateTableCellPropertiesRequest

Aktualisieren Sie die Attribute eines 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 Aktualisierungen auf die gesamte Tabelle angewendet.

tableCellProperties

object (TableCellProperties)

Die zu aktualisierenden Tabellenzelleneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die einfarbige Füllfarbe des Tabellenzellenhintergrunds aktualisieren möchten, legen Sie fields auf "tableCellBackgroundFill.solidFill.color" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

TableRange

Ein Tabellenbereich ist ein Verweis auf eine Teilmenge einer Tabelle.

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

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

Ein Tabellenbereich mit „location“ = (0, 0), „row span“ = 3 und „column span“ = 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 Startort des Tabellenbereichs.

rowSpan

integer

Die Anzahl der Zeilen des Tabellenbereichs.

columnSpan

integer

Die Spaltenbreite des Tabellenbereichs.

UpdateLinePropertiesRequest

Aktualisiert die Attribute 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 Zeileneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die Farbe der durchgezogenen 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 ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

CreateParagraphBulletsRequest

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

Die Verschachtelungsebene jedes Absatzes wird durch Zählen der führenden Tabulatoren vor dem jeweiligen Absatz bestimmt. Um überflüssige Leerzeichen zwischen dem Aufzählungszeichen und dem entsprechenden Absatz zu vermeiden, werden diese führenden Tabulatoren durch diese Anfrage entfernt. Dadurch können sich die Indexe von Teilen des Texts ändern.

Wenn der Absatz unmittelbar vor den aktualisierten Absätzen in einer Liste mit einer passenden Voreinstellung steht, werden die aktualisierten 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, der Aufzählungszeichen hinzugefügt werden sollen.

cellLocation

object (TableCellLocation)

Der optionale Speicherort der Tabellenzelle, wenn sich der zu ändernde Text in einer Tabellenzelle befindet. Falls vorhanden, muss sich die objectId auf eine Tabelle beziehen.

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

Die Arten von Aufzählungszeichen, die verwendet werden sollen. Die Standardeinstellung ist die Voreinstellung BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Voreingestellte Muster für Aufzählungszeichen in Listen im Text.

In diesen Mustern werden die folgenden 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 leerer Kreis, der dem Unicode-Codepunkt U+25cb entspricht
  • DIAMOND : Ein ausgefülltes Rhombus-Symbol, das dem Unicode-Codepunkt U+25c6 entspricht
  • DIAMONDX : Eine Raute mit einem „x“, entsprechend dem Unicode-Codepunkt U+2756
  • HOLLOWDIAMOND : Eine leere Raute, die dem Unicode-Codepunkt U+25c7 entspricht
  • DISC : Ein ausgefüllter Kreis, der dem Unicode-Codepunkt U+25cf entspricht
  • SQUARE : Ein ausgefülltes 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 Zahlen mit einer Null beginnen, z. B. „01“, „02“ oder „03“. Zahlen mit mehr als einer Ziffer wird keine Null vorangestellt.
  • ROMAN : Eine römische Ziffer in Kleinbuchstaben, z. B. „i“, „ii“ oder „iii“.
  • UPPERROMAN : Eine römische Ziffer in Großbuchstaben, 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 Liste mit Aufzählungszeichen mit dem Aufzählungszeichen DISC, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Liste mit Aufzählungszeichen mit den Aufzählungszeichen DIAMONDX, ARROW3D und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_CHECKBOX Eine Aufzählungsliste mit CHECKBOX Aufzählungszeichen für alle Verschachtelungsebenen der Liste.
BULLET_ARROW_DIAMOND_DISC Eine Liste mit Aufzählungszeichen mit dem Aufzählungszeichen ARROW, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_STAR_CIRCLE_SQUARE Eine Liste mit Aufzählungszeichen mit dem Aufzählungszeichen STAR, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Liste mit Aufzählungszeichen mit dem Aufzählungszeichen ARROW3D, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Liste mit Aufzählungszeichen mit dem Aufzählungszeichen LEFTTRIANGLE, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Liste mit Aufzählungszeichen mit dem Aufzählungszeichen DIAMONDX, HOLLOWDIAMOND und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Liste mit Aufzählungszeichen mit den Aufzählungszeichen DIAMOND, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
NUMBERED_DIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen DIGIT, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Eine nummerierte Liste mit DIGIT, ALPHA und ROMAN numerischen Glyphen für die ersten drei Verschachtelungsebenen der Liste, gefolgt von einer schließenden Klammer.
NUMBERED_DIGIT_NESTED Eine nummerierte Liste mit DIGIT numerischen Glyphen, die durch Punkte getrennt sind. Bei jeder Verschachtelungsebene wird die Glyphe der vorherigen Verschachtelungsebene als Präfix verwendet. Beispiel: „1.“ '1.1.', '2.', '2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen UPPERALPHA, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Eine nummerierte Liste mit den numerischen Glyphen UPPERROMAN, UPPERALPHA und DIGIT für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen ZERODIGIT, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, 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 Methode „replace“.

Verworfen : Verwenden Sie stattdessen imageReplaceMethod.

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

imageReplaceMethod

enum (ImageReplaceMethod)

Die Methode zum Ersetzen von Bildern.

Wenn Sie sowohl ein replaceMethod als auch ein imageReplaceMethod angeben, hat das 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 der Wert nicht leer ist, werden die Übereinstimmungen auf Seitenelemente auf den angegebenen Seiten beschränkt.

Gibt einen 400-Fehler zurück, wenn die Seitenobjekt-ID eines notes page oder eines 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, damit sie ersetzt werden. Für criteria ist nur einer der folgenden Werte zulässig:
containsText

object (SubstringMatchCriteria)

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

Union-Feld image_source. Die Art der Bildquelle. Für image_source ist nur einer der folgenden Werte zulässig:
imageUrl

string

Die Bild-URL.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird für die Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB sein, dürfen nicht mehr als 25 Megapixel haben 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 bereitgestellt.

ReplaceMethod

Die Methode „replace“.

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

ImageReplaceMethod

Die Methode zum Ersetzen von Bildern.

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 Begrenzungen der ursprünglichen Form passt. Das Seitenverhältnis des Bilds wird beibehalten. Die gerenderte Größe des Bildes kann kleiner sein als die Größe der Form. Dies ist die Standardmethode, wenn keine angegeben ist.
CENTER_CROP Das Bild wird skaliert und zentriert, um die Grenzen der ursprünglichen Form auszufü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 eingefügt. Wenn Sie ein Seitenelement duplizieren, wird das Duplikat auf derselben Seite an derselben Position wie das Original 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. Diese Zuordnung definiert, wie die IDs von duplizierten Objekten generiert werden: Die Schlüssel sind die IDs der Originalobjekte 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 (entspricht dem regulären Ausdruck [a-zA-Z0-9_]). Die verbleibenden Zeichen dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der neuen ID darf nicht weniger als 5 oder mehr als 50 Zeichen betragen.

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

UpdateTextStyleRequest

Aktualisieren Sie das Formatieren von Text in einem 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 objectId auf eine Tabelle verweist, muss cellLocation einen Wert haben. Andernfalls darf sie nicht verwendet werden.

style

object (TextStyle)

Die Formatierung(en), die für den Text festgelegt werden sollen.

Wenn der Wert für ein bestimmtes Design mit dem des übergeordneten Elements übereinstimmt, wird das Design auf „inherit“ (erben) festgelegt.

Bestimmte Änderungen am Textstil können andere Änderungen zur Folge haben, die das Verhalten des Google Präsentationen-Editors widerspiegeln sollen. Weitere Informationen finden Sie in der Dokumentation zu TextStyle.

textRange

object (Range)

Der Bereich des zu formatierenden Texts.

Der Bereich kann auf angrenzende Zeilenumbrüche ausgeweitet werden.

Wenn der Bereich einen Absatz einer Liste vollständig enthält, wird auch das Aufzählungszeichen 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 Kurzform für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise den Textstil auf „fett“ aktualisieren möchten, legen Sie fields auf "bold" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

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 Begrenzungen der ursprünglichen Form passt.

HINWEIS: Wenn Sie Formen durch ein Diagramm ersetzen möchten, benötigen Sie mindestens einen der folgenden OAuth-Bereiche: spreadsheets.readonly, spreadsheets, drive.readonly oder drive.

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, damit sie ersetzt werden. Durch die Anfrage werden alle Formen ersetzt, die den angegebenen Text enthalten.

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn nichts angegeben ist, ist das Diagramm ein Bild, das nicht verknüpft ist.

pageObjectIds[]

string

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

Gibt einen 400-Fehler zurück, wenn die Seitenobjekt-ID eines notes page oder eines 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 Diagramm, das nicht verknüpft ist, wird als Bild eingefügt.
LINKED Wenn Sie das Diagramm verknüpfen, kann es aktualisiert werden und andere Mitbearbeiter sehen einen Link zur Tabelle.

DeleteParagraphBulletsRequest

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

Die Verschachtelungsebene jedes Absatzes wird visuell beibehalten, indem am Anfang des entsprechenden Absatzes ein Einzug hinzugefügt wird.

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

string

Die Objekt-ID der Form oder Tabelle, aus der die Aufzählungszeichen des zu löschenden Texts entfernt werden sollen.

cellLocation

object (TableCellLocation)

Der optionale Speicherort der Tabellenzelle, wenn sich der zu ändernde Text in einer Tabellenzelle befindet. Falls vorhanden, muss sich die objectId auf eine Tabelle beziehen.

textRange

object (Range)

Der Textbereich, aus dem die Aufzählungszeichen entfernt werden sollen, basierend auf TextElement-Indexen.

UpdateParagraphStyleRequest

Aktualisiert das Styling für alle Absätze innerhalb eines 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 objectId auf eine Tabelle verweist, muss cellLocation einen Wert haben. Andernfalls darf sie nicht verwendet werden.

style

object (ParagraphStyle)

Der Stil des Absatzes.

textRange

object (Range)

Der Textbereich, der die zu formatierenden Absätze enthält.

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 Kurzform für die Auflistung aller Felder verwendet werden.

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

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdateTableBorderPropertiesRequest

Aktualisiert die Eigenschaften der Tabellenränder 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 Aktualisierungen auf die gesamte Tabelle angewendet.

borderPosition

enum (BorderPosition)

Die Position der Begrenzung im Tabellenbereich, auf den sich die Aktualisierungen beziehen sollen. Wenn keine Position für den Rahmen angegeben ist, werden die Änderungen auf alle Rahmen im Tabellenbereich angewendet.

tableBorderProperties

object (TableBorderProperties)

Die zu aktualisierenden Tabellenrandattribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

BorderPosition

Die Position des Tabellenrahmens.

Enums
ALL Alle Rahmenlinien im Bereich.
BOTTOM Grenzen am unteren Ende des Bereichs.
INNER Rahmenlinien innerhalb des Bereichs.
INNER_HORIZONTAL Horizontale Rahmenlinien innerhalb des Bereichs.
INNER_VERTICAL Vertikale Rahmenlinien auf der Innenseite des Bereichs.
LEFT Rahmenlinien links vom Bereich.
OUTER Rahmenlinien entlang der Außenseite des Bereichs.
RIGHT Rahmenlinien rechts vom Bereich.
TOP Grenzen am oberen Ende des Bereichs.

UpdateTableColumnPropertiesRequest

Aktualisiert die Attribute 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 Indexe, die angeben, welche Spalten aktualisiert werden sollen. Wenn keine Indexe angegeben sind, 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 Bad Request“ 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 Kurzform für die Auflistung aller Felder verwendet werden.

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

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

UpdateTableRowPropertiesRequest

Aktualisiert die Attribute 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 Indexe, die angeben, welche Zeilen aktualisiert werden sollen. Wenn keine Indexe angegeben sind, werden alle Zeilen in der Tabelle aktualisiert.

tableRowProperties

object (TableRowProperties)

Die zu aktualisierenden Eigenschaften der Tabellenzeile.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

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

MergeTableCellsRequest

Führt Zellen in einem Table zusammen.

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 verkettet und in der Zelle oben links („Kopf“) 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 sind), wird ein 400-Fehler (Ungültige Anfrage) zurückgegeben.

UnmergeTableCellsRequest

Hebt den Zellenverbund in einem 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 zusammengeführt werden sollen.

Alle zusammengeführten Zellen in diesem Bereich werden wieder getrennt. Zellen, die bereits getrennt sind, sind davon nicht betroffen. Wenn der Bereich keine zusammengeführten Zellen enthält, wird durch die Anfrage nichts bewirkt. Wenn in einer der verbundenen Zellen Text vorhanden ist, bleibt dieser in der Zelle oben links („Kopfzelle“) des resultierenden Blocks mit nicht verbundenen Zellen erhalten.

GroupObjectsRequest

Gruppiert Objekte, um eine Objektgruppe zu erstellen. Beispiel: Mit Gruppen PageElements wird ein Group auf derselben Seite wie alle untergeordneten Elemente erstellt.

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 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 verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID muss mindestens 5 und darf höchstens 50 Zeichen betragen.

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

childrenObjectIds[]

string

Die Objekt-IDs der zu gruppierenden Objekte.

Es können nur Seitenelemente gruppiert werden. Auf derselben Seite müssen mindestens zwei Seitenelemente vorhanden sein, die noch nicht in einer anderen Gruppe enthalten sind. Einige Seitenelemente, z. B. videos, tables und placeholders, können nicht gruppiert werden.

UngroupObjectsRequest

Hebt 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 gruppiert 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 Alternativtexts 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 Alt-Text-Titel des Seitenelements. Wenn der Wert nicht festgelegt ist, wird der vorhandene Wert beibehalten. Der Titel wird Screenreadern und anderen Bedienungshilfen zur Verfügung gestellt. Verwenden Sie nur für Menschen 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, wird der vorhandene Wert beibehalten. Die Beschreibung wird Screenreadern und anderen Bedienungshilfen zur Verfügung gestellt. Verwenden Sie nur für Menschen lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

ReplaceImageRequest

Ersetzt ein vorhandenes Bild durch ein neues Bild.

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. Für image_source ist nur einer der folgenden Werte zulässig:
url

string

Die Bild-URL.

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

Die angegebene URL darf nicht länger als 2 KB sein. Die URL wird mit dem Bild gespeichert und über das Feld Image.source_url bereitgestellt.

UpdateSlidePropertiesRequest

Aktualisiert die Attribute einer Folie.

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

string

Die Objekt-ID der Folie, auf die sich die Aktualisierung bezieht.

slideProperties

object (SlideProperties)

Die zu aktualisierenden Folienattribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Die Stamm-„slideProperties“ ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise aktualisieren möchten, ob eine Folie übersprungen wird, legen Sie fields auf "isSkipped" fest.

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie ihren Feldnamen in der Feldmaske an, lassen Sie das Feld selbst jedoch nicht festgelegt.

UpdatePageElementsZOrderRequest

Aktualisiert die Z-Reihenfolge von Seitenelementen. Die Z-Reihenfolge ist eine Anordnung der Elemente auf der Seite von hinten nach vorn. Das Seitenelement im Vordergrund 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)

Der Z-Order-Vorgang, der auf die Seitenelemente angewendet werden soll.

Wenn die Operation auf mehrere Seitenelemente angewendet wird, bleiben die relativen Z-Ordnungen innerhalb dieser Seitenelemente vor der Operation 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 gerückt.
BRING_FORWARD Bringt die Seitenelemente auf der Seite um ein Element nach vorn, relativ zum vordersten Element in den angegebenen Seitenelementen.
SEND_BACKWARD Verschiebt die Seitenelemente auf der Seite um ein Element nach hinten, relativ zum am weitesten hinten liegenden Element in den angegebenen Seitenelementen.
SEND_TO_BACK Sendet die Seitenelemente in den Hintergrund der Seite.

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 Zeile mit einem category, die angibt, dass es sich um einen „Connector“ handelt, kann aktualisiert werden.

Die Linie wird möglicherweise neu geroutet, nachdem ihre Kategorie aktualisiert wurde.

lineCategory

enum (LineCategory)

Die Zeilenkategorie, auf die aktualisiert werden soll.

Die genaue line type wird anhand der Kategorie bestimmt, auf die aktualisiert werden soll, und der Art und Weise, wie sie mit anderen Seitenelementen verbunden ist.

RerouteLineRequest

Leitet eine line so um, dass sie an den beiden nächstgelegenen Verbindungspunkten der verbundenen Seitenelemente angeschlossen wird.

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

string

Die Objekt-ID der umzuleitenden Linie.

Nur eine Linie mit einem category, die darauf hinweist, dass es sich um einen „Connector“ handelt, kann umgeleitet werden. Die Start- und Endverbindungen der Linie müssen sich auf unterschiedlichen Seitenelementen befinden.