Requests

Anfrage

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

JSON-Darstellung 
{

  "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)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
Felder
Die Art des Updates. Genau ein Feld ist erforderlich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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 Vorkommen des angegebenen Texts.

deleteObject

object (DeleteObjectRequest)

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

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aktualisiert die Transformation eines Seitenelements.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

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

deleteText

object (DeleteTextRequest)

Löscht Text aus einer Form oder einer Tabellenzelle.

createImage

object (CreateImageRequest)

Erstellt ein Bild.

createVideo

object (CreateVideoRequest)

Erstellt ein Video.

createSheetsChart

object (CreateSheetsChartRequest)

Erstellt ein eingebettetes Google-Tabellen-Diagramm.

createLine

object (CreateLineRequest)

Erstellt eine Linie.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aktualisiert ein Google Sheets-Diagramm.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualisiert die Attribute einer Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualisiert die Eigenschaften einer Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualisiert die Attribute einer Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualisiert die Attribute einer Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualisiert die Attribute einer TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

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

Dupliziert ein Folien- oder Seitenelement.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert die Formatierung 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 in einem Shape- oder Table-Element.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualisiert die Eigenschaften der Tabellenränder in einem Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Eigenschaften einer Spalte vom Typ Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aktualisiert die Eigenschaften einer Table-Zeile.

mergeTableCells

object (MergeTableCellsRequest)

Führt Zellen in einem Table zusammen.

unmergeTableCells

object (UnmergeTableCellsRequest)

Hebt den Zellenverbund in einem 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 Alt-Text-Titel und/oder die Beschreibung eines page element.

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Bild durch ein neues Bild.

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

insertComment

object (InsertCommentRequest)

Fügt ein CommentThread in die Präsentation ein.

addCommentReply

object (AddCommentReplyRequest)

Fügt eine Antwort auf eine CommentThread hinzu.

updateCommentPost

object (UpdateCommentPostRequest)

Aktualisiert einen vorhandenen Beitrag (Hauptbeitrag oder Antwort) einer CommentThread.

deleteComment

object (DeleteCommentRequest)

Löscht eine CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Löscht eine Antwort Post aus einer CommentThread.

Ende der sich gegenseitig ausschließenden Felder.

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 können 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 Master des Index der vorherigen Folie.
  • Das Master der ersten Folie, wenn der 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 ein 400-Fehler (Ungültige Anfrage) zurückgegeben.

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Eine optionale Liste von Objekt-ID-Zuweisungen aus 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. Das kann sich auf Folgendes beziehen:

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

  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
}
Felder
Die Art der LayoutReference. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
predefinedLayout

enum (PredefinedLayout)

Vordefiniertes Layout

layoutId

string

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

Ende der sich gegenseitig ausschließenden Felder.

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 einzigen Spalte angeordnet sind.
MAIN_POINT Layout mit einem Hauptpunkt.
BIG_NUMBER Layout mit einer Überschrift mit einer großen Zahl.

LayoutPlaceholderIdMapping

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

JSON-Darstellung 
{
  "objectId": string,

  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
}
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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 50 Zeichen betragen.

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

Die Art, mit der ein Platzhalter in einem Layout identifiziert wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
layoutPlaceholder

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

Ende der sich gegenseitig ausschließenden Felder.

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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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 einen PageElement erstellen, kann die API die Werte von size und transform ändern, aber die visuelle Größe bleibt 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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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 wird, wird die Tabelle automatisch angepasst.

Tabellentransformationen müssen einen Skalierungsfaktor 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 dieser Stelle 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 Graphem-Cluster 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 unter 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 Bezugszelle befindet. Wenn die Bezugszelle 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 Textinstanzen, die einem Kriterium entsprechen, durch replace text.

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
Felder
replaceText

string

Der Text, der den übereinstimmenden 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 vom Typ „Ungültige Anfrage“ zurück, wenn die Seitenobjekt-ID eines notes master angegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht vorhanden ist.

Die Kriterien, die zum Abgleichen des zu ersetzenden Texts verwendet werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
containsText

object (SubstringMatchCriteria)

