Requests

Anfragen

Eine 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 der Aktualisierung. Genau ein Feld ist erforderlich. kind darf nur einer der folgenden Werte sein:
createSlide

object (CreateSlideRequest)

Hiermit wird eine neue Folie erstellt.

createShape

object (CreateShapeRequest)

Erstellt eine neue Form.

createTable

object (CreateTableRequest)

: Erstellt eine neue Tabelle.

insertText

object (InsertTextRequest)

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

insertTableRows

object (InsertTableRowsRequest)

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

deleteObject

object (DeleteObjectRequest)

Löscht ein Seiten- oder 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)

Ein eingebettetes Diagramm in Google Tabellen wird erstellt.

createLine

object (CreateLineRequest)

Erstellt eine Linie.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Ein Google Tabellen-Diagramm wird aktualisiert.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualisiert die Eigenschaften einer Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualisiert die Eigenschaften einer Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualisiert die Eigenschaften einer Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualisiert die Eigenschaften einer Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualisiert die Eigenschaften einer TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aktualisiert die Eigenschaften einer Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Erstellt Aufzählungspunkte für Absätze.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Ersetzt alle Formen, die bestimmte Kriterien erfüllen, durch ein Bild.

duplicateObject

object (DuplicateObjectRequest)

Duplizierte Folien oder Seitenelemente.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert den Stil des Texts in einem Shape oder einem Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Alle Formen, die bestimmten Kriterien entsprechen, werden durch ein Google Tabellen-Diagramm ersetzt.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Löscht Aufzählungspunkte aus Absätzen

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualisiert den Stil der Absätze innerhalb eines Shape- oder Table-Elements.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualisiert die Eigenschaften der Tabellenrahmen in einer 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 einer Table zusammen.

unmergeTableCells

object (UnmergeTableCellsRequest)

Verbindet Zellen in einer Table zusammen.

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 eines alternativen Texts für page element.

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Bild durch ein neues.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aktualisiert die Eigenschaften von Folien

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 Verbindungswebsites der verbundenen Seitenelemente verbunden ist.

Anfrage erstellenFolie

Hiermit wird eine Folie erstellt.

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 für alle Seiten und Seitenelemente 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 übrigen Zeichen können einschließlich eines Bindestrichs oder Doppelpunktes (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]) enthalten. Die ID-Länge muss zwischen 5 und 50 Zeichen lang sein.

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

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

Layoutreferenz der Folie, die eingefügt werden soll, basierend auf dem aktuellen Master, einer der folgenden Werte:

  • Der Master des vorherigen Folienindex.
  • Die Masterfolie der ersten Folie, wenn für „insertIndex“ der Wert „0“ verwendet wird.
  • Der erste Master in der Präsentation, wenn keine Folien vorhanden sind

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

Layoutreferenz

Folienlayoutreferenz Das kann auf Folgendes verweisen:

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

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

enum (PredefinedLayout)

Vordefiniertes Layout.

layoutId

string

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

Vordefiniertes Layout

Vordefinierte Layouttypen. Diese Layouts finden sich häufig in Präsentationen. Es gibt jedoch keine Garantie, dass diese Layouts im aktuellen Master vorhanden sind, da sie möglicherweise gelöscht wurden oder nicht Teil des verwendeten Designs waren. Außerdem wurden möglicherweise die Platzhalter für jedes Layout geändert.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Nicht angegebenes Layout
BLANK Leeres Layout ohne Platzhalter.
CAPTION_ONLY Layout mit einem Untertitel am unteren Rand.
TITLE Layout mit Titel und Untertitel.
TITLE_AND_BODY Layout mit Titel und Text
TITLE_AND_TWO_COLUMNS Layout mit Titel und zwei Spalten.
TITLE_ONLY Layout mit nur einem Titel
SECTION_HEADER Layout mit Abschnittstitel.
SECTION_TITLE_AND_DESCRIPTION Layout mit Titel und Untertitel auf der einen Seite und einer Beschreibung auf der anderen Seite.
ONE_COLUMN_TEXT Layout mit einem Titel und einem Textkörper, angeordnet in einer einzelnen Spalte.
MAIN_POINT Layout mit einem Hauptpunkt
BIG_NUMBER Layout mit großer Überschrift

LayoutPlaceholderIdMapping

Die benutzerdefinierte ID-Zuordnung für einen Platzhalter, der auf einer Folie mit 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 angegebene Objekt-ID für den oben angegebenen Platzhalter, die auf einer Folie erstellt werden soll.

Wenn Sie eine ID angeben, muss sie für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

Union-Feld kind. Die Art, einen Platzhalter in einem Layout zu identifizieren. kind darf nur einer der folgenden Werte sein:
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

