Text

TextContent

Ogólna treść tekstowa. Tekst musi znajdować się w kompatybilnym kształcie (np. w polu tekstowym lub prostokącie) albo w komórce tabeli na stronie.

Zapis JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Pola
textElements[]

object (TextElement)

Treść tekstowa podzielona na części składowe, w tym informacje o stylu. Ta właściwość jest tylko do odczytu.

lists

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

Listy punktowane zawarte w tym tekście, z kluczem w postaci identyfikatora listy.

TextElement

Element TextElement opisuje zawartość zakresu indeksów w treści tekstowej obiektu Shape lub TableCell.

Zapis JSON 
{
  "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.
}
Pola
startIndex

integer

Indeks początkowy tego elementu tekstowego (liczony od zera) w jednostkach kodu Unicode.

endIndex

integer

Indeks końcowy tego elementu tekstowego liczony od zera, z wyłączeniem jednostek kodu Unicode.

Pole zbiorczekind. Rodzaj tekstu, który reprezentuje ten element. kind może mieć tylko jedną z tych wartości:
paragraphMarker

object (ParagraphMarker)

Znacznik oznaczający początek nowego akapitu.

Znaki startIndex i endIndex w tym elemencie TextElement reprezentują zakres akapitu. Inne elementy TextElement z zakresem indeksu zawartym w zakresie tego akapitu są uważane za jego część. Zakresy indeksów dwóch oddzielnych akapitów nigdy się nie pokrywają.

textRun

object (TextRun)

Obiekt TextElement reprezentujący ciąg tekstu, w którym wszystkie znaki mają ten sam atrybut TextStyle.

Wartości startIndex i endIndex obiektów TextRun zawsze będą w pełni mieścić się w zakresie indeksu pojedynczego elementu paragraphMarker TextElement. Inaczej mówiąc, element TextRun nigdy nie obejmuje wielu akapitów.

autoText

object (AutoText)

Element TextElement reprezentujący miejsce w tekście, które jest dynamicznie zastępowane treścią, która może się zmieniać z upływem czasu.

ParagraphMarker

Typ TextElement, który reprezentuje początek nowego akapitu.

Zapis JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Pola
style

object (ParagraphStyle)

Styl akapitu

bullet

object (Bullet)

Punktor tego akapitu. Jeśli nie jest obecny, akapit nie należy do listy.

ParagraphStyle

Style, które mają zastosowanie do całego akapitu.

Jeśli ten tekst znajduje się w kształcie z elementem nadrzędnym placeholder, te style akapitu mogą być dziedziczone z elementu nadrzędnego. Style akapitów, które są dziedziczone, zależą od poziomu zagnieżdżenia list:

  • Akapit, który nie znajduje się na liście, dziedziczy styl akapitu z poziomu zagnieżdżenia 0 listy wewnątrz nadrzędnego elementu zastępczego.
  • Akapit na liście dziedziczy styl akapitu z akapitu na odpowiednim poziomie zagnieżdżenia listy wewnątrz elementu zastępczego nadrzędnego.

Dziedziczone style akapitu są w tej wiadomości reprezentowane jako nieustawione pola.

Zapis JSON 
{
  "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)
}
Pola
lineSpacing

number

Wielkość odstępu między wierszami jako odsetek normalnego odstępu, gdzie normalny odstęp jest reprezentowany jako 100, 0. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

alignment

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

indentStart

object (Dimension)

Wielkość wcięcia akapitu po stronie odpowiadającej początkowi tekstu, na podstawie bieżącego kierunku tekstu. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

indentEnd

object (Dimension)

Wcięcie akapitu po stronie odpowiadającej końcowi tekstu, w zależności od bieżącego kierunku tekstu. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

spaceAbove

object (Dimension)

Wielkość dodatkowego odstępu nad akapitem. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

Wielkość dodatkowego odstępu pod akapitem. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

indentFirstLine

object (Dimension)

Wielkość wcięcia na początku pierwszego wiersza akapitu. Jeśli nie zostanie ustawiona, wartość jest dziedziczona z elementu nadrzędnego.

direction

enum (TextDirection)

Kierunek tekstu w tym akapicie. Jeśli nie zostanie ustawiona, domyślnie przyjmuje wartość LEFT_TO_RIGHT, ponieważ kierunek tekstu nie jest dziedziczony.

spacingMode

enum (SpacingMode)

Tryb odstępów w akapicie.

Wyrównanie

Rodzaje wyrównania tekstu w akapicie.

Wartości w polu enum
ALIGNMENT_UNSPECIFIED Wyrównanie akapitu jest dziedziczone z elementu nadrzędnego.
START Akapit jest wyrównany do początku wiersza. Wyrównanie do lewej w przypadku tekstu od lewej do prawej, w przeciwnym razie wyrównanie do prawej.
CENTER Akapit jest wyśrodkowany.
END Akapit jest wyrównany do końca wiersza. Wyrównanie do prawej w przypadku tekstu od lewej do prawej, w przeciwnym razie wyrównanie do lewej.
JUSTIFIED Akapit jest wyjustowany.

TextDirection

Tekst wskazówek może się pojawiać.

Wartości w polu enum
TEXT_DIRECTION_UNSPECIFIED Kierunek tekstu jest dziedziczony z elementu nadrzędnego.
LEFT_TO_RIGHT Tekst jest wyświetlany od lewej do prawej.
RIGHT_TO_LEFT Tekst jest wyświetlany od prawej do lewej.

SpacingMode

Różne tryby odstępów między akapitami.

Wartości w polu enum
SPACING_MODE_UNSPECIFIED Tryb odstępów jest dziedziczony z elementu nadrzędnego.
NEVER_COLLAPSE Odstępy między akapitami są zawsze renderowane.
COLLAPSE_LISTS Odstępy między akapitami są pomijane między elementami listy.

Punktor

Opisuje punktor akapitu.

Zapis JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Pola
listId

string

Identyfikator listy, do której należy ten akapit.

nestingLevel

integer

Poziom zagnieżdżenia tego akapitu na liście.

glyph

string

Wyrenderowany glif punktora dla tego akapitu.

bulletStyle

object (TextStyle)

Styl tekstu akapitu zastosowany do tego punktu.

TextStyle

Reprezentuje styl, który można zastosować do elementu TextRun.

Jeśli ten tekst znajduje się w kształcie z elementem nadrzędnym placeholder, te style tekstu mogą być dziedziczone z elementu nadrzędnego. Style tekstu, które są dziedziczone, zależą od poziomu zagnieżdżenia list:

  • Fragment tekstu w akapicie, który nie znajduje się na liście, dziedziczy styl tekstu ze znaku nowego wiersza w akapicie na poziomie zagnieżdżenia 0 listy wewnątrz nadrzędnego symbolu zastępczego.
  • Fragment tekstu w akapicie na liście odziedziczy styl tekstu ze znaku nowego wiersza w akapicie na odpowiednim poziomie zagnieżdżenia listy wewnątrz nadrzędnego symbolu zastępczego.

Dziedziczone style tekstu są w tej wiadomości reprezentowane jako nieustawione pola. Jeśli tekst znajduje się w kształcie bez nadrzędnego symbolu zastępczego, wyłączenie tych pól przywróci styl do wartości domyślnych w edytorze Prezentacji.

Zapis JSON 
{
  "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)
  }
}
Pola
backgroundColor

object (OptionalColor)

Kolor tła tekstu. Jeśli jest ustawiony, kolor jest nieprzezroczysty lub przezroczysty w zależności od tego, czy pole opaqueColor jest ustawione.

foregroundColor

object (OptionalColor)

Kolor samego tekstu. Jeśli jest ustawiony, kolor jest nieprzezroczysty lub przezroczysty w zależności od tego, czy pole opaqueColor jest ustawione.

bold

boolean

Określa, czy tekst jest renderowany jako pogrubiony.

italic

boolean

Określa, czy tekst jest zapisany kursywą.

fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolną czcionką z menu Czcionka w Prezentacjach lub z Google Fonts. Jeśli nazwa czcionki jest nierozpoznana, tekst jest renderowany w czcionce Arial.

Niektóre czcionki mogą wpływać na grubość tekstu. Jeśli żądanie aktualizacji określa wartości zarówno dla fontFamily, jak i bold, używana jest wartość bold ustawiona jawnie.

fontSize

object (Dimension)

Rozmiar czcionki tekstu. Po odczytaniu wartość fontSize zostanie określona w punktach.

baselineOffset

enum (BaselineOffset)

Pionowe przesunięcie tekstu względem jego normalnej pozycji.

Tekst z przesunięciem linii bazowej SUPERSCRIPT lub SUBSCRIPT jest automatycznie renderowany mniejszą czcionką, obliczaną na podstawie pola fontSize. Na samą wartość fontSize nie mają wpływu zmiany w tym polu.

smallCaps

boolean

Określa, czy tekst jest pisany kapitalikami.

strikethrough

boolean

Wskazuje, czy tekst jest przekreślony.

underline

boolean

Określa, czy tekst jest podkreślony.

weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i wyrenderowana grubość tekstu.

To pole jest rozszerzeniem fontFamily, które ma obsługiwać wyraźne grubości czcionek bez naruszania zgodności wstecznej. Dlatego podczas odczytywania stylu zakresu tekstu wartość weightedFontFamily#fontFamily zawsze będzie równa wartości fontFamily. Jeśli jednak podczas pisania oba pola są uwzględnione w masce pola (jawnie lub za pomocą symbolu wieloznacznego "*"), ich wartości są uzgadniane w ten sposób:

  • Jeśli ustawisz parametr fontFamily, a nie ustawisz parametru weightedFontFamily, wartość parametru fontFamily zostanie zastosowana z wagą 400 („normal”).
  • Jeśli oba pola są ustawione, wartość pola fontFamily musi być zgodna z wartością pola weightedFontFamily#fontFamily. W takim przypadku stosowana jest rodzina czcionek i grubość weightedFontFamily. W przeciwnym razie zwracany jest błąd 400 (Nieprawidłowe żądanie).
  • Jeśli zasada weightedFontFamily jest skonfigurowana, a zasada fontFamily nie, stosowana jest rodzina i grubość czcionki weightedFontFamily.
  • Jeśli żadne z tych pól nie jest ustawione, rodzina i grubość czcionki tekstu są dziedziczone z elementu nadrzędnego. Pamiętaj, że te właściwości nie mogą dziedziczyć osobno.

Jeśli w żądaniu aktualizacji podasz wartości zarówno dla parametru weightedFontFamily, jak i bold, najpierw zostanie zastosowany parametr weightedFontFamily, a potem bold.

Jeśli nie ustawisz wartości weightedFontFamily#weight, domyślnie będzie używana wartość 400.

Jeśli ustawiona jest wartość weightedFontFamily , musi być też ustawiona wartość weightedFontFamily#fontFamily , która nie jest pusta. W przeciwnym razie zwracany jest błąd 400 (Nieprawidłowe żądanie).

OptionalColor

Kolor, który może być całkowicie nieprzezroczysty lub całkowicie przezroczysty.

Zapis JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Pola
opaqueColor

object (OpaqueColor)

Jeśli jest ustawiony, będzie używany jako kolor nieprzezroczysty. Jeśli nie jest ustawiony, oznacza kolor przezroczysty.

BaselineOffset

Sposoby, w jakie tekst może być przesunięty w pionie względem normalnej pozycji.

Wartości w polu enum
BASELINE_OFFSET_UNSPECIFIED Przesunięcie linii bazowej tekstu jest dziedziczone z elementu nadrzędnego.
NONE Tekst nie jest przesunięty w pionie.
SUPERSCRIPT Tekst jest przesunięty w pionie do góry (indeks górny).
SUBSCRIPT Tekst jest przesunięty w pionie w dół (indeks dolny).

WeightedFontFamily

Reprezentuje rodzinę i grubość czcionki używane do stylizowania elementu TextRun.

Zapis JSON 
{
  "fontFamily": string,
  "weight": integer
}
Pola
fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolną czcionką z menu Czcionka w Prezentacjach lub z Google Fonts. Jeśli nazwa czcionki jest nierozpoznana, tekst jest renderowany w czcionce Arial.

weight

integer

Wyrenderowana grubość tekstu. To pole może mieć dowolną wartość, która jest wielokrotnością 100 z przedziału od 100 do 900 włącznie. Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1, sekcja 15.6. Wartości nieliczbowe są niedozwolone. Wagi większe lub równe 700 są uznawane za pogrubione, a wagi mniejsze niż 700 nie są pogrubione. Wartością domyślną jest 400 („normal”).

TextRun

Rodzaj TextElement, który reprezentuje ciąg tekstu o tym samym stylu.

Zapis JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Pola
content

string

Tekst tego uruchomienia.

style

object (TextStyle)

Styl zastosowany do tego fragmentu.

AutoText

Typ TextElement reprezentujący tekst automatyczny.

Zapis JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Pola
type

enum (Type)

Typ tego tekstu automatycznego.

content

string

Wyrenderowana treść tego tekstu automatycznego, jeśli jest dostępna.

style

object (TextStyle)

Styl zastosowany do tego tekstu automatycznego.

Typ

Rodzaje automatycznego tekstu

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ autotekstu.
SLIDE_NUMBER Wpisz tekst automatyczny, który reprezentuje numer bieżącego slajdu.

Lista

Lista opisuje wygląd punktorów należących do akapitów powiązanych z listą. Akapit, który jest częścią listy, ma niejawne odwołanie do identyfikatora tej listy.

Zapis JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Pola
listId

string

Identyfikator listy.

nestingLevel

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

Mapa poziomów zagnieżdżenia do właściwości punktów na powiązanym poziomie. Lista może mieć maksymalnie 9 poziomów zagnieżdżenia, więc możliwe wartości kluczy tej mapy to od 0 do 8 włącznie.

NestingLevel

Zawiera właściwości opisujące wygląd punktora listy na danym poziomie zagnieżdżenia.

Zapis JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Pola
bulletStyle

object (TextStyle)

Styl punktora na tym poziomie zagnieżdżenia.