Sucht in einer Form nach Text, der mit diesem Teilstring übereinstimmt.

Ende der sich gegenseitig ausschließenden Felder.

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 die Groß-/Kleinschreibung berücksichtigt.
  • False : Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.
searchByRegex

boolean

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

  • True : Der Suchtext wird als regulärer Ausdruck behandelt.
  • False : Der Suchtext wird als Teilstring für 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 Seite oder des Seitenelements, das gelöscht werden soll.

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 übergeordneten 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 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 Transformationsupdates.

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 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 (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 zu löschende Textbereich, basierend auf TextElement Indexen.

Am Ende des Texts einer Form oder Tabellenzelle steht 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“ gefolgt von einem impliziten Zeilenumbruch ist, 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 Erfassung fortgesetzt. Die 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)
  },

  "url": 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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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 in Bezug auf die Größe skaliert und zentriert, um das Seitenverhältnis beizubehalten. Die angegebene Transformation wird nach diesem Vorgang angewendet.

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

Das Attribut PageElementProperties.transform ist optional. Wenn Sie keine Transformation angeben, wird das Bild in der linken oberen Ecke der Seite platziert.

Die Art der Bildquelle. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

CreateVideoRequest

Erstellt ein Video.

HINWEIS: Wenn Sie ein Video aus Google Drive erstellen möchten, 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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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, 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 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: Für das YouTube-Video 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 einem HTTP-Header für eine Teilmenge alter Dateien einen Ressourcenschlüssel hinzufügen. Weitere Informationen finden Sie unter Über Ressourcen-Schlüssel auf über Links freigegebene Dateien zugreifen.

CreateSheetsChartRequest

Erstellt ein eingebettetes Google-Tabellen-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 sollte 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 sollte mindestens 5 und maximal 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 dem Seitenverhältnis des Diagramms entspricht, 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 dem HTTP-Header für eine Teilmenge alter Dateien einen Ressourcenschlüssel 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 ohne Link.

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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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.

Veraltet : Verwenden Sie stattdessen category.

Die genaue line type, die erstellt wird, hängt von der Kategorie und der Weiterleitung ab, um eine Verbindung zu anderen Seitenelementen herzustellen.

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

category

enum (LineCategory)

Die Kategorie der zu erstellenden Zeile.

Die genaue line type, die erstellt wird, hängt von der Kategorie und der Weiterleitung ab, um eine Verbindung zu anderen Seitenelementen herzustellen.

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 Verbindungen, einschließlich gekrümmter Verbindung 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 Formattribute, die aktualisiert werden sollen.

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 Farbe der Volltonfüllung des Formhintergrunds aktualisieren möchten, legen Sie fields auf "shapeBackgroundFill.solidFill.color" fest.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 sich die Aktualisierungen beziehen.

videoProperties

object (VideoProperties)

Die zu aktualisierenden Videoeigenschaften.

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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 sich das Update bezieht.

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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt.

TableRange

Ein Tabellenbereich ist ein Verweis auf eine Teilmenge einer Tabelle.

Die durch einen Tabellenbereich angegebenen Zellen müssen nicht unbedingt ein Rechteck bilden. Angenommen, 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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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)

Die optionale Position 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.

Für diese Muster 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 : Eine ausgefüllte Raute, die 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, z. B. „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 Dreieck, das nach links zeigt und dem Unicode-Codepunkt U+25c4 entspricht
Enums
BULLET_DISC_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DISC, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Aufzählungsliste 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 Aufzählungsliste mit den Aufzählungszeichen ARROW, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_STAR_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen STAR, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen ARROW3D, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit den Aufzählungszeichen LEFTTRIANGLE, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMONDX, HOLLOWDIAMOND und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Aufzählungsliste 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 den numerischen Glyphen DIGIT, ALPHA und ROMAN 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. Jede Verschachtelungsebene verwendet die Glyphe der vorherigen Verschachtelungsebene als Präfix. 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
  ],

  "containsText": {
    object (SubstringMatchCriteria)
  }

  "imageUrl": string
}
Felder
replaceMethod
(deprecated)