FormForm-Anfrage erstellen

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 für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Eigenschaften des Elements für die Form.

shapeType

enum (Type)

Der Formtyp.

Seitenelementeigenschaften

Allgemeine Eigenschaften eines Seitenelements.

Hinweis: Wenn Sie am Anfang eine PageElement erstellen, kann die API die Werte von size und transform ändern, die visuelle Größe wird aber nicht geä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 für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

elementProperties

object (PageElementProperties)

Die Elementeigenschaften 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 skaliert.

Tabellentransformationen müssen eine Skala von 1 und keine Scherkomponenten haben. Wenn keine Transformation bereitgestellt wird, wird die Tabelle auf der Seite zentriert.

rows

integer

Anzahl der Zeilen in der Tabelle.

columns

integer

Anzahl der Spalten in der Tabelle.

Textanfrage einfügen

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

cellLocation

object (TableCellLocation)

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

text

string

Der Text, der eingefügt werden soll

Wenn Sie ein Zeilenumbruchzeichen einfügen, wird implizit ein neuer ParagraphMarker an diesem Index erstellt. Der Absatzstil des neuen Absatzes wird aus dem Absatz im aktuellen Einfügungsindex kopiert, einschließlich Listen und Aufzählungszeichen.

Textstile für eingefügten Text werden automatisch ermittelt. Der Stil des benachbarten Textes wird in der Regel beibehalten. In den meisten Fällen wird der Text dem TextRun hinzugefügt, der im Suchindex vorhanden ist.

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

insertionIndex

integer

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

Der Index ist nullbasiert und wird vom Anfang des Strings aus berechnet. Der Index kann angepasst werden, um das Einfügen von Unicode-Grapheme-Clustern 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 Zelle der Referenztabelle, aus der die Zeilen eingefügt werden.

Es wird eine neue Zeile oberhalb oder unterhalb der Zeile eingefügt, in der sich die Referenzzelle befindet. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird eine neue Zeile oberhalb oder unterhalb der verbundenen Zelle eingefügt.

insertBelow

boolean

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

  • True : Fügen Sie sie unter die Zelle ein.
  • False : Fügen Sie ihn über die Zelle ein.
number

integer

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

RequestTableColumnRequest

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.

cellLocation

object (TableCellLocation)

Die Zelle der Referenztabelle, aus der Spalten eingefügt werden.

Links oder rechts neben der Spalte, in der sich die Referenzzelle befindet, wird eine neue Spalte eingefügt.

insertRight

boolean

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

  • True : Fügen Sie rechts davon ein.
  • False : Auf der linken Seite einfügen.
number

integer

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

Tabellenzeilenanforderung löschen

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)

Der Speicherort der Referenztabellenzelle, aus der eine Zeile gelöscht wird.

Die Zeile, die diese Zelle enthält, 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 verbleiben, wird die gesamte Tabelle gelöscht.

Tabellenspaltenanforderung löschen

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)

Der Speicherort der Referenztabellenzelle, aus der eine Spalte gelöscht wird.

Die Spalte, die diese Zelle enthält, 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 verbleiben, wird die gesamte Tabelle gelöscht.

AlleTextanfrage ersetzen

Ersetzt alle Instanzen eines Texts, die einem Kriterium entsprechen, durch replace text.

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

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

string

Der Text, der den übereinstimmenden Text ersetzt

pageObjectIds[]

string

Ist das Feld nicht leer, werden die Treffer auf die Seitenelemente auf den jeweiligen Seiten beschränkt.

Gibt den Fehler 400 zurück, wenn die Seitenobjekt-ID einer notes master zurückgegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht vorhanden ist.

Union-Feld criteria. Die Kriterien, die zum Abgleich von Text verwendet werden, der ersetzt werden soll. criteria darf nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

Hiermit wird Text in einer Form gefunden, die mit diesem Teilstring übereinstimmt.

TeilstringÜbereinstimmungen

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

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

string

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

matchCase

boolean

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

  • True : Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.
  • False : Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Anfrage zum Löschen von Objekten

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

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

string

Die Objekt-ID des zu löschenden Seiten- oder Seitenelements.

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

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

UpdatePageElementTransformRequest

Aktualisiert die Transformation eines Seitenelements.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich auch die absolute Transformation der Seitenelemente in dieser Gruppe, was ihre visuelle Darstellung verändern 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 Matrix für die Eingabetransformation, die zum Aktualisieren des Seitenelements verwendet wird.

applyMode

enum (ApplyMode)

Der "Apply"-Modus des Transformationsupdates.

Modus „Anwenden“

Die Aktualisierungsmodi der Transformationsaktualisierung.

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

AnfrageFolienPositionsanforderung aktualisieren

Die Position der Folien in der Präsentation wird aktualisiert.

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 vorhandener Präsentationsreihenfolge ohne Duplikate sein.

insertionIndex

integer

Der Index, in den die Folien eingefügt werden sollen, vor dem Verschieben. Muss zwischen null und der Anzahl der Folien in der Präsentation liegen, einschließlich

Textanfrage löschen

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)

Der optionale Speicherort der Tabellenzelle, wenn der Text aus einer Tabellenzelle gelöscht werden soll. Falls vorhanden, muss die „objectId“ auf eine Tabelle verweisen.

textRange

object (Range)

Der Textbereich, der auf TextElement-Indexen gelöscht werden soll.

Am Ende des Texts einer Form oder Tabellenzelle steht immer ein impliziter Zeilenumbruch, der nicht gelöscht werden kann. Range.Type.ALL verwendet die korrekten Grenzen, aber wenn Sie explizite Grenzen für die Bereichstypen FROM_START_INDEX und FIXED_RANGE angeben, müssen Sie vorsichtig sein. Wenn der Text beispielsweise „ABC“ gefolgt von einer impliziten neuen Zeile ist, ist der Höchstwert 2 für textRange.start_index und 3 für textRange.end_index.

Beim Löschen von Text, der eine Absatzgrenze überschreitet, können sich Absatzstile und Listen ändern, wenn die beiden Absätze zusammengeführt werden.

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

Bereich

Gibt einen zusammenhängenden Bereich einer indexierten Sammlung an, zum Beispiel Zeichen in Text.

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

integer

Der optionale nullbasierte Index vom Anfang der Sammlung. Erforderlich für die Bereiche FIXED_RANGE und FROM_START_INDEX.

endIndex

integer

Der optionale nullbasierte Index am Ende der Sammlung. Erforderlich für FIXED_RANGE-Bereiche.

type

enum (Type)

Der Typ des Bereichs.

Typ

Die Arten von Bereichen.

Enums
RANGE_TYPE_UNSPECIFIED Unbekannter Bereichstyp. Dieser Wert darf nicht verwendet werden.
FIXED_RANGE Fester Bereich Sowohl startIndex als auch endIndex müssen angegeben werden.
FROM_START_INDEX Startet 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.

Bildanfrage erstellen

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 für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Bild.

Wenn das Seitenverhältnis der bereitgestellten Größe nicht mit dem Seitenverhältnis des Bilds übereinstimmt, wird das Bild in Bezug auf die Größe skaliert und zentriert, damit das Seitenverhältnis beibehalten wird. Die angegebene Transformation wird nach diesem Vorgang angewendet.

Die Property PageElementProperties.size ist optional. Wenn Sie keine Größe angeben, wird die Standardgröße des Bilds verwendet.

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

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einer der folgenden Werte sein:
url

string

Bild-URL

Das Bild wird beim Einfügen abgerufen und eine Kopie für die Darstellung in der Präsentation gespeichert. Bilder müssen kleiner als 50 MB sein, 25 Megapixel nicht überschreiten und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

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

Videoanfrage erstellen

Erstellt ein Video.

HINWEIS: Um ein Video in Google Drive zu erstellen, muss die anfragende App mindestens einen OAuth-Bereich von „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 für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

elementProperties

object (PageElementProperties)

Die Eigenschaften des Elements für das Video.

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

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

source

enum (Source)

Die Videoquelle.

id

string

Die eindeutige Kennung der Videoquelle für dieses Video.

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

Für den Zugriff auf eine Google Drive-Videodatei müssen Sie möglicherweise im HTTP-Header einen Ressourcenschlüssel für einen Teil der alten Dateien hinzufügen. Weitere Informationen finden Sie unter Mit Ressourcenschlüsseln auf freigegebene Dateien zugreifen.

TabellenDiagramme erstellen

Ein eingebettetes Diagramm in Google Tabellen wird erstellt.

HINWEIS: Für die Erstellung des Diagramms ist mindestens ein OAuth-Bereich für Tabellen erforderlich.

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

Wenn angegeben, muss die ID unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem Wort [a–zA–Z0–9_] beginnen, gefolgt von einer beliebigen Anzahl der folgenden Zeichen [a–zA–Z0–9_–:]. Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Diagramm.

Wenn das Seitenverhältnis der bereitgestellten 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 einem HTTP-Header einen Ressourcenschlüssel für einen Teil der alten Dateien hinzufügen. Weitere Informationen finden Sie unter Mit Ressourcenschlüsseln auf freigegebene Dateien zugreifen.

chartId

integer

Die ID des Diagramms aus der Google Tabellen-Tabelle.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn Sie nichts angeben, wird das Diagramm als nicht verknüpftes Diagramm verwendet.

Verknüpfungsmodus

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. Andere Mitbearbeiter sehen den Link zur Tabelle.

Anträge erstellen

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 für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Linie.

lineCategory
(deprecated)

enum (Category)

Die Kategorie der zu erstellenden Linie.

Verworfen : Verwenden Sie stattdessen category.

Der genaue Umfang von line type wird anhand der Kategorie und der Art der Weiterleitung zu anderen Seitenelementen bestimmt.

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

category

enum (LineCategory)

Die Kategorie der zu erstellenden Linie.

Der genaue Umfang von line type wird anhand der Kategorie und der Art der Weiterleitung zu anderen Seitenelementen bestimmt.

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

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

Wenn Sie keine von beiden angeben, wird STRAIGHT verwendet.

Kategorie

Die Linienkategorien.

Enums
STRAIGHT Gerade Anschlüsse, einschließlich gerader Verbindung 1. Die ist die Standardkategorie, wenn keine angegeben ist.
BENT Gebogene Stecker, einschließlich gebogener Stecker 2 bis 5.
CURVED Gekrümmte Anschlüsse, einschließlich der gekrümmten Anschlüsse 2 bis 5.

Anfrage bezüglich Diagrammaktualisierung

Aktualisiert ein eingebettetes Diagramm in Google Tabellen und ersetzt es durch die neueste Version aus Google Tabellen.

HINWEIS: Zum Aktualisieren von Diagrammen ist mindestens einer der Tabellenbereiche „table.readonly“, „ Sheets“, „drive.readonly“ oder „Drive“ erforderlich.

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

string

Die Objekt-ID des zu aktualisierenden Diagramms.

UpdateShapePropertiesRequest

Aktualisiere die Eigenschaften einer Shape.

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

string

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

shapeProperties

object (ShapeProperties)

Die zu aktualisierenden Formeigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis shapeProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise die durchgängige Füllfarbe für die Form ändern möchten, setzen Sie fields auf "shapeBackgroundFill.solidFill.color".

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

Anfrage zur Aktualisierung von Bildeigenschaften

Aktualisiere die Eigenschaften einer 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 Image-Eigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis imageProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise die Farbe des Bildumrisses ändern möchten, setzen Sie fields auf "outline.outlineFill.solidFill.color".

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

Anfrage für Videoeigenschaften aktualisieren

Aktualisiere die Eigenschaften einer Video.

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

string

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

videoProperties

object (VideoProperties)

Die zu aktualisierenden Videoeigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis videoProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn du beispielsweise die Farbe der Videostruktur ändern möchtest, setze fields auf "outline.outlineFill.solidFill.color".

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

Anfrage_UpdateEigenschaften

Aktualisiert die Eigenschaften 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. Das Stammverzeichnis pageProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn du beispielsweise die ausgefüllte Füllfarbe der Seite ändern möchtest, setze fields auf "pageBackgroundFill.solidFill.color".

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

Tabellenzelle-Anforderung aktualisieren

Aktualisiere die Eigenschaften einer TableCell.

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

Die zu aktualisierenden Eigenschaften der Tabellenzelle.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis tableCellProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise die durchgehende Füllfarbe der Tabellenzelle aktualisieren möchten, setzen Sie fields auf "tableCellBackgroundFill.solidFill.color".

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

Tabellenbereich

Ein Tabellenbereich steht für einen Verweis auf eine Teilmenge einer Tabelle.

Die Zellen in einem Tabellenbereich bilden nicht unbedingt ein Rechteck. Beispiel: Wir haben eine 3 × 3-Tabelle, in der alle Zellen der letzten Zeile zusammengeführt sind. Die Tabelle sieht so aus:

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

Ein Tabellenbereich mit Standort = (0, 0), Zeilenbereich = 3 und Spaltenbereich = 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)

Die Ausgangsposition des Tabellenbereichs.

rowSpan

integer

Der Zeilenbereich des Tabellenbereichs

columnSpan

integer

Der Spaltenbereich des Tabellenbereichs.

UpdateLinePropertiesRequest

Aktualisiert die Eigenschaften einer Line.

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

string

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

lineProperties

object (LineProperties)

Die zu aktualisierenden Zeileneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis lineProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise die ausgefüllte Linienfarbe der Linie aktualisieren möchten, setzen Sie fields auf "lineFill.solidFill.color".

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

Anfrage zum Erstellen einer Absatzanfrage

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

Die Verschachtelungsebene jedes Absatzes wird ermittelt, indem führende Tabs vor jedem Absatz gezählt werden. Um den Abstand zwischen Aufzählungspunkt und dem entsprechenden Absatz zu reduzieren, werden die führenden Tabs durch diese Anfrage entfernt. Dadurch können die Indexe der Textabschnitte geändert werden.

Wenn sich der Absatz direkt vor den zu aktualisierenden Absätzen in einer Liste mit einer übereinstimmenden Voreinstellung befindet, werden die aktualisierten Absätze der vorherigen 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 mit dem Text, dem Sie Aufzählungszeichen hinzufügen möchten.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

Die Arten der zu verwendenden Aufzählungszeichen. Die Standardeinstellung ist BULLET_DISC_CIRCLE_SQUARE.

Aufzählungszeichen Glyphe

Voreingestellte Muster von Aufzählungszeichen für Listen im Text

Diese Muster verwenden folgende Arten von Aufzählungszeichen:

  • ARROW: Ein Pfeil, der einem Unicode-Code für U+2794 entspricht
  • ARROW3D: Ein Pfeil mit 3D-Schattierung, der einem Unicode-Code für U+27a2 entspricht
  • CHECKBOX: Ein hohles Quadrat, das einem Unicode-U+274f-Codepunkt entspricht
  • CIRCLE : ein hohler Kreis, der einem Unicode-U+25cb-Codepunkt entspricht
  • DIAMOND : Ein massiver Diamant, der einem Unicode-Code für U+25c6 entspricht
  • DIAMONDX : Ein Diamant mit einem „x“, der einem Unicode U+2756-Codepunkt entspricht
  • HOLLOWDIAMOND: Ein hohler Diamant, der einem Unicode-Code für U+25c7 entspricht
  • DISC: Ein durchgezogener Kreis, der einem Unicode-Code für U+25cf entspricht
  • SQUARE: Ein ausgefülltes Quadrat, das einem Unicode-U+25a0-Codepunkt entspricht
  • STAR: : Ein Stern, der einem Unicode-U+2605-Codepunkt entspricht
  • ALPHA: Ein Kleinbuchstaben, z. B. „a“, „b“ oder „c“.
  • UPPERALPHA : Ein Großbuchstaben, z. B. „A“, „B“ oder „C“.
  • DIGIT : Eine Zahl, z. B. „1“, „2“ oder „3“.
  • ZERODIGIT : Eine Zahl, der einstellige Ziffern vor einer Null vorangestellt sind, z. B. „01“, „02“ oder „03“. Ziffern mit mehr als einer Ziffer werden nicht mit einer Null versehen.
  • ROMAN : Ein römisches Kleinbuchstabe, z. B. „i“, „ii“ oder „iii“.
  • UPPERROMAN : Große römische Zahl, z. B. „I“, „II“ oder „III“.
  • LEFTTRIANGLE: Ein Dreieck, das nach links zeigt und einem Unicode-Code für U+25c4 entspricht
Enums
BULLET_DISC_CIRCLE_SQUARE Eine Aufzählungsliste mit einer DISC, CIRCLE und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Aufzählungsliste mit einer DIAMONDX, ARROW3D und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_CHECKBOX Eine Aufzählungsliste mit CHECKBOX-Aufzählungszeichen für alle Listenebenen.
BULLET_ARROW_DIAMOND_DISC Eine Aufzählungsliste mit einer ARROW, DIAMOND und DISC Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_STAR_CIRCLE_SQUARE Eine Aufzählungsliste mit einer STAR, CIRCLE und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit einer ARROW3D, CIRCLE und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit einer LEFTTRIANGLE, DIAMOND und DISC Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Aufzählungsliste mit einer DIAMONDX, HOLLOWDIAMOND und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Aufzählungsliste mit einer DIAMOND, CIRCLE und SQUARE Aufzählungszeichen Glyphe für die ersten 3 Verschachtelungsebenen.
NUMBERED_DIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen DIGIT, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen, 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, gefolgt von Klammern.
NUMBERED_DIGIT_NESTED Eine nummerierte Liste mit numerischen DIGIT-Glyphen, getrennt durch Punkte, wobei jede Verschachtelungsebene das Glyphen 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, gefolgt von Punkten.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Eine nummerierte Liste mit den numerischen Glyphen UPPERROMAN, UPPERALPHA und DIGIT für die ersten drei Verschachtelungsebenen, gefolgt von Punkten.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen ZERODIGIT, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen, gefolgt von Punkten.

AlleFormenmitBildanforderung ersetzen

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

Die Bilder, die die Formen ersetzen, sind rechteckig, nachdem sie in die Präsentation eingefügt wurden, 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)

Ersetzungsmethode.

Verworfen : 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 replaceMethod-Wert verwendet.

Wenn Sie keinen Wert angeben, wird CENTER_INSIDE verwendet.

pageObjectIds[]

string

Ist das Feld nicht leer, werden die Treffer auf die Seitenelemente auf den jeweiligen Seiten beschränkt.

Gibt den Fehler 400 zurück, wenn die Seitenobjekt-ID eines notes page- oder notes master-Objekts zurückgegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht vorhanden ist.

Union-Feld criteria. Die Kriterien, die die Formen erfüllen müssen, damit sie ersetzt werden. criteria darf nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

Wenn festgelegt, werden durch diese Anfrage alle Formen ersetzt, die den gegebenen Text enthalten.

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einer der folgenden Werte sein:
imageUrl

string

Bild-URL

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

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

Ersetzungsmethode

Ersetzungsmethode.

Enums
CENTER_INSIDE Skaliert und zentriert das Bild, damit es in den Rahmen der ursprünglichen Form passt und das Seitenverhältnis des Bilds beibehält. 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 Skaliert und zentriert das Bild, um die Rahmen der ursprünglichen Form zu füllen. Das Bild wird möglicherweise zugeschnitten, um die Form zu füllen. Die gerenderte Größe des Bildes entspricht der ursprünglichen Form.

Bildersetzungsmethode

Die Methode zum Ersetzen von Bildern

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Nicht angegebene Bildersetzungsmethode. Dieser Wert darf nicht verwendet werden.
CENTER_INSIDE Skaliert und zentriert das Bild, damit es in den Rahmen der ursprünglichen Form passt und das Seitenverhältnis des Bilds beibehält. 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 Skaliert und zentriert das Bild, um die Rahmen der ursprünglichen Form zu füllen. Das Bild wird möglicherweise zugeschnitten, um die Form zu füllen. Die gerenderte Größe des Bildes entspricht der ursprünglichen Form.

DoppelteObjektanfrage

Duplizierte Folien oder Seitenelemente.

Beim Duplizieren einer Folie wird die duplizierte Folie direkt nach der angegebenen Folie erstellt. Beim Duplizieren eines Seitenelements wird das Duplikat auf derselben Seite 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 duplizierte Objekt kann andere Objekte enthalten, beispielsweise beim Duplizieren einer Folie oder eines Gruppenseitenelements. Diese Zuordnung definiert, wie die IDs duplizierter Objekte generiert werden: Die Schlüssel sind die IDs der ursprünglichen Objekte und die Werte sind die IDs, die dem entsprechenden duplizierten Objekt zugewiesen werden. Die ID des Duplikats des Quellobjekts kann auch in dieser Zuordnung angegeben werden. Dabei wird derselbe Wert des Felds objectId als Schlüssel und die neue gewünschte ID als Wert verwendet.

Alle Schlüssel müssen den vorhandenen IDs in der Präsentation entsprechen. Alle Werte müssen in der Präsentation eindeutig sein und müssen mit einem alphanumerischen Zeichen oder einem Unterstrich (entspricht dem regulären Ausdruck [a-zA-Z0-9_]) beginnen. Die übrigen Zeichen können ebenso wie ein Bindestrich oder Doppelpunkt (entspricht dem regulären Ausdruck [a-zA-Z0-9_-:]) sein. Die Länge der neuen ID darf nicht kleiner als 5 oder größer als 50 sein.

Wenn IDs von Quellobjekten auf der Karte weggelassen werden, wird eine neue Zufalls-ID zugewiesen. Wenn die Karte leer oder nicht konfiguriert ist, erhalten alle doppelten Objekte eine neue Zufalls-ID.

Anfragetext aktualisieren

Aktualisieren Sie den Stil des Texts in einem Shape oder einem 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 gestaltenden Text.

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

Stil(e), der für den Text festgelegt werden soll

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Elements übereinstimmt, wird für diesen Stil die Übernahme übernommen.

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

textRange

object (Range)

Der Textbereich, der gestaltet werden soll.

Der Bereich kann um nachfolgende Zeilenumbrüche erweitert werden.

Wenn der Bereich einen Absatz enthält, der zu einer Liste gehört, wird auch der Absatzpunkt mit dem entsprechenden Textstil aktualisiert.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis style ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

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

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

AlleFormenmitTabellenDiagramm anfordern

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

HINWEIS: Zum Ersetzen von Formen durch ein Diagramm ist mindestens einer der Tabellen „read.read“, „Tabellen“, „drive.read“ oder „Drive“ erforderlich.

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

object (SubstringMatchCriteria)

Die Kriterien, die die Formen erfüllen müssen, damit sie ersetzt werden. Durch die Anfrage werden alle Formen ersetzt, die den gegebenen Text enthalten.

spreadsheetId

string

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

chartId

integer

Die ID des Diagramms aus der Google Tabellen-Tabelle.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn Sie nichts angeben, wird das Diagramm als nicht verknüpftes Diagramm verwendet.

pageObjectIds[]

string

Ist das Feld nicht leer, werden die Treffer auf die Seitenelemente auf den jeweiligen Seiten beschränkt.

Gibt den Fehler 400 zurück, wenn die Seitenobjekt-ID eines notes page- oder notes master-Objekts zurückgegeben wird oder wenn eine Seite mit dieser Objekt-ID in der Präsentation nicht vorhanden ist.

Verknüpfungsmodus

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. Andere Mitbearbeiter sehen den Link zur Tabelle.

LöschenParagraphBulletsAnfrage

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

Die Verschachtelungsebene jedes Absatzes wird visuell beibehalten, indem Sie ein Einzug am Anfang des entsprechenden Absatzes einfügen.

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

UpdateParagraphStyleRequest

Aktualisiert den Stil aller Absätze innerhalb eines Shape- oder Table-Elements, 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 gestaltenden Text.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle, die den Absatz(e) zum Stil enthält. Wenn sich objectId auf eine Tabelle bezieht, muss cellLocation einen Wert haben. Andernfalls darf dies nicht der Fall sein.

style

object (ParagraphStyle)

Der Stil des Absatzes.

textRange

object (Range)

Der Textbereich mit den Absätzen, die bzw. die bis zum Stil angegeben werden.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis style ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

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

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

UpdateTableBorderPropertiesRequest

Aktualisiert die Eigenschaften der Tabellenrahmen in einer Table.

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

Die Rahmenposition im Tabellenbereich, auf die die Änderungen angewendet werden sollen. Wird keine Rahmenposition angegeben, werden die Aktualisierungen auf alle Rahmen im Tabellenbereich angewendet.

tableBorderProperties

object (TableBorderProperties)

Die zu aktualisierenden Eigenschaften des Tabellenrahmens.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis tableBorderProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise die durchgehende Füllfarbe des Tabellenrahmens aktualisieren möchten, setzen Sie fields auf "tableBorderFill.solidFill.color".

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

Rahmenposition

Die Position des Tabellenrahmens.

Enums
ALL Alle Rahmen im Bereich.
BOTTOM Rahmenlinien am unteren Rand des Bereichs.
INNER Rahmen auf der Innenseite des Bereichs.
INNER_HORIZONTAL Horizontale Rahmen im Inneren des Bereichs.
INNER_VERTICAL Vertikale Rahmen im Inneren des Bereichs.
LEFT Rahmen links neben dem Bereich.
OUTER Rahmen am Rand des Bereichs.
RIGHT Rahmen rechts neben dem Bereich.
TOP Rahmen am oberen Rand 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 auf null basierenden Indexe, die angeben, welche Spalten aktualisiert werden sollen. Wenn keine Indexe bereitgestellt werden, werden alle Spalten in der Tabelle aktualisiert.

tableColumnProperties

object (TableColumnProperties)

Die zu aktualisierenden Eigenschaften der Tabellenspalte.

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

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis tableColumnProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

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

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

Tabelle_Eigenschaften_aktualisieren

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 auf null basierenden Indexe, die angeben, welche Zeilen aktualisiert werden sollen. Wenn keine Indexe bereitgestellt werden, 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. Das Stammverzeichnis tableRowProperties ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

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

Wenn „minRowHeight“ in der Feldmaske enthalten ist, das Attribut aber nicht konfiguriert ist, wird die minimale Zeilenhöhe standardmäßig auf 0 gesetzt.

MergeTableCellsRequest

Führt Zellen in einer 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.

Jeder Text in den Zellen, die zusammengeführt werden, wird verkettet und in der oberen linken Zelle („head“) des Bereichs gespeichert. Wenn der Bereich nicht rechteckig ist (kann in einigen Fällen vorkommen, in denen der Bereich bereits zusammengeführte Zellen umfasst), wird ein Fehler vom Typ „400 – Anfrage“ zurückgegeben.

UnmergeTableCellsRequest anfordern

Verbindet Zellen in einer Table zusammen.

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

Der Tabellenbereich, der angibt, für welche Zellen die Tabelle zusammengeführt werden soll.

Die Verbindung aller Zellen in diesem Bereich wird aufgehoben. Bereits zusammengeführte Zellen sind davon nicht betroffen. Wenn der Bereich keine verbundenen Zellen hat, führt die Anfrage nichts aus. Wenn in einer der verbundenen Zellen Text enthalten ist, bleibt er in der oberen linken Zelle („head“) der nicht verbundenen Zellen.

Gruppenobjektanfrage

Gruppiert Objekte zum Erstellen einer Objektgruppe Gruppiert Gruppen z. B. PageElements, um Group auf derselben Seite wie alle untergeordneten Elemente zu erstellen.

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

string

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

Wenn Sie eine ID angeben, muss sie für alle Seiten und Seitenelemente 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 ebenfalls solche sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein [a-zA-Z0-9_-:]). Die Länge der ID darf nicht kleiner als 5 oder größer als 50 sein.

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

childrenObjectIds[]

string

Die Objekt-IDs der zu gruppierenden Objekte

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

Anfrage für UngroupObjects

Hebt die Gruppierung von Objekten wie groups auf.

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

string

Die Objekt-IDs der zu gruppierenden Objekte.

Nur groups, die sich nicht in anderen groups befinden, kann die Gruppierung aufgehoben 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 eines alternativen Texts für page element.

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

string

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

title

string

Der aktualisierte ALT-Texttitel des Seitenelements. Wenn der Wert nicht festgelegt ist, wird der vorhandene Wert beibehalten. Der Titel wird Screenreadern und anderen Bedienungshilfen angezeigt. Verwenden Sie nur für Menschen lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

description

string

Die aktualisierte Alt-Textbeschreibung des Seitenelements. Wenn der Wert nicht festgelegt ist, wird der vorhandene Wert beibehalten. Die Beschreibung wird Screenreadern und anderen Bedienungshilfen angezeigt. Verwenden Sie nur für Menschen lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

Bildanfrage ersetzen

Ersetzt ein vorhandenes Bild durch ein neues.

Beim Ersetzen eines Images werden einige image effects aus dem vorhandenen Image 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 Bilds, das ersetzt wird. Die ID kann aus der Antwort einer „get“-Anfrage abgerufen werden.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Ersatzmethode.

Union-Feld image_source. Die Art der Bildquelle. image_source darf nur einer der folgenden Werte sein:
url

string

Bild-URL

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

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

UpdateSlidePropertiesRequest

Aktualisiert die Eigenschaften einer Folie.

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

string

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

slideProperties

object (SlideProperties)

Die zu aktualisierenden Folieneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis „slideProperties“ ist impliziert und sollte nicht angegeben werden. Ein einzelner "*" kann zum schnellen Auflisten aller Felder verwendet werden.

Wenn Sie beispielsweise festlegen möchten, ob eine Folie übersprungen werden soll, legen Sie für fields den Wert "isSkipped" fest.

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

UpdatePageElementsZOrderRequest

Aktualisiert die Z-Reihenfolge der Seitenelemente. Die Z-Reihenfolge ist eine Reihenfolge der Elemente auf der Seite von hinten nach vorne. Das Seitenelement im Vordergrund kann die Elemente dahinter abdecken.

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)

Z-Reihenfolge, die auf die Seitenelemente angewendet wird.

Wenn Sie den Vorgang auf mehrere Seitenelemente anwenden, wird die relative Z-Reihenfolge innerhalb dieser Seitenelemente übernommen, bevor der Vorgang beibehalten wird.

ZOrderOperation

Der Vorgang zum Aktualisieren der Z-Reihenfolge eines Seitenelements.

Enums
Z_ORDER_OPERATION_UNSPECIFIED Nicht angegebener Vorgang.
BRING_TO_FRONT Bringt die Seitenelemente in den Vordergrund der Seite
BRING_FORWARD Bringt die Seitenelemente auf der Seite um ein Element relativ zum nächsten Element in den angegebenen Seitenelementen voran.
SEND_BACKWARD Sendet die Seitenelemente um ein Element relativ zur Seite hinter dem angegebenen Seitenelement auf der Seite zurück.
SEND_TO_BACK Sendet die Seitenelemente an den Ende 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 einer category, die angibt, dass es sich um einen „Connector“ handelt, kann aktualisiert werden.

Nach der Aktualisierung der Kategorie wird die Route neu umgeleitet.

lineCategory

enum (LineCategory)

Die Linienkategorie, auf die aktualisiert werden soll.

Die genaue line type wird anhand der Kategorie, an die die Aktualisierung erfolgen soll, und der Weiterleitung zum Verbinden mit anderen Seitenelementen bestimmt.

Anfrage zur Weiterleitung

Leitet eine line so um, dass sie an den beiden nächstgelegenen Verbindungswebsites der verbundenen Seitenelemente verbunden ist.

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

string

Die Objekt-ID der umzuleitenden Linie.

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