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 wird in seine Komponenten unterteilt, einschließlich Stilinformationen. Diese Eigenschaft ist schreibgeschützt.

lists

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

Die Aufzählungslisten in diesem Text, sortiert 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.

startIndex und endIndex dieses TextElements geben den Bereich des Absatzes an. Andere Textelemente mit einem Indexbereich, der sich im Bereich dieses Absatzes befindet, gelten als Teil dieses Absatzes. Der Indexbereich zweier separater Absätze überschneidet sich niemals.

textRun

object (TextRun)

Ein Textelement, das einen Textblock darstellt, bei dem alle Zeichen im Block dieselbe TextStyle haben.

Die startIndex und endIndex von TextRuns liegen immer vollständig im Indexbereich einer einzelnen paragraphMarker TextElement zurück. Mit anderen Worten: Ein Textlauf erstreckt sich nie ü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)

Der Stil des Absatzes

bullet

object (Bullet)

Der Aufzählungspunkt für diesen Absatz. Wenn das nicht der Fall ist, gehört der Absatz nicht zu einer Liste.

ParagraphStyle

Stile, die auf einen ganzen Absatz angewendet werden.

Wenn sich dieser Text in einer Form mit einem übergeordneten placeholder befindet, werden diese Absatzstile möglicherweise vom übergeordneten Element übernommen. Welche Absatzstile übernommen werden, hängt von der Verschachtelungsebene der Listen ab:

  • Ein Absatz, der nicht in einer Liste steht, übernimmt den Absatzstil des Absatzes auf der Verschachtelungsebene 0 der Liste im übergeordneten Platzhalter.
  • 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 der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.

indentStart

object (Dimension)

Die Einzugtiefe des Absatzes auf der Seite, die dem Anfang des Texts entspricht, basierend auf der aktuellen Textrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Die Einzugtiefe des Absatzes auf der Seite, die dem Ende des Texts entspricht, basierend auf der aktuellen Textrichtung. Wenn der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

spaceAbove

object (Dimension)

Der zusätzliche Abstand über dem Absatz. Wenn der Wert nicht festgelegt ist, wird er 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 am Anfang der ersten Zeile des Absatzes. Wenn der Wert nicht festgelegt ist, wird er 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 Textausrichtungstypen 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 linksläufigen Text, rechtsbündig andernfalls.
CENTER Der Absatz ist zentriert.
END Der Absatz ist am Zeilenende ausgerichtet. Bei rechtsläufigem Text rechtsbündig, andernfalls linksbündig.
JUSTIFIED Der Absatz ist linksbündig ausgerichtet.

TextDirection

Der Routentext kann einfließen.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung wird vom übergeordneten Element übernommen.
LEFT_TO_RIGHT Der Text wird von links nach rechts gelesen.
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 Absätze werden 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 paraphrasierte Textstil, der auf diese Aufzählung angewendet wird.

TextStyle

Stellt das Styling dar, das auf einen Textlauf 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 in einer Liste ausgeführt wird, ü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 ü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 Texts selbst. Wenn das Feld festgelegt ist, ist die Farbe entweder opak oder transparent, je nachdem, ob das Feld opaqueColor darin 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: Wenn der Schriftartenname nicht erkannt wird, wird der Text in Arial gerendert.

Einige Schriftarten können sich auf die Schriftstärke des Texts auswirken. Wenn in einer Aktualisierungsanfrage Werte für sowohl fontFamily und bold, die explizit festgelegte bold -Wert verwendet.

fontSize

object (Dimension)

Die Schriftgröße des Textes. Beim Lesen wird fontSize in Punkten angegeben.

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

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. Wenn Sie also den Stil eines Textbereichs lesen, ist der Wert von weightedFontFamily#fontFamily immer gleich dem 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. In diesem Fall werden die Schriftfamilie und die Schriftstärke von weightedFontFamily angewendet. Andernfalls wird der Fehler 400 Bad Request zurückgegeben.
  • Wenn weightedFontFamily festgelegt und fontFamily nicht festgelegt ist, werden die Schriftfamilie und das Gewicht von weightedFontFamily angewendet.
  • 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 sowohl für weightedFontFamily als auch für bold angegeben sind, wird zuerst weightedFontFamily und dann bold angewendet.

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

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

OptionalColor

Eine Farbe, die entweder vollständig opak 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 (Hochstellung).
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: Wenn der Schriftartenname nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

Die gerenderte Schriftstärke des Texts. 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 Textblock mit demselben Stil darstellt.

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

string

Der Text dieser Ausführung.

style

object (TextStyle)

Das Styling, das auf diesen Lauf angewendet wird.

AutoText

Eine TextElement-Art, die automatisch Text darstellt.

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

enum (Type)

Die Art 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 von Aufzählungszeichen, 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 von Verschachtelungsebenen zu den Eigenschaften von Aufzählungszeichen auf der entsprechenden Ebene. Eine Liste kann maximal neun Verschachtelungsebenen haben. Die möglichen Werte für die Schlüssel dieser Zuordnung sind also 0 bis 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.