enum (ReplaceMethod)

Die Methode „replace“.

Veraltet : Verwenden Sie stattdessen imageReplaceMethod.

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

imageReplaceMethod

enum (ImageReplaceMethod)

Die Methode zum Ersetzen von Bildern.

Wenn Sie sowohl eine replaceMethod als auch eine imageReplaceMethod angeben, hat die 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 („Bad Request“) zurück, wenn die Seitenobjekt-ID eines notes page oder eines notes master angegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht vorhanden ist.

Die Kriterien, die die Formen erfüllen müssen, damit sie ersetzt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
containsText

object (SubstringMatchCriteria)

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

Ende der sich gegenseitig ausschließenden Felder.
Die Art der Bildquelle. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

ReplaceMethod

Die Methode „replace“.

Enums
CENTER_INSIDE Das Bild wird skaliert und zentriert, damit es in die Grenzen der ursprünglichen Form passt. Das Seitenverhältnis des Bildes wird beibehalten. Die gerenderte Größe des Bildes kann kleiner als die Größe der Form sein. 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, damit es die Form ausfüllt. 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 Die Methode zum Ersetzen von Bildern wurde nicht angegeben. 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 wird beibehalten. Die gerenderte Größe des Bildes kann kleiner als die Größe der Form sein. 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, damit es die Form ausfüllt. 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. In dieser Map wird 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 Zufallskennung zugewiesen. Wenn die Karte leer oder nicht festgelegt ist, erhalten alle doppelten Objekte eine neue Zufallskennung.

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 es nicht verwendet werden.

style

object (TextStyle)

Die Formatierung(en), die auf den Text angewendet werden sollen.

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Elements übereinstimmt, wird der Stil auf „inherit“ (erben) gesetzt.

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 erweitert werden, um angrenzende Zeilenumbrüche einzuschließen.

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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 Grenzen 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. Bei der 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 ohne Link.

pageObjectIds[]

string

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

Gibt einen 400-Fehler („Bad Request“) zurück, wenn die Seitenobjekt-ID eines notes page oder eines notes master angegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht 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)

Die optionale Position 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 in einem 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 es 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 ändern möchten, legen Sie fields auf "alignment" fest.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 Grenze im Tabellenbereich, auf die 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 Volltonfarbe des Tabellenrahmens aktualisieren möchten, legen Sie fields auf "tableBorderFill.solidFill.color" fest.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt.

BorderPosition

Die Position des Tabellenrahmens.

Enums
ALL Alle Grenzen im Bereich.
BOTTOM Grenzen am unteren Ende des Bereichs.
INNER Rahmenlinien auf der Innenseite 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 Grenzwerte am oberen Ende des Bereichs.

UpdateTableColumnPropertiesRequest

Aktualisiert die Eigenschaften einer Spalte vom Typ Table.

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

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 Eigenschaft aber nicht festgelegt wird,wird für die Spaltenbreite standardmäßig 406.400 EMU (32 Punkte) verwendet.

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

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 getrennt 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 zusammengeführten Zellen Text vorhanden ist, bleibt dieser in der Zelle links oben („Kopfzelle“) des resultierenden Blocks mit nicht zusammengeführten 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 dürfen diese sowie einen Bindestrich oder Doppelpunkt enthalten (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]). Die Länge der ID darf nicht weniger als 5 oder mehr als 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. Es müssen mindestens zwei Seitenelemente auf derselben Seite vorhanden sein, die noch nicht in einer anderen Gruppe enthalten sind. Einige Seitenelemente wie 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, die gruppiert werden sollen.

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 Alt-Text-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 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),

  "url": string
}
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.

Die Art der Bildquelle. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

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 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 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 ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber 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 Verschiebt 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 Versetzt die Seitenelemente in den Hintergrund.

UpdateLineCategoryRequest

Aktualisiert die Kategorie eines line.

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

string

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

Nur eine Zeile mit einem category, das angibt, dass es sich um einen „Connector“ handelt, kann aktualisiert werden.

Die Linie wird möglicherweise neu verlegt, 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 Zeile.

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

InsertCommentRequest

Fügt ein CommentThread in die Präsentation ein.

JSON-Darstellung 
{
  "content": string,
  "assigneeEmailAddress": string,

  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
}
Felder
content

string

Der Text des Kommentars als Nur-Text.

Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Slides-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich.

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

assigneeEmailAddress

string

Optional. Die E‑Mail-Adresse des Nutzers, dem der Kommentar zugewiesen ist.

Lassen Sie das Feld leer, wenn der Kommentar nicht zugewiesen werden soll.

Darf nicht mehr als 2.048 UTF‑8-Codeeinheiten enthalten.

Die Stelle in der Präsentation, auf die sich der Kommentar bezieht. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
objectId

string

Die Objekt-ID des Page oder PageElement, das mit diesem Kommentar verknüpft ist. Wenn die angegebene „objectId“ ein Group ist, wird der Kommentar an maximal 100 Nachfolgern der Gruppe angehängt, die nicht zur Gruppe gehören.

shapeTextAnchor

object (ShapeTextAnchor)

Verankert einen Kommentar in einem bestimmten Textbereich innerhalb eines Shape.

tableCellTextAnchor

object (TableCellTextAnchor)

Verankert einen Kommentar an einem bestimmten Textbereich in einer einzelnen Zelle in einem Table.

tableAnchor

object (TableAnchor)

Verankert einen Kommentar in einem bestimmten Zellenbereich in einem Table. Gibt einen 400-Fehler (Falsche Anfrage) zurück, wenn keine Zellen im Bereich Text enthalten.

Ende der sich gegenseitig ausschließenden Felder.

ShapeTextAnchor

Ein Anker für einen bestimmten Textbereich innerhalb von Shape's text. Wenn Sie Kommentare in Vortragsnotizen einfügen möchten, verwenden Sie ShapeTextAnchor mit der Objekt-ID speaker notes.

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

string

Die Objekt-ID des Seitenelements, das den Text enthält.

textRange

object (Range)

Der Textbereich für den Anker.

TableCellTextAnchor

Ein Anker für einen bestimmten Textbereich in einem TableCell der TextElement.

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

string

Die Objekt-ID der Tabelle, die die Zelle enthält.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle.

textRange

object (Range)

Der Textbereich für den Anker.

TableAnchor

Ein Anker für einen bestimmten Zellenbereich in einem Table. Wird verwendet, um einen Kommentar an den gesamten Text in jeder Zelle eines Bereichs in einer Tabelle zu verankern.

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Zellenbereich in der Tabelle, auf den der Anker angewendet werden soll. Wenn diese Angabe fehlt, werden alle Zellen in der Tabelle als Anker verwendet.

AddCommentReplyRequest

Fügt eine Antwort Post in eine CommentThread ein.

JSON-Darstellung 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Felder
commentId

string

Die ID der CommentThread, der die Antwort hinzugefügt werden soll.

post

object (Post)

Die Post, die die Antwort darstellt.

UpdateCommentPostRequest

Aktualisiert ein Post in einem CommentThread.

Gibt einen 400-Fehler („Bad Request“) zurück, wenn:

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.
JSON-Darstellung 
{
  "commentId": string,
  "postId": string,
  "content": string
}
Felder
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

postId

string

Die ID des Beitrags, der aktualisiert wird.

content

string

Der neue Text des Kommentars im Nur-Text-Format.

Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Slides-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich.

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

DeleteCommentRequest

Löscht eine CommentThread.

Gibt einen 400-Fehler zurück, wenn der anfragende Nutzer nicht der Autor von headPost ist.

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

string

Die ID des CommentThread, der gelöscht wird.

DeleteCommentReplyRequest

Löscht eine Antwort Post aus einem CommentThread.

Gibt einen 400-Fehler („Bad Request“) zurück, wenn:

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.

  • Der Antwortbeitrag enthält ein comment action.

  • Der Antwortbeitrag enthält ein assignee.

JSON-Darstellung 
{
  "commentId": string,
  "postId": string
}
Felder
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

postId

string

Die ID der Antwort Post , die gelöscht wird.