Text

TextContent

Der allgemeine Textinhalt. Der Text muss eine kompatible Form (z.B. Textfeld oder Rechteck) oder eine Tabellenzelle auf der Seite haben.

JSON-Darstellung
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Felder
textElements[]

object (TextElement)

Der Textinhalt, aufgeschlüsselt nach seinen Bestandteilen, einschließlich Stilinformationen. Diese Eigenschaft ist schreibgeschützt.

lists

map (key: string, value: object ( List))

Die in diesem Text enthaltenen Aufzählungslisten, aufgeschlüsselt nach Listen-ID.

TextElement

Ein TextElement beschreibt den Inhalt einer Reihe von Indexen im Textinhalt einer Form oder einer TableCell.

JSON-Darstellung
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
Felder
startIndex

integer

Der nullbasierte Startindex dieses Textelements in Unicode-Codeeinheiten.

endIndex

integer

Der nullbasierte Endindex dieses Textelements, exklusiv, in Unicode-Codeeinheiten.

Union-Feld kind Die Art des Textes, den dieses Element repräsentiert. kind kann nur einer der folgenden Werte sein:
paragraphMarker

object (ParagraphMarker)

Eine Markierung, die den Anfang eines neuen Absatzes darstellt.

Die startIndex und endIndex dieses TextElements stellen den Bereich des Absatzes dar. Andere TextElements mit einem Indexbereich, der innerhalb des Bereichs dieses Absatzes enthalten ist, werden als Teil des Absatzes betrachtet. Der Indexbereich zweier separater Absätze überschneidet sich niemals.

textRun

object (TextRun)

Ein TextElement, das einen Textlauf darstellt, bei dem alle Zeichen im Lauf gleich TextStyle

Die startIndex und endIndex von TextRuns liegen immer vollständig im Indexbereich einer einzelnen paragraphMarker TextElement zurück. Mit anderen Worten: Ein TextRun erstreckt sich niemals über mehrere Absätze.

autoText

object (AutoText)

Ein TextElement, das einen Punkt im Text darstellt, der dynamisch durch Inhalt ersetzt wird, der sich im Laufe der Zeit ändern kann.

ParagraphMarker

Eine TextElement-Art, die den Anfang eines neuen Absatzes darstellt.

JSON-Darstellung
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Felder
style

object (ParagraphStyle)

Absatzstil

bullet

object (Bullet)

Der Aufzählungspunkt für diesen Absatz. Wenn nicht vorhanden, gehört der Absatz zu keiner Liste.

ParagraphStyle

Stile, die für einen ganzen Absatz gelten.

Wenn dieser Text in einer Form mit einem übergeordneten Element placeholder enthält, können diese Absatzstile vom übergeordneten Element übernommen werden. Welche Absatzstile übernommen werden, hängt von der Verschachtelungsebene der Listen ab:

  • Ein Absatz, der sich nicht in einer Liste befindet, übernimmt seinen Absatzstil vom Absatz auf der Verschachtelungsebene 0 der Liste innerhalb des übergeordneten Platzhalters.
  • Für einen Absatz in einer Liste wird der Absatzstil vom Absatz auf der entsprechenden Verschachtelungsebene der Liste im übergeordneten Platzhalter übernommen.

Übernommene Absatzstile werden in dieser Nachricht als nicht konfigurierte Felder dargestellt.

JSON-Darstellung
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
Felder
lineSpacing

number

Der Abstand zwischen den Zeilen als Prozentsatz des Normalwerts, wobei normal als 100, 0 angegeben wird. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.

indentStart

object (Dimension)

Der Einzug des Absatzes auf der Seite, der dem Textanfang entspricht, basierend auf der aktuellen Textrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Der Einzug des Absatzes auf der Seite, der dem Ende des Textes entspricht, basierend auf der aktuellen Textrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

spaceAbove

object (Dimension)

Der zusätzliche Abstand über dem Absatz Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

spaceBelow

object (Dimension)

Der zusätzliche Abstand unter dem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

indentFirstLine

object (Dimension)

Der Einzug für den Anfang der ersten Zeile des Absatzes. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

direction

enum (TextDirection)

Die Textrichtung dieses Absatzes. Wenn kein Wert festgelegt ist, wird standardmäßig LEFT_TO_RIGHT da die Textrichtung nicht übernommen wird.

spacingMode

enum (SpacingMode)

Der Abstandsmodus für den Absatz.

Ausrichtung

Die Arten der Textausrichtung für einen Absatz.

Enums
ALIGNMENT_UNSPECIFIED Die Absatzausrichtung wird vom übergeordneten Element übernommen.
START Der Absatz ist am Zeilenanfang ausgerichtet. Linksbündig für LTR-Text, ansonsten rechtsbündig.
CENTER Der Absatz wird zentriert.
END Der Absatz ist am Zeilenende ausgerichtet. Rechtsbündig für LTR-Text, andernfalls linksbündig.
JUSTIFIED Der Absatz ist im Blocksatz ausgerichtet.

TextDirection

Der Routentext kann einfließen.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung wird vom übergeordneten Element übernommen.
LEFT_TO_RIGHT Der Text geht von links nach rechts.
RIGHT_TO_LEFT Der Text geht von rechts nach links.

SpacingMode

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstandsmodus wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Der Absatzabstand wird immer gerendert.
COLLAPSE_LISTS Der Absatzabstand wird zwischen den Listenelementen übersprungen.

Aufzählungszeichen

Beschreibt den Aufzählungspunkt in einem Absatz.

JSON-Darstellung
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Felder
listId

string

Die ID der Liste, zu der dieser Absatz gehört.

nestingLevel

integer

Die Verschachtelungsebene dieses Absatzes in der Liste.

glyph

string

Das gerenderte Aufzählungszeichen für diesen Absatz.

bulletStyle

object (TextStyle)

Der absatzspezifische Textstil, der auf diesen Aufzählungspunkt angewendet wird.

TextStyle

Stellt den Stil dar, der auf einen TextRun angewendet werden kann.

Wenn dieser Text in einer Form mit einem übergeordneten Element placeholder gesetzt sind, können diese Textstile vom übergeordneten Element übernommen werden. Welche Textstile übernommen werden, hängt von der Verschachtelungsebene der Listen ab:

  • Ein Text, der in einem Absatz ausgeführt wird, der nicht in einer Liste enthalten ist, übernimmt seinen Textstil vom Zeilenumbruchzeichen im Absatz auf Verschachtelungsebene 0 der Liste innerhalb des übergeordneten Platzhalters.
  • Ein Text, der in einem Absatz läuft, der sich in einer Liste befindet, übernimmt seinen Textstil vom Zeilenumbruchzeichen im Absatz an der entsprechenden Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.

Übernommene Textstile werden in dieser Nachricht als nicht konfigurierte Felder dargestellt. Wenn Text in einer Form ohne einen übergeordneten Platzhalter enthalten ist, wird durch das Deaktivieren dieser Felder der Stil auf einen Wert zurückgesetzt, der den Standardwerten im Präsentationen-Editor entspricht.

JSON-Darstellung
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
Felder
backgroundColor

object (OptionalColor)

Die Hintergrundfarbe des Textes. Wenn festgelegt, ist die Farbe entweder opak oder transparent, je nachdem, opaqueColor festgelegt ist.

foregroundColor

object (OptionalColor)

Die Farbe des Textes selbst. Wenn festgelegt, ist die Farbe entweder opak oder transparent, je nachdem, opaqueColor festgelegt ist.

bold

boolean

Gibt an, ob der Text fett dargestellt wird.

italic

boolean

Gibt an, ob der Text kursiv dargestellt wird.

fontFamily

string

Die Schriftfamilie des Textes.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Menü "Schriftart" in Google Präsentationen oder aus Google Fonts: Wird der Schriftname nicht erkannt, wird der Text in Arial

Einige Schriftarten können die Stärke des Textes beeinflussen. Wenn in einer Aktualisierungsanfrage Werte für sowohl fontFamily und bold, die explizit festgelegte bold -Wert verwendet wird.

fontSize

object (Dimension)

Die Schriftgröße des Textes. Wenn diese gelesen wird, fontSize in Punkten angegeben wird.

baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Textes gegenüber seiner normalen Position.

SMS senden mit SUPERSCRIPT oder SUBSCRIPT Basis-Offsets werden automatisch in einer kleineren Schriftgröße gerendert, fontSize ein. Die fontSize selbst von Änderungen in diesem Feld nicht betroffen ist.

smallCaps

boolean

Gibt an, ob der Text in Kleinbuchstaben geschrieben ist.

strikethrough

boolean

Gibt an, ob der Text durchgestrichen ist.

underline

boolean

Gibt an, ob der Text unterstrichen ist.

weightedFontFamily

object (WeightedFontFamily)

Die Schriftfamilie und die gerenderte Stärke des Textes.

Dieses Feld ist eine Erweiterung von fontFamily die explizite Schriftstärken unterstützen sollen, ohne die Abwärtskompatibilität zu beeinträchtigen. Daher wird beim Lesen des Stils eines Textbereichs der Wert weightedFontFamily#fontFamily immer dem Wert von fontFamily. Wenn jedoch beim Schreiben beide Felder in der Feldmaske enthalten sind (entweder explizit oder über den Platzhalter "*"), werden ihre Werte so abgeglichen:

  • Wenn fontFamily festgelegt ist und weightedFontFamily nicht ist, hat der Wert fontFamily wird mit Gewichtung angewendet. 400 („normal“).
  • Sind beide Felder festgelegt, wird der Wert fontFamily muss mit dem von übereinstimmen weightedFontFamily#fontFamily. Wenn ja, werden die Schriftfamilie und die weightedFontFamily angewendet wird. Andernfalls wird der Fehler „400 Bad Request“ zurückgegeben.
  • Wenn weightedFontFamily festgelegt ist und fontFamily die Schriftfamilie und -stärke weightedFontFamily angewendet wird.
  • Ist keines der beiden Felder festgelegt, werden die Schriftfamilie und die Schriftstärke des Textes vom übergeordneten Feld übernommen. Beachten Sie, dass diese Eigenschaften nicht separat übernommen werden können.

Wenn in einer Aktualisierungsanfrage Werte für sowohl weightedFontFamily und bold, der weightedFontFamily zuerst angewendet, dann bold.

Wenn weightedFontFamily#weight nicht festgelegt ist, wird standardmäßig 400.

Wenn weightedFontFamily festgelegt ist, dann weightedFontFamily#fontFamily muss ebenfalls mit einem nicht leeren Wert festgelegt werden. Andernfalls wird der Fehler „400 Bad Request“ zurückgegeben.

OptionalColor

Eine Farbe, die entweder vollständig deckend oder vollständig transparent sein kann.

JSON-Darstellung
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Felder
opaqueColor

object (OpaqueColor)

Wenn dieser Wert festgelegt ist, wird er als deckende Farbe verwendet. Wenn kein Wert festgelegt ist, stellt dies eine transparente Farbe dar.

BaselineOffset

Die Art und Weise, wie Text vertikal von seiner normalen Position verschoben werden kann.

Enums
BASELINE_OFFSET_UNSPECIFIED Der Basisversatz des Texts wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal verschoben.
SUPERSCRIPT Der Text ist vertikal nach oben verschoben (hochgestellt).
SUBSCRIPT Der Text ist vertikal nach unten verschoben (tiefgestellt).

WeightedFontFamily

Stellt eine Schriftfamilie und -stärke zum Gestalten eines TextRun dar.

JSON-Darstellung
{
  "fontFamily": string,
  "weight": integer
}
Felder
fontFamily

string

Die Schriftfamilie des Textes.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Menü "Schriftart" in Google Präsentationen oder aus Google Fonts: Wird der Schriftname nicht erkannt, wird der Text in Arial

weight

integer

Die gerenderte Stärke des Textes. Dieses Feld kann einen beliebigen Wert enthalten, der ein Vielfaches von ist 100 zwischen 100 und 900 (einschließlich). Dieser Bereich entspricht den numerischen Werten, die in der CSS 2.1-Spezifikation beschrieben sind. Abschnitt 15.6. Nicht numerische Werte sind nicht zulässig. Gewichtungen größer oder gleich 700 werden als fett eingestuft und haben eine Gewichtung von 700 sind nicht fett formatiert. Der Standardwert ist 400 („normal“).

TextRun

Eine TextElement-Art, die einen Lauf darstellt, der alle den gleichen Stil hat.

JSON-Darstellung
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Felder
content

string

Der Text dieser Ausführung.

style

object (TextStyle)

Der Stil, der auf diese Ausführung angewendet wurde.

AutoText

Eine TextElement-Art, die automatisch Text darstellt.

JSON-Darstellung
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Felder
type

enum (Type)

Der Typ dieses automatischen Textes.

content

string

Der gerenderte Inhalt dieses automatischen Texts, falls verfügbar.

style

object (TextStyle)

Der Stil, der auf diesen automatischen Text angewendet wird.

Typ

Die Arten von automatischem Text

Enums
TYPE_UNSPECIFIED Ein nicht angegebener Autotexttyp.
SLIDE_NUMBER Text eingeben, der die aktuelle Foliennummer darstellt.

Liste

Eine Liste beschreibt das Aussehen und Verhalten von Aufzählungspunkten, die zu Absätzen gehören, die mit einer Liste verknüpft sind. Ein Absatz, der Teil einer Liste ist, verweist implizit auf die ID dieser Liste.

JSON-Darstellung
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Felder
listId

string

Die ID der Liste.

nestingLevel

map (key: integer, value: object ( NestingLevel))

Eine Zuordnung der Verschachtelungsebenen zu den Eigenschaften von Aufzählungspunkten auf der zugehörigen Ebene. Eine Liste hat höchstens neun Verschachtelungsebenen. Die möglichen Werte für die Schlüssel dieser Zuordnung sind also 0 bis einschließlich 8.

NestingLevel

Enthält Eigenschaften, die das Aussehen und Verhalten eines Listenpunkts auf einer bestimmten Verschachtelungsebene beschreiben.

JSON-Darstellung
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Felder
bulletStyle

object (TextStyle)

Der Stil eines Aufzählungszeichens bei dieser Verschachtelungsebene.