Text

TextContent

Der allgemeine Textinhalt. Der Text muss sich auf einer Seite in einer kompatiblen Form (z.B. Textfeld oder Rechteck) oder einer Tabellenzelle befinden.

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

object (TextElement)

Die Textinhalte, aufgeschlüsselt in ihre Bestandteile, einschließlich Formatierungsinformationen. Diese Eigenschaft ist schreibgeschützt.

lists

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

Die in diesem Text enthaltenen Aufzählungslisten, die nach Listen-ID sortiert sind.

TextElement

Ein TextElement beschreibt den Inhalt eines Indexbereichs im Textinhalt einer Shape oder 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 (ausschließlich) in Unicode-Codeeinheiten.

Union-Feld kind. Die Art von Text, die dieses Element darstellt. Für kind ist nur einer der folgenden Werte zulässig:
paragraphMarker

object (ParagraphMarker)

Eine Markierung, die den Beginn eines neuen Absatzes darstellt.

Die startIndex und endIndex dieses TextElement stellen den Bereich des Absatzes dar. Andere TextElements mit einem Indexbereich, der im Bereich dieses Absatzes enthalten ist, werden als Teil dieses Absatzes betrachtet. Die Indexbereiche zweier separater Absätze überschneiden sich nie.

textRun

object (TextRun)

Ein TextElement, das einen Textlauf darstellt, in dem alle Zeichen im Lauf dieselbe TextStyle haben.

Die startIndex- und endIndex-Elemente von TextRuns sind immer vollständig im Indexbereich eines einzelnen paragraphMarker-TextElements enthalten. Anders ausgedrückt: Ein TextRun erstreckt sich nie über mehrere Absätze.

autoText

object (AutoText)

Ein TextElement, das eine Stelle im Text darstellt, die dynamisch durch Inhalte ersetzt wird, die sich im Laufe der Zeit ändern können.

ParagraphMarker

Ein TextElement-Typ, der den Beginn eines neuen Absatzes darstellt.

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

object (ParagraphStyle)

Der Stil des Absatzes

bullet

object (Bullet)

Das Aufzählungszeichen für diesen Absatz. Wenn nicht vorhanden, gehört der Absatz nicht zu einer Liste.

ParagraphStyle

Stile, die auf einen ganzen Absatz angewendet werden.

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

  • Ein Absatz, der sich nicht in einer Liste befindet, übernimmt seinen Absatzstil vom Absatz auf der Verschachtelungsebene 0 der Liste im übergeordneten Platzhalter.
  • Ein Absatz in einer Liste erbt seinen Absatzstil vom Absatz auf der entsprechenden Verschachtelungsebene der Liste im übergeordneten Platzhalter.

Geerbte Absatzformatierungen werden in dieser Nachricht als nicht festgelegte 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 Zeilenabstand als Prozentsatz des normalen Abstands.Der normale Abstand wird als 100,0 dargestellt. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.

indentStart

object (Dimension)

Die Einrückung des Absatzes auf der Seite, die dem Beginn des Textes entspricht, basierend auf der aktuellen Textrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Der Einzug des Betrags für den Absatz auf der Seite, die dem Ende des Texts entspricht, basierend auf der aktuellen Textrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

spaceAbove

object (Dimension)

Die Größe des zusätzlichen Abstands über dem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

spaceBelow

object (Dimension)

Die Menge an zusätzlichem Leerraum 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 kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

direction

enum (TextDirection)

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

spacingMode

enum (SpacingMode)

Der Abstandmodus für den Absatz.

Ausrichtung

Die Arten der Textausrichtung für einen Absatz.

Enums
ALIGNMENT_UNSPECIFIED Die Ausrichtung des Absatzes wird vom übergeordneten Element übernommen.
START Der Absatz ist am Anfang der Zeile ausgerichtet. Bei LTR-Text linksbündig, ansonsten rechtsbündig.
CENTER Der Absatz ist zentriert.
END Der Absatz wird am Ende der Zeile ausgerichtet. Bei LTR-Text rechtsbündig, ansonsten linksbündig.
JUSTIFIED Der Absatz ist im Blocksatz formatiert.

TextDirection

Der Text der Wegbeschreibung kann einfließen.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung wird vom übergeordneten Element übernommen.
LEFT_TO_RIGHT Der Text verläuft von links nach rechts.
RIGHT_TO_LEFT Der Text wird von rechts nach links angezeigt.

SpacingMode

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstand wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Absatzabstände werden immer gerendert.
COLLAPSE_LISTS Der Absatzabstand wird zwischen Listenelementen übersprungen.

Aufzählungszeichen

Beschreibt das Aufzählungszeichen eines Absatzes.

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 auf diesen Aufzählungszeichen angewendete Absatzstil.

TextStyle

Stellt das Format dar, das auf einen TextRun angewendet werden kann.

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

  • Ein Textlauf in einem Absatz, der sich nicht in einer Liste befindet, übernimmt seinen Textstil vom Zeilenumbruchzeichen im Absatz auf der Verschachtelungsebene 0 der Liste innerhalb des übergeordneten Platzhalters.
  • Ein Textlauf in einem Absatz, der sich in einer Liste befindet, erbt seinen Textstil vom Zeilenumbruchzeichen im Absatz auf der entsprechenden Verschachtelungsebene der Liste innerhalb des übergeordneten Platzhalters.

Geerbte Textstile werden in dieser Nachricht als nicht festgelegte Felder dargestellt. Wenn Text in einer Form ohne übergeordneten Platzhalter enthalten ist, wird durch das Aufheben der Festlegung dieser Felder der Stil auf einen Wert zurückgesetzt, der den Standardeinstellungen im Google-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 Texts. Wenn sie festgelegt ist, ist die Farbe entweder undurchsichtig oder transparent, je nachdem, ob das Feld opaqueColor darin festgelegt ist.

foregroundColor

object (OptionalColor)

Die Farbe des Textes selbst. Wenn sie festgelegt ist, ist die Farbe entweder undurchsichtig oder transparent, je nachdem, ob das Feld opaqueColor darin festgelegt ist.

bold

boolean

Gibt an, ob der Text fett gerendert wird.

italic

boolean

Gibt an, ob der Text kursiv gerendert wird.

fontFamily

string

Die Schriftfamilie des Texts.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Menü „Schriftart“ in Google Präsentationen oder aus Google Fonts sein. Wenn der Schriftartname nicht erkannt wird, wird der Text in Arial gerendert.

Einige Schriftarten können sich auf die Stärke des Texts auswirken. Wenn in einer Aktualisierungsanfrage Werte für fontFamily und bold angegeben sind, wird der explizit festgelegte Wert für bold verwendet.

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Texts relativ zu seiner Normalposition.

Text mit SUPERSCRIPT- oder SUBSCRIPT-Baseline-Offsets wird automatisch in einer kleineren Schriftgröße gerendert, die auf Grundlage des Felds fontSize berechnet wird. Die fontSize selbst ist von Änderungen in diesem Feld nicht betroffen.

smallCaps

boolean

Gibt an, ob der Text in Kapitälchen gerendert wird.

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 Schriftstärke des Texts.

Dieses Feld ist eine Erweiterung von fontFamily, die explizite Schriftstärken unterstützt, 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 beim Schreiben jedoch 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, wird der Wert von fontFamily mit dem Gewicht 400 („normal“) angewendet.
  • Wenn beide Felder festgelegt sind, muss der Wert von fontFamily mit dem von weightedFontFamily#fontFamily übereinstimmen. Wenn ja, werden die Schriftfamilie und die Schriftstärke von weightedFontFamily angewendet. Andernfalls wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
  • Wenn weightedFontFamily festgelegt ist und fontFamily nicht, werden die Schriftfamilie und die Schriftstärke von weightedFontFamily angewendet.
  • Wenn keines der beiden Felder festgelegt ist, werden Schriftfamilie und Schriftstärke des Texts vom übergeordneten Element übernommen. Diese Eigenschaften können nicht separat voneinander übernommen werden.

Wenn in einer Aktualisierungsanfrage Werte für weightedFontFamily und 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, muss auch weightedFontFamily#fontFamily mit einem nicht leeren Wert festgelegt werden. Andernfalls wird der Fehler „400 Falsche Anfrage“ 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 festgelegt, wird diese als undurchsichtige Farbe verwendet. Wenn kein Wert festgelegt ist, wird eine transparente Farbe verwendet.

BaselineOffset

Die Möglichkeiten, wie Text vertikal von seiner Normalposition versetzt werden kann.

Enums
BASELINE_OFFSET_UNSPECIFIED Der Baseline-Offset des Texts wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal versetzt.
SUPERSCRIPT Der Text wird vertikal nach oben versetzt (hochgestellt).
SUBSCRIPT Der Text ist vertikal nach unten versetzt (Tiefstellung).

WeightedFontFamily

Stellt eine Schriftfamilie und ‑stärke dar, die zum Formatieren eines TextRun verwendet wird.

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

string

Die Schriftfamilie des Texts.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Menü „Schriftart“ in Google Präsentationen oder aus Google Fonts sein. Wenn der Schriftartname nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

Die gerenderte Schriftstärke des Texts. Dieses Feld kann einen beliebigen Wert haben, der ein Vielfaches von 100 zwischen 100 und 900 (einschließlich) ist. Dieser Bereich entspricht den numerischen Werten in der Spezifikation CSS 2.1, Abschnitt 15.6. Die dort genannten nicht numerischen Werte sind jedoch unzulässig. Schriftstärken größer oder gleich 700 gelten als fett, Schriftstärken kleiner als 700 nicht. Der Standardwert ist 400 („normal“).

TextRun

Ein TextElement-Typ, der einen Textblock mit demselben Stil darstellt.

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

string

Der Text dieses Laufs.

style

object (TextStyle)

Die auf diesen Lauf angewendete Formatierung.

AutoText

Ein TextElement-Typ, der automatischen Text darstellt.

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

enum (Type)

Der Typ dieses Autotexts.

content

string

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

style

object (TextStyle)

Die Formatierung, die auf diesen Autotext angewendet wird.

Typ

Arten von AutoText

Enums
TYPE_UNSPECIFIED Ein nicht angegebener Autotext-Typ.
SLIDE_NUMBER Geben Sie den Autotext ein, der die aktuelle Foliennummer darstellt.

Liste

Eine Liste beschreibt das Erscheinungsbild von Aufzählungszeichen, die zu Absätzen gehören, die mit einer Liste verknüpft sind. Ein Absatz, der Teil einer Liste ist, hat einen impliziten Verweis 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 zugehörigen Ebene. Eine Liste hat maximal neun Verschachtelungsebenen. Die möglichen Werte für die Schlüssel dieser Map sind also 0 bis einschließlich 8.

NestingLevel

Enthält Eigenschaften, die das Erscheinungsbild eines Listenzeichens auf einer bestimmten Verschachtelungsebene beschreiben.

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

object (TextStyle)

Der Stil eines Aufzählungszeichens auf dieser Verschachtelungsebene.