Requests

Anfrage

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

JSON-Darstellung
{

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

object (CreateSlideRequest)

Erstellt eine neue Folie.

createShape

object (CreateShapeRequest)

Erstellt eine neue Form.

createTable

object (CreateTableRequest)

: Erstellt eine neue Tabelle.

insertText

object (InsertTextRequest)

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

insertTableRows

object (InsertTableRowsRequest)

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 eine Seite oder ein Seitenelement aus der Präsentation.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aktualisiert die Transformation eines Seitenelements.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Aktualisiert die Position mehrerer Folien in der Präsentation.

deleteText

object (DeleteTextRequest)

Löscht Text aus einer Form oder Tabellenzelle.

createImage

object (CreateImageRequest)

Erstellt ein Image.

createVideo

object (CreateVideoRequest)

Erstellt ein Video.

createSheetsChart

object (CreateSheetsChartRequest)

Erstellt ein eingebettetes Google Tabellen-Diagramm.

createLine

object (CreateLineRequest)

Erstellt eine Linie.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Aktualisiert ein Google Tabellen-Diagramm.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualisiert die Eigenschaften eines Shape

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualisiert die Eigenschaften eines Image

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualisiert die Eigenschaften eines Video

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualisiert die Eigenschaften eines Page

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualisiert die Eigenschaften eines TableCell

updateLineProperties

object (UpdateLinePropertiesRequest)

Aktualisiert die Eigenschaften eines Line

createParagraphBullets

object (CreateParagraphBulletsRequest)

Erstellt Aufzählungszeichen für Absätze.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

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

duplicateObject

object (DuplicateObjectRequest)

Dupliziert eine Folie oder ein Seitenelement.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert den Stil von Text in einem Shape oder Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Löscht Aufzählungszeichen aus Absätzen.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualisiert den Stil von Absätzen in einem Shape oder Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualisiert die Eigenschaften der Tabellenrahmen in einem Table

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Eigenschaften eines Table Spalte.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aktualisiert die Eigenschaften eines Table Zeile.

mergeTableCells

object (MergeTableCellsRequest)

Verbindet Zellen in einem Table

unmergeTableCells

object (UnmergeTableCellsRequest)

Hebt den Zellenverbund in einem auf Table

groupObjects

object (GroupObjectsRequest)

Gruppiert Objekte wie Seitenelemente.

ungroupObjects

object (UngroupObjectsRequest)

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

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Aktualisiert den Titel und/oder die Beschreibung eines page element

replaceImage

object (ReplaceImageRequest)

Ersetzt ein vorhandenes Image durch ein neues.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Eigenschaften einer Folie aktualisieren

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Aktualisiert die Z-Reihenfolge von page elements

updateLineCategory

object (UpdateLineCategoryRequest)

Aktualisiert die Kategorie eines line

rerouteLine

object (RerouteLineRequest)

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

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 diese unter allen Seiten und Seitenelementen in der Präsentation eindeutig sein. Die ID muss mit einem alphanumerischen Zeichen oder einem Unterstrich beginnen (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_]); Die verbleibenden Zeichen können diese sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_-:]). Die ID muss zwischen 5 und 50 Zeichen lang sein.

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

Layoutreferenz der Folie, die eingefügt werden soll, basierend auf dem aktueller Master. Dies ist einer der folgenden Werte:

  • Der Master des vorherigen Folienindex.
  • Master der ersten Folie, wenn der Platzhalter für den Platzhalter null ist.
  • Der erste Master der Präsentation, falls keine Folien vorhanden sind.

Wird die LayoutReference im aktuellen Master nicht gefunden, wird der Fehler "400 Bad Request" zurückgegeben.

Wenn Sie keinen Layoutverweis angeben, werden für die Folie die vordefinierten BLANK Layout.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Eine optionale Liste von Objekt-ID-Zuordnungen aus der placeholder (n) vom Layout bis zu den Platzhaltern, die auf der Folie mit dem festgelegten Layout erstellt werden. Kann nur verwendet werden, wenn slideLayoutReference angegeben ist.

LayoutReference

Referenz zum Folienlayout. Dies kann auf Folgendes verweisen:

  • Ein vordefiniertes Layout
  • Eines der Layouts 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 kann nur einer der folgenden Werte sein:
predefinedLayout

enum (PredefinedLayout)

Vordefiniertes Layout.

layoutId

string

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

PredefinedLayout

Vordefinierte Layouttypen Diese Layouts sind häufig in Präsentationen zu finden. 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 sind. Möglicherweise wurden auch die Platzhalter in den einzelnen Layouts geändert.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Nicht spezifiziertes Layout.
BLANK Leeres Layout ohne Platzhalter.
CAPTION_ONLY Layout mit einer Bildunterschrift am unteren Rand.
TITLE Layout mit Titel und Untertitel.
TITLE_AND_BODY Layout mit Titel und 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 einer 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 einer großen Zahl als Überschrift.

LayoutPlaceholderIdMapping

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

JSON-Darstellung
{
  "objectId": string,

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

string

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

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

Union-Feld kind Der Typ zum Identifizieren eines Platzhalters in einem Layout. kind kann nur einer der folgenden Werte sein:
layoutPlaceholder

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

CreateShapeRequest

Erstellt eine neue Form.

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

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

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Form.

shapeType

enum (Type)

Der Formtyp.

PageElementProperties

Allgemeine Eigenschaften eines Seitenelements

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Tabelle.

Die Tabelle wird in der angegebenen Größe und vorbehaltlich einer Mindestgröße erstellt. Wenn Sie keine Größe angeben, wird die Größe der Tabelle automatisch angepasst.

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

rows

integer

Anzahl der Zeilen in der Tabelle.

columns

integer

Anzahl der Spalten in der Tabelle.

InsertTextRequest

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)

Die optionale Position einer Tabellenzelle, wenn der Text in eine Tabellenzelle eingefügt werden soll. Falls vorhanden, muss die Objekt-ID auf eine Tabelle verweisen.

text

string

Der Text, der eingefügt werden soll.

Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein neues ParagraphMarker bei diesem Index. Der Absatzstil des neuen Absatzes wird aus dem Absatz im aktuellen Einfügungsindex kopiert, einschließlich Listen und Aufzählungszeichen.

Textstile für eingefügten Text werden automatisch ermittelt, wobei im Allgemeinen der Stil des angrenzenden Textes beibehalten wird. In den meisten Fällen wird der Text TextRun die am Einfügeindex vorhanden ist.

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, in den der Text eingefügt wird, in Unicode-Codeeinheiten, basierend auf TextElement Indexe.

Der Index ist nullbasiert und wird ab dem Beginn des Strings berechnet. Der Index kann angepasst werden, um Einfügungen innerhalb von Unicode-Graphem-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 Zellenposition der Referenztabelle, von der aus Zeilen eingefügt werden.

Über (oder unter) der Zeile, in der sich die Referenzzelle befindet, wird eine neue Zeile eingefügt. Wenn es sich bei der Referenzzelle um eine verbundene Zelle handelt, wird oberhalb (oder unterhalb) der verbundenen Zelle eine neue Zeile eingefügt.

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

Fügt Spalten in eine Tabelle ein.

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

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

string

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

cellLocation

object (TableCellLocation)

Die Zellenposition der Referenztabelle, von der aus Spalten eingefügt werden.

Links (oder rechts) der Spalte, in der sich die Referenzzelle befindet, wird eine neue Spalte eingefügt. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird links (oder rechts) von der verbundenen Zelle eine neue Spalte 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 Spalten, die eingefügt werden sollen. Maximal 20 pro Anfrage.

DeleteTableRowRequest

Löscht eine Zeile aus einer Tabelle.

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

string

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

cellLocation

object (TableCellLocation)

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

Die Zeile, über die sich diese Zelle erstreckt, wird gelöscht. Wenn dies eine zusammengeführte Zelle ist, 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 Referenztabelle, von der aus eine Spalte gelöscht wird.

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

ReplaceAllTextRequest

Ersetzt alle Instanzen von Text, der einem Kriterium entspricht durch replace text

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

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

string

Der Text, durch den der übereinstimmende Text ersetzt wird.

pageObjectIds[]

string

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

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

Union-Feld criteria Das Kriterium, das zum Abgleichen des zu ersetzenden Textes verwendet wird. criteria kann nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

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

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

string

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

matchCase

boolean

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

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

DeleteObjectRequest

Löscht ein Objekt, entweder pages oder page elements aus der Präsentation.

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

string

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

Wenn nach einem Löschvorgang group enthält, wird die Gruppe ebenfalls gelöscht.

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

UpdatePageElementTransformRequest

Aktualisiert die Transformation eines Seitenelements.

Wenn Sie die Transformation einer Gruppe aktualisieren, ändert sich auch die absolute Transformation der Seitenelemente in dieser Gruppe, was wiederum ihre visuelle Darstellung ä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 Seitenelements, das aktualisiert werden soll.

transform

object (AffineTransform)

Die Eingabetransformationsmatrix, die zum Aktualisieren des Seitenelements verwendet wird.

applyMode

enum (ApplyMode)

Der Anwendungsmodus der Transformationsaktualisierung.

ApplyMode

Die Anwendungsmodi der Transformationsaktualisierung.

Enums
APPLY_MODE_UNSPECIFIED Nicht spezifizierter 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 vorliegen (ohne Duplikate).

insertionIndex

integer

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

DeleteTextRequest

Löscht Text aus einer Form oder Tabellenzelle.

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

Der zu löschende Textbereich, basierend auf TextElement Indexe.

Am Ende des Textes einer Form oder einer Tabellenzelle steht immer ein implizites Zeilenumbruchzeichen, das nicht gelöscht werden kann. Range.Type.ALL verwendet die richtigen Grenzen, aber Sie müssen vorsichtig sein, wenn Sie explizite Grenzen für Bereichstypen festlegen. FROM_START_INDEX und FIXED_RANGE Wenn der Text beispielsweise „ABC“ ist, gefolgt von einem impliziten Zeilenumbruch, ist der Maximalwert für textRange.start_index und 3 für textRange.end_index.

Das Löschen von Text, der eine Absatzgrenze überschreitet, kann Änderungen an Absatzformaten und -listen nach sich ziehen, 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, z. B. Zeichen in Text.

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

integer

Der optionale, nullbasierte Index für den Beginn der Sammlung. Erforderlich für FIXED_RANGE und FROM_START_INDEX Bereiche.

endIndex

integer

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

type

enum (Type)

Der Typ des Bereichs.

Typ

Die Bereichstypen.

Enums
RANGE_TYPE_UNSPECIFIED Nicht angegebener Bereichstyp. Dieser Wert darf nicht verwendet werden.
FIXED_RANGE Ein fester Bereich. Sowohl die startIndex und endIndex angegeben werden.
FROM_START_INDEX Beginn des Bereichs bei startIndex bis zum Ende der Sammlung. Die endIndex darf nicht angegeben werden.
ALL Legt den Bereich auf die gesamte Länge der Sammlung fest. Sowohl die startIndex und die endIndex darf nicht angegeben werden.

CreateImageRequest

Erstellt ein Image.

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

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Bild.

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

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

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

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

string

Die Bild-URL.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird gespeichert, um in der Präsentation angezeigt zu werden. Bilder müssen kleiner als 50 MB und höchstens 25 Megapixel sein und im PNG-, JPEG- oder GIF-Format vorliegen.

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

CreateVideoRequest

Erstellt ein Video.

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

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Video.

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

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

source

enum (Source)

Die Videoquelle.

id

string

Die eindeutige Kennung der Videoquelle für dieses Video.

z.B. Für YouTube-Videos https://www.youtube.com/watch?v=7U3axjORYZ0 lautet die ID 7U3axjORYZ0. Für ein Google Drive-Video https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q lautet die ID 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

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

CreateSheetsChartRequest

Erstellt ein eingebettetes Google Tabellen-Diagramm.

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

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

string

Eine vom Nutzer bereitgestellte Objekt-ID.

Falls die ID angegeben wird, muss sie für alle Seiten und Seitenelemente in der Präsentation eindeutig sein. Die ID sollte mit einem Wortzeichen [a-zA-Z0-9_] beginnen, gefolgt von einer beliebigen Anzahl der folgenden Zeichen [a-zA-Z0-9_-:]. Die ID darf nicht kürzer als 5 oder größer als 50 sein. Wenn das Feld leer ist, wird eine eindeutige Kennung generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für das Diagramm.

Wenn das Seitenverhältnis der angegebenen Größe nicht mit dem des Diagramms übereinstimmt, wird das Diagramm im Verhältnis zur 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 der alten Dateien einen Ressourcenschlüssel hinzufügen. Weitere Informationen finden Sie unter Mit Ressourcenschlüsseln auf per Link freigegebene Dateien zugreifen

chartId

integer

Die ID des Diagramms in der Tabelle in Google Tabellen.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn keine Angabe erfolgt, ist das Diagramm ein nicht verknüpftes Bild.

LinkingMode

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

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

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

elementProperties

object (PageElementProperties)

Die Elementeigenschaften für die Linie.

lineCategory
(deprecated)

enum (Category)

Die Kategorie der zu erstellenden Linie.

<ph type="x-smartling-placeholder"></ph> Eingestellt : Verwenden Sie category .

Die genaue line type erstellt wird, hängt von der Kategorie und davon ab, wie sie zur Verbindung mit anderen Seitenelementen weitergeleitet wird.

Wenn Sie sowohl ein category und lineCategory, der category hat Vorrang.

category

enum (LineCategory)

Die Kategorie der zu erstellenden Linie.

Die genaue line type erstellt wird, hängt von der Kategorie und davon ab, wie sie zur Verbindung mit anderen Seitenelementen weitergeleitet wird.

Wenn Sie sowohl ein category und lineCategory, der category hat Vorrang.

Wenn Sie keinen Wert für category, aber geben Sie einen Wert für lineCategory, dann die angegebene lineCategory -Wert verwendet wird.

Wenn Sie keines von beidem angeben, STRAIGHT verwendet wird.

Kategorie

Die Linienkategorien.

<ph type="x-smartling-placeholder">

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

RefreshSheetsChartRequest

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

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

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

string

Die Objekt-ID des zu aktualisierenden Diagramms.

UpdateShapePropertiesRequest

Die Eigenschaften eines Shape

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

string

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

shapeProperties

object (ShapeProperties)

Die zu aktualisierenden Formeigenschaften.

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. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

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

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

UpdateImagePropertiesRequest

Aktualisieren Sie die Eigenschaften eines Image

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

string

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

imageProperties

object (ImageProperties)

Die Bildeigenschaften, die aktualisiert werden sollen.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

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

UpdateVideoPropertiesRequest

Die Eigenschaften eines Video

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

string

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

videoProperties

object (VideoProperties)

Die Videoeigenschaften, die aktualisiert werden sollen.

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. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

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

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

UpdatePagePropertiesRequest

Aktualisiert die Eigenschaften eines Page

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

string

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

pageProperties

object (PageProperties)

Die zu aktualisierenden Seiteneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

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

UpdateTableCellPropertiesRequest

Die Eigenschaften 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 Eigenschaften der Tabellenzellen, die aktualisiert werden sollen.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Um beispielsweise die Volltonfarbe für den Hintergrund der Tabellenzelle zu aktualisieren, fields bis "tableCellBackgroundFill.solidFill.color".

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

TableRange

Ein Tabellenbereich stellt einen Verweis auf eine Teilmenge einer Tabelle dar.

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

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

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

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

object (TableCellLocation)

Der Ausgangspunkt des Tabellenbereichs.

rowSpan

integer

Der Zeilenumfang des Tabellenbereichs.

columnSpan

integer

Der Spaltenumfang des Tabellenbereichs.

UpdateLinePropertiesRequest

Aktualisiert die Eigenschaften eines Line

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

string

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

lineProperties

object (LineProperties)

Die zu aktualisierenden Linieneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Um beispielsweise die Volltonfüllfarbe der Linie zu aktualisieren, fields bis "lineFill.solidFill.color".

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

CreateParagraphBulletsRequest

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

Die Verschachtelungsebene jedes Absatzes wird ermittelt, indem die vor jedem Absatz vorangehenden Tabulatoren gezählt werden. Um unnötigen Abstand zwischen dem Aufzählungszeichen und dem entsprechenden Absatz zu vermeiden, werden diese führenden Tabulatoren im Rahmen dieser Anfrage entfernt. Dadurch können sich die Indizes der Teile des Textes ändern.

Wenn sich der Absatz unmittelbar vor dem zu aktualisierenden Absatz in einer Liste mit einer übereinstimmenden Voreinstellung befindet, werden die zu aktualisierenden 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, der Aufzählungspunkte 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 die Objekt-ID auf eine Tabelle verweisen.

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

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

In diesen Mustern werden folgende Arten von Aufzählungspunkten verwendet:

  • ARROW : Ein Pfeil, der einem Unicode-U+2794-Codepunkt entspricht
  • ARROW3D : ein Pfeil mit 3D-Schattierung, der einem Unicode U+27a2-Codepunkt entspricht
  • CHECKBOX : Ein leeres Quadrat, das einem Unicode-Codepunkt U+274f entspricht
  • CIRCLE : Ein hohler Kreis, der einem Unicode-Codepunkt U+25cb entspricht
  • DIAMOND : Eine durchgehende Raute, die einem Unicode-U+25c6-Codepunkt entspricht
  • DIAMONDX : Eine Raute mit einem "x", die einem Unicode U+2756-Codepunkt entspricht
  • HOLLOWDIAMOND : Eine leere Raute, die einem Unicode-U+25c7-Codepunkt entspricht
  • DISC : Ein ausgefüllter Kreis, der einem Unicode-U+25cf-Codepunkt entspricht
  • SQUARE : Ein ausgefülltes Quadrat, das einem Codepunkt in Unicode U+25a0 entspricht
  • STAR : ein Stern, der einem Unicode-U+2605-Codepunkt entspricht
  • ALPHA : Ein Kleinbuchstabe wie „a“, „b“ oder „c“.
  • UPPERALPHA : Ein Großbuchstaben wie "A", "B" oder "C".
  • DIGIT : Eine Zahl wie "1", "2" oder "3".
  • ZERODIGIT : Eine Zahl, bei der einstellige Zahlen mit einer Null vorangestellt werden, z. B. „01“, „02“ oder „03“. Zahlen mit mehr als einer Ziffer wird keine Null vorangestellt.
  • ROMAN : Eine kleine römische Zahl wie „i“, „ii“ oder „iii“.
  • UPPERROMAN : Eine große römische Zahl wie „I“, „II“ oder „III“.
  • LEFTTRIANGLE : Ein nach links zeigendes Dreieck, das einem Unicode-U+25c4-Codepunkt entspricht
Enums
BULLET_DISC_CIRCLE_SQUARE Eine Aufzählungsliste mit einem DISC, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Aufzählungsliste mit einem DIAMONDX, ARROW3D und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_CHECKBOX Eine Aufzählungsliste mit CHECKBOX Aufzählungszeichen Glyphen für alle Verschachtelungsebenen einer Liste.
BULLET_ARROW_DIAMOND_DISC Eine Aufzählungsliste mit einem ARROW, DIAMOND und DISC Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_STAR_CIRCLE_SQUARE Eine Aufzählungsliste mit einem STAR, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit einem ARROW3D, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit einem LEFTTRIANGLE, DIAMOND und DISC Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Aufzählungsliste mit einem DIAMONDX, HOLLOWDIAMOND und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Aufzählungsliste mit einem DIAMOND, CIRCLE und SQUARE Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
NUMBERED_DIGIT_ALPHA_ROMAN Eine nummerierte Liste mit DIGIT, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Eine nummerierte Liste mit DIGIT, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Klammern.
NUMBERED_DIGIT_NESTED Eine nummerierte Liste mit DIGIT numerische Glyphen, die durch Punkte getrennt sind, wobei für jede Verschachtelungsebene das Glyphe der vorherigen Verschachtelungsebene als Präfix verwendet wird. Beispiel: '1.', "1.1.", „2.“, „2.2.“.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Eine nummerierte Liste mit UPPERALPHA, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Eine nummerierte Liste mit UPPERROMAN, UPPERALPHA und DIGIT numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Eine nummerierte Liste mit ZERODIGIT, ALPHA und ROMAN numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.

ReplaceAllShapesWithImageRequest

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

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

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

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

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

enum (ReplaceMethod)

Die Ersetzungsmethode.

<ph type="x-smartling-placeholder"></ph> Eingestellt : Verwenden Sie imageReplaceMethod .

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

imageReplaceMethod

enum (ImageReplaceMethod)

Die Methode zum Ersetzen von Bildern.

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

Wenn Sie keinen Wert für imageReplaceMethod, aber geben Sie einen Wert für replaceMethod, dann die angegebene replaceMethod -Wert verwendet wird.

Wenn Sie keines von beiden angeben, wird CENTER_INSIDE verwendet.

pageObjectIds[]

string

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

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

Union-Feld criteria Die Kriterien, denen die Formen entsprechen müssen, damit sie ersetzt werden können. criteria kann nur einer der folgenden Werte sein:
containsText

object (SubstringMatchCriteria)

Wenn festgelegt, ersetzt diese Anfrage alle Formen, die den angegebenen Text enthalten.

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

string

Die Bild-URL.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird gespeichert, um in der Präsentation angezeigt zu werden. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem müssen sie im PNG-, JPEG- oder GIF-Format vorliegen.

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

ReplaceMethod

Die Ersetzungsmethode.

<ph type="x-smartling-placeholder">

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

ImageReplaceMethod

Die Methode zum Ersetzen von Bildern.

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Nicht angegebene Methode zum Ersetzen von Bildern. Dieser Wert darf nicht verwendet werden.
CENTER_INSIDE Skaliert und zentriert das Bild, sodass es in die Grenzen der ursprünglichen Form passt und das Seitenverhältnis des Bildes beibehalten wird. Das gerenderte Bild des Bildes ist möglicherweise kleiner als die Größe der Form. Dies ist die Standardmethode, wenn keine angegeben wurde.
CENTER_CROP Skaliert und zentriert das Bild, damit es die Grenzen der ursprünglichen Form ausfüllt. Eventuell wird das Bild zugeschnitten, um die Form auszufüllen. Das Bild wird in derselben Größe wie die ursprüngliche Form gerendert.

DuplicateObjectRequest

Dupliziert eine Folie oder ein Seitenelement.

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

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

string

Die ID des zu duplizierenden Objekts.

objectIds

map (key: string, value: string)

Das zu duplizierende Objekt kann andere Objekte enthalten, z. B. beim Duplizieren einer Folie oder eines Gruppenseitenelements. Diese Zuordnung definiert, wie die IDs duplizierter Objekte generiert werden: Die Schlüssel sind die IDs der ursprünglichen Objekte und ihre Werte die IDs, die dem entsprechenden duplizierten Objekt zugewiesen werden. Die ID des Duplikats des Quellobjekts kann auch in dieser Zuordnung angegeben werden, wobei derselbe Wert für den 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 können diese sowie einen Bindestrich oder Doppelpunkt enthalten (stimmt mit dem regulären Ausdruck überein) [a-zA-Z0-9_-:]). Die neue ID darf nicht kürzer als 5 oder größer als 50 sein.

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

UpdateTextStyleRequest

Aktualisieren Sie den Stil 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 Text, der formatiert werden soll.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle mit dem zu gestaltenden Text. Wenn objectId auf eine Tabelle verweist, cellLocation muss einen Wert haben. Andernfalls darf sie nicht angezeigt werden.

style

object (TextStyle)

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

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Stils übereinstimmt, wird dieser Stil auf die Übernahme festgelegt.

Bestimmte Textstiländerungen können zu anderen Änderungen führen, die dem Verhalten des Präsentationen-Editors entsprechen. Weitere Informationen finden Sie in der Dokumentation zu TextStyle .

textRange

object (Range)

Der Textbereich, der formatiert werden soll.

Der Bereich kann auf benachbarte Zeilenumbrüche erweitert werden.

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

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Um den Textstil beispielsweise in Fettdruck zu ändern, setzen Sie fields bis "bold".

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

ReplaceAllShapesWithSheetsChartRequest

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

HINWEIS: Wenn Sie Formen durch ein Diagramm ersetzen möchten, ist mindestens einer der OAuth-Bereiche „spreadsheets.readonly“, „ spreadsheet“, „drive.readonly“ oder „drive“ erforderlich.

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

object (SubstringMatchCriteria)

Die Kriterien, denen die Formen entsprechen müssen, damit sie ersetzt werden können. Die Anforderung ersetzt alle Formen, die den gegebenen Text enthalten.

spreadsheetId

string

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

chartId

integer

Die ID des Diagramms in der Tabelle in Google Tabellen.

linkingMode

enum (LinkingMode)

Der Modus, mit dem das Diagramm mit der Quelltabelle verknüpft ist. Wenn keine Angabe erfolgt, ist das Diagramm ein nicht verknüpftes Bild.

pageObjectIds[]

string

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

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

LinkingMode

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

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

DeleteParagraphBulletsRequest

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

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

UpdateParagraphStyleRequest

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

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

string

Die Objekt-ID der Form oder Tabelle mit dem Text, der formatiert werden soll.

cellLocation

object (TableCellLocation)

Die Position der Zelle in der Tabelle mit den Absätzen, die formatiert werden sollen. Wenn objectId auf eine Tabelle verweist, cellLocation muss einen Wert haben. Andernfalls darf sie nicht angezeigt werden.

style

object (ParagraphStyle)

Der Stil des Absatzes.

textRange

object (Range)

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

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

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

UpdateTableBorderPropertiesRequest

Aktualisiert die Eigenschaften der Tabellenrahmen in einem Table

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

Die Rahmenposition im Tabellenbereich, auf die die Aktualisierungen angewendet werden sollen. Wenn Sie keine Rahmenposition angeben, werden die Änderungen auf alle Rahmen im Tabellenbereich angewendet.

tableBorderProperties

object (TableBorderProperties)

Die Eigenschaften des Tabellenrahmens, die aktualisiert werden sollen.

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. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Volltonfarbe für den Tabellenrahmen zu aktualisieren, fields bis "tableBorderFill.solidFill.color".

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

BorderPosition

Die Position des Tabellenrahmens.

Enums
ALL Alle Rahmen im Bereich.
BOTTOM Rahmen am unteren Rand des Bereichs.
INNER Rahmenlinien innerhalb des Bereichs.
INNER_HORIZONTAL Horizontale Rahmenlinien innerhalb des Bereichs.
INNER_VERTICAL Vertikale Rahmenlinien innerhalb des Bereichs.
LEFT Rahmenlinien links neben dem Bereich.
OUTER Rahmenlinien außerhalb des Bereichs.
RIGHT Rahmenlinien rechts neben dem Bereich.
TOP Rahmenlinien am oberen Rand des Bereichs.

UpdateTableColumnPropertiesRequest

Aktualisiert die Eigenschaften eines 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 nullbasierter Indizes, die angeben, welche Spalten aktualisiert werden sollen. Wenn keine Indexe angegeben werden, werden alle Spalten in der Tabelle aktualisiert.

tableColumnProperties

object (TableColumnProperties)

Die Eigenschaften der Tabellenspalte, die aktualisiert werden sollen.

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

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

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

UpdateTableRowPropertiesRequest

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

tableRowProperties

object (TableRowProperties)

Die zu aktualisierenden Tabellenzeileneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Um beispielsweise die minimale Zeilenhöhe zu aktualisieren, fields bis "minRowHeight".

Wenn "minRowHeight"' in der Feldmaske enthalten ist, aber die Eigenschaft nicht festgelegt ist, wird die minimale Zeilenhöhe standardmäßig auf 0 gesetzt.

MergeTableCellsRequest

Verbindet Zellen in einem Table

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

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

Der Text in den Zellen, die zusammengeführt werden, wird verkettet und in der oberen linken Zelle („Kopfzelle“) des Bereichs gespeichert. Wenn der Bereich nicht rechteckig ist (was in einigen Fällen vorkommen kann, wenn der Bereich Zellen umfasst, die bereits verbunden sind), wird der Fehler 400 ungültig.

UnmergeTableCellsRequest

Hebt den Zellenverbund in einem auf Table

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

string

Die Objekt-ID der Tabelle.

tableRange

object (TableRange)

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

Für alle verbundenen Zellen in diesem Bereich wird die Verbindung aufgehoben. Bereits zusammengeführte Zellen sind davon nicht betroffen. Wenn der Bereich keine verbundenen Zellen enthält, führt die Anfrage nichts aus. Wenn sich in einer der zusammengeführten Zellen Text befindet, bleibt der Text in der oberen linken Zelle (Hauptzelle) des resultierenden Blocks mit nicht verbundenen Zellen.

GroupObjectsRequest

Gruppiert Objekte, um eine Objektgruppe zu erstellen. Beispiel: Gruppen PageElements zum Erstellen eines Group sich alle untergeordneten Elemente auf derselben Seite befinden.

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

string

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

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

Wenn Sie keine ID angeben, wird eine eindeutige generiert.

childrenObjectIds[]

string

Die Objekt-IDs der Objekte, die gruppiert werden sollen.

Nur Seitenelemente können gruppiert werden. Es sollte mindestens zwei Seitenelemente auf derselben Seite geben, die sich nicht bereits in einer anderen Gruppe befinden. Einige Seitenelemente wie videos, tables und placeholders kann nicht gruppiert werden.

UngroupObjectsRequest

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

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

string

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

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

UpdatePageElementAltTextRequest

Aktualisiert den Titel und/oder die Beschreibung eines page element

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

string

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

title

string

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

description

string

Die aktualisierte Alt-Text-Beschreibung des Seitenelements. Wenn kein Wert festgelegt ist, wird der vorhandene Wert beibehalten. Die Beschreibung ist für Screenreader und andere Bedienungshilfen zugänglich. Verwenden Sie nur für Menschen lesbare Werte, die sich auf den Inhalt des Seitenelements beziehen.

ReplaceImageRequest

Ersetzt ein vorhandenes Image durch ein neues.

Beim Ersetzen eines Bildes werden einige image effects aus dem vorhandenen Image.

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 Images, das ersetzt wird. Die ID kann der Antwort einer get-Anfrage entnommen werden.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Ersetzungsmethode.

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

string

Die Bild-URL.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie wird gespeichert, um in der Präsentation angezeigt zu werden. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein und 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 Image.source_url ein.

UpdateSlidePropertiesRequest

Aktualisiert die Eigenschaften einer Folie.

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

string

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

slideProperties

object (SlideProperties)

Die zu aktualisierenden Folieneigenschaften.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise festlegen möchten, ob eine Folie übersprungen wird, stellen Sie fields bis "isSkipped".

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

UpdatePageElementsZOrderRequest

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

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

string

Die Objekt-IDs der Seitenelemente, die aktualisiert werden sollen.

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

operation

enum (ZOrderOperation)

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

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

ZOrderOperation

Vorgang zum Aktualisieren der Z-Reihenfolge eines Seitenelements

Enums
Z_ORDER_OPERATION_UNSPECIFIED Nicht spezifizierter Vorgang.
BRING_TO_FRONT Bringt die Seitenelemente in den Vordergrund der Seite
BRING_FORWARD Bringt die Seitenelemente auf der Seite um ein Element nach vorn, bezogen auf das vorste Element in den angegebenen Seitenelementen.
SEND_BACKWARD Verschiebt die Seitenelemente auf der Seite um ein Element zurück, das sich in den angegebenen Seitenelementen am weitesten hinten befindet.
SEND_TO_BACK Die Seitenelemente werden an den hinteren Teil der Seite verschoben.

UpdateLineCategoryRequest

Aktualisiert die Kategorie eines line

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

string

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

Nur eine Zeile mit einem category gibt an, dass es sich um einen aktualisiert werden kann.

Die Linie kann nach der Aktualisierung der Kategorie umgeleitet werden.

lineCategory

enum (LineCategory)

Die Linienkategorie, auf die aktualisiert werden soll.

Die genaue line type wird anhand der Kategorie bestimmt, auf die aktualisiert werden soll, und davon, wie sie weitergeleitet wird, um eine Verbindung zu anderen Seitenelementen herzustellen.

RerouteLineRequest

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

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

string

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

Nur eine Zeile mit einem category gibt an, dass es sich um einen kann umgeleitet werden. Die Start- und Endverbindungen der Linie müssen sich auf verschiedenen Seitenelementen befinden.