Text

TextContent

ogólna treść tekstowa; Tekst musi znajdować się w kształcie zgodnym z formatem (np. pole tekstowe lub prostokąt) lub w komórce tabeli na stronie.

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

object (TextElement)

Treści tekstowe podzielone na elementy, w tym informacje o stylach. Ta usługa jest tylko do odczytu.

lists

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

Lista punktowana zawarte w tym tekście z kluczem według identyfikatora listy.

TextElement

Element TextElement opisuje zawartość zakresu indeksów w treści tekstowej obiektów 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 tekstu (liczony od 0) w jednostkach kodu Unicode.

endIndex

integer

Indeks końcowy liczony od zera dla tego elementu tekstowego, wyłącznie w jednostkach kodu Unicode.

Pole uniikind. Rodzaj tekstu reprezentowanego przez ten element. kind może być tylko jednym z tych elementów:
paragraphMarker

object (ParagraphMarker)

Znacznik reprezentujący początek nowego akapitu.

Parametry startIndex i endIndex tego elementu TextElement reprezentują zakres akapitu. Inne elementy TextElements z zakresem indeksu mieszczącym się w zakresie tego akapitu są uznawane za część tego akapitu. Zakres indeksów 2 oddzielnych akapitów nigdy się nie pokryje.

textRun

object (TextRun)

Element TextElement reprezentujący ciąg tekstowy, w którym wszystkie znaki w uruchomieniu są takie same TextStyle

startIndex oraz endIndex będą zawsze w pełni zawarte w zakresie indeksu pojedynczego paragraphMarker TextElement. Inaczej mówiąc, tekst TextRun nigdy nie obejmuje wielu akapitów.

autoText

object (AutoText)

Element tekstowy 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

Rodzaj 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)

Punkt w tym akapicie. Jeśli nie ma go na liście, akapit nie należy do listy.

ParagraphStyle

Style, które dotyczą całego akapitu.

Jeśli tekst jest zawarty w kształcie z elementem nadrzędnymplaceholder, te style akapitu mogą być dziedziczone z elementu nadrzędnego. Które style akapitów są dziedziczone, zależy od poziomu zagnieżdżenia list:

  • Akapit, który nie znajduje się na liście, odziedziczy styl akapitu od akapitu na poziomie zagnieżdżenia 0 listy w elementach zastępczych nadrzędnych.
  • Akapit na liście odziedziczy styl akapitu od akapitu na odpowiednim poziomie zagnieżżenia listy w miejscu zastępczym nadrzędnego.

W tej wiadomości dziedziczone style akapitu są reprezentowane jako nieskonfigurowane 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

Odstęp między liniami wyrażony jako odsetek wartości normalnej, gdzie wartość normalna to 100,0. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

alignment

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

indentStart

object (Dimension)

Odstęp akapitowy po stronie odpowiadającej początkowi tekstu, na podstawie bieżącego kierunku tekstu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentEnd

object (Dimension)

Odstęp akapitowy po stronie odpowiadającej końcowi tekstu, na podstawie bieżącego kierunku tekstu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

spaceAbove

object (Dimension)

Ilość dodatkowego miejsca nad akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

Ilość dodatkowego miejsca pod akapitem. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

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

spacingMode

enum (SpacingMode)

Tryb odstępów w akapicie.

Wyrównanie

Typy wyrównania tekstu w akapicie.

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

TextDirection

Tekst z instrukcjami może się wyświetlać.

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 będzie przesuwany od prawej do lewej.

SpacingMode

Różne tryby interliniowania akapitów.

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

Punktor

Opisuje punkt 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 znak strzałki w przypadku tego akapitu.

bulletStyle

object (TextStyle)

Styl tekstu akapitu zastosowany do tego punktu.

TextStyle

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

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

  • Fragment tekstu w akapicie, który nie znajduje się na liście, odziedziczy styl tekstu od znaku nowego wiersza w akapicie na poziomie zagnieżdżenia 0 listy w umieszczonym w niej miejscu docelowym nadrzędnym.
  • Fragment tekstu w akapitach na liście odziedziczy styl tekstu od znaku nowego wiersza w akapicie na odpowiednim poziomie zagnieżdżania listy w nadrzędnym miejscu docelowym.

Styl tekstu dziedziczonego jest w tym komunikacie reprezentowany jako niezaznaczone pola. Jeśli tekst znajduje się w kształcie bez nadrzędnego obiektu zastępczego, usunięcie ustawienia tych pól spowoduje przywrócenie stylu do wartości zgodnej z wartościami domyślnymi 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. Ustawiony kolor jest nieprzezroczysty lub przezroczysty w zależności od tego, czy opaqueColor .

foregroundColor

object (OptionalColor)

Kolor samego tekstu. Ustawiony kolor jest nieprzezroczysty lub przezroczysty w zależności od tego, czy opaqueColor .

bold

boolean

Określa, czy tekst ma być pogrubiony.

italic

boolean

Określa, czy tekst jest kursywą.

fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolną czcionką z menu Czcionka w Prezentacjach lub Czcionki Google. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst zostanie wyświetlony w Arial

Niektóre czcionki mogą wpływać na grubość tekstu. Jeśli żądanie aktualizacji określa wartości dla obu fontFamily oraz bold, określony przez Ciebie parametr bold .

fontSize

object (Dimension)

Rozmiar czcionki tekstu. Po przeczytaniu fontSize zostanie określony w punktach.

baselineOffset

enum (BaselineOffset)

Pionowe przesunięcie tekstu od jego normalnej pozycji.

Wyślij SMS-a: SUPERSCRIPT lub SUBSCRIPT jest automatycznie renderowany z mniejszą czcionką. Wartość jest obliczana na podstawie fontSize . Zmiany w tym polu nie mają wpływu na fontSize.

smallCaps

boolean

czy tekst jest zapisany małymi literami.

strikethrough

boolean

Określa, 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 pola fontFamily, które służy do obsługi wyraźnych grubości czcionek bez zakłócania zgodności wstecznej. Dlatego podczas odczytu stylu zakresu tekstu wartość weightedFontFamily#fontFamily będzie zawsze równa wartości fontFamily. Jednak podczas zapisywania, jeśli oba pola są uwzględnione w masce pola (wyraźnie lub za pomocą symbolu wieloznacznego "*"), ich wartości są uzgadniane w ten sposób:

  • Jeśli parametr fontFamily jest ustawiony, a parametr weightedFontFamily nie jest, wartość parametru fontFamily jest stosowana z wagą 400 („normalna”).
  • Jeśli oba pola są ustawione, wartość w polu fontFamily musi być taka sama jak w polu weightedFontFamily#fontFamily. Jeśli tak, zastosowana zostanie rodzina czcionek i grubość weightedFontFamily. W przeciwnym razie zwracany jest błąd 400 „Nieprawidłowe żądanie”.
  • Jeśli weightedFontFamily jest ustawiona i fontFamily nie, rodzina czcionek i grubość weightedFontFamily
  • Jeśli nie ustawisz żadnego z tych pól, rodzina czcionek i grubość tekstu będą dziedziczone z elementu nadrzędnego. Pamiętaj, że nie mogą się one dziedziczyć oddzielnie od siebie.

Jeśli żądanie aktualizacji zawiera wartości zarówno dla parametru weightedFontFamily, jak i bold, najpierw zostanie zastosowana wartość parametru weightedFontFamily, a następnie bold.

Jeśli weightedFontFamily#weight nie jest ustawiona. Domyślna wartość to 400

Jeśli parametr weightedFontFamily jest ustawiony, parametr weightedFontFamily#fontFamily musi mieć też niepustą wartość. W przeciwnym razie zwracany jest błąd 400 „Nieprawidłowe żądanie”.

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

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

Wartości w polu enum
BASELINE_OFFSET_UNSPECIFIED Przesunięcie punktu odniesienia dla tekstu jest dziedziczone z elementu nadrzędnego.
NONE Tekst nie jest przesunięty w pionie.
SUPERSCRIPT Tekst jest przesunięty w pionie w górę (indeks górny).
SUBSCRIPT Tekst jest przesunięty w dół (pod indeksem).

WeightedFontFamily

Reprezentuje rodzinę i grubość czcionki użyte do nadania stylu tekstowi.

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 Czcionki Google. Jeśli nazwa czcionki nie jest rozpoznawana, tekst jest renderowany w fontach Arial.

weight

integer

Wyrenderowana waga tekstu. To pole może zawierać dowolną wartość będącą wielokrotnością parametru 100 w zakresie od 100 do 900 włącznie. Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1, sekcja 15.6, z niedozwolonymi wartościami niebędącymi liczbami. Waga większa lub równa 700 są uznawane za pogrubione i ważą mniej niż 700 nie są pogrubione. Wartością domyślną jest 400 ("normal").

TextRun

Element typu 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)

Stylizacja zastosowana w tym przebiegu.

AutoText

Typ elementu TextElement, który reprezentuje tekst automatyczny.

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

enum (Type)

Typ tekstu automatycznego.

content

string

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

style

object (TextStyle)

Styl zastosowany do tego tekstu automatycznego.

Typ

Rodzaje tekstu automatycznego

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ tekstu autotekstu.
SLIDE_NUMBER Wpisz tekst autotekstu reprezentujący bieżący numer slajdu.

Lista

Lista określa wygląd i wygląd symboli wypunktowania należących do akapitów powiązanych z listą. Akapit, który jest częścią listy, zawiera niejawne odniesienie do identyfikatora tej listy.

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

string

Identyfikator listy.

nestingLevel

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

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

NestingLevel

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

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

object (TextStyle)

Styl punktu na tym poziomie zagnieżdżenia.