Text

TextContent

Ogólna zawartość tekstowa. Tekst musi mieć zgodny kształt (np. pole tekstowe lub prostokąt) lub komórkę tabeli na stronie.

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

object (TextElement)

Zawartość tekstu 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))

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 tekstowego liczony od zera w jednostkach kodu Unicode.

endIndex

integer

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

Pole sumy kind Rodzaj tekstu, który reprezentuje ten element. kind może być tylko jednym z tych elementów:
paragraphMarker

object (ParagraphMarker)

Znacznik reprezentujący początek nowego akapitu.

startIndex oraz 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. Zakresy indeksów dwóch osobnych akapitów nigdy się nie nakładają.

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ędzie zawsze w pełni zawartych w zakresie indeksu pojedynczego paragraphMarker TextElement. Inaczej mówiąc, tekst 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

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)

Punktor tego akapitu. Jeśli akapit nie istnieje, oznacza to, że nie należy do listy.

ParagraphStyle

Style stosowane do całego akapitu.

Jeśli ten tekst jest zawarty w kształcie z elementem nadrzędnym placeholder, styl akapitu może być dziedziczony z elementu nadrzędnego. To, które style akapitu są dziedziczone, zależy od poziomu zagnieżdżenia list:

  • Akapit, którego nie ma na liście, odziedziczy styl z akapitu na poziomie zagnieżdżenia na liście wewnątrz nadrzędnego obiektu zastępczego.
  • Akapit na liście odziedziczy styl z akapitu na odpowiednim poziomie zagnieżdżenia listy w nadrzędnym obiekcie zastępczym.

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 wierszami wyrażony jako procent normalnej wartości, gdzie norma jest przedstawiona jako 100, 0. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

alignment

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

indentStart

object (Dimension)

Wielkość wcięcia akapitu z boku, która odpowiada początkowi tekstu, zależnie od aktualnego kierunku tekstu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentEnd

object (Dimension)

Wielkość wcięcia akapitu z boku, która odpowiada jego końcu, zależnie od aktualnego kierunku tekstu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona 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 zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

Kierunek tekstu w tym akapicie. Jeśli nie jest skonfigurowana, domyślna wartość 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 dziedziczone z elementu nadrzędnego.
START Akapit jest wyrównany do początku wiersza. Wyrównanie do lewej w przypadku tekstu LTR, 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 LTR, w przeciwnym razie wyrównanie do lewej.
JUSTIFIED Akapit jest uzasadniony.

TextDirection

Mogą pojawiać się teksty wskazówek.

Wartości w polu enum
TEXT_DIRECTION_UNSPECIFIED Kierunek tekstu jest przejmowany z elementu nadrzędnego.
LEFT_TO_RIGHT Tekst będzie przesuwany od lewej do prawej.
RIGHT_TO_LEFT Tekst będzie przesuwany 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.

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 TextRun.

Jeśli ten tekst jest zawarty w kształcie z elementem nadrzędnym placeholder, to 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:

  • Tekst uruchomiony w akapicie, którego nie ma na liście, odziedziczy styl ze znaku nowego wiersza w akapicie na poziomie zagnieżdżenia 0 listy wewnątrz obiektu zastępczego nadrzędnego.
  • Tekst uruchomiony w akapicie znajdującym się na liście odziedziczy styl tekstu ze znaku nowego wiersza w akapicie na odpowiednim poziomie zagnieżdżenia listy wewnątrz obiektu zastępczego nadrzędnego.

Odziedziczone style tekstu są w tej wiadomości reprezentowane jako pola nieskonfigurowane. 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 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

Wskazuje, czy tekst jest pisany 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. Podczas czytania fontSize określone w punktach.

baselineOffset

enum (BaselineOffset)

Przesunięcie tekstu w pionie względem jego normalnej pozycji.

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

smallCaps

boolean

Określa, czy tekst został 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 fontFamily z myślą o obsłudze wyraźnych rozmiarów czcionek bez naruszania zgodności wstecznej. Dlatego przy odczytywaniu stylu zakresu tekstu wartość weightedFontFamily#fontFamily będzie zawsze równa 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 fontFamily jest ustawiona i weightedFontFamily nie, wartość fontFamily jest stosowany razem z wagą 400 („normalne”).
  • Jeśli oba pola są ustawione, wartość fontFamily musi być taki sam jak wartość z weightedFontFamily#fontFamily Jeśli tak, rodzina i grubość czcionki weightedFontFamily W przeciwnym razie zwracany jest błąd 400 nieprawidłowego żądania.
  • 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 określa wartości dla obu weightedFontFamily oraz bold, weightedFontFamily jest stosowany jako pierwszy, bold

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

Jeśli weightedFontFamily jest ustawiona, a następnie weightedFontFamily#fontFamily również musi zawierać wartość, która nie jest pusta. W przeciwnym razie zwracany jest błąd 400 nieprawidłowego żądania.

OptionalColor

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

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

object (OpaqueColor)

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

BaselineOffset

Możliwości odsunięcia tekstu w pionie od jego normalnego położenia.

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 pionowo w dół (indeks dolny).

WeightedFontFamily

Reprezentuje rodzinę i grubość czcionek używane do określania stylu 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 Czcionki Google. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst zostanie wyświetlony w Arial

weight

integer

Wyrenderowana waga tekstu. To pole może zawierać dowolną wartość, która jest wielokrotnością 100 pomiędzy 100 oraz 900 włącznie. Zakres ten odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1, sekcja 15.6 z niedozwolonymi wartościami nieliczbowymi. Waga większa lub równa 700 są uznawane za pogrubione i ważą mniej niż 700 nie są pogrubione. Wartość domyślna to 400 („normalne”).

TextRun

Rodzaj TextElement, który reprezentuje cały tekst o takim samym stylu.

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

string

Tekst tego uruchomienia.

style

object (TextStyle)

Styl zastosowany do tego uruchomienia.

AutoText

Rodzaj TextElement, który reprezentuje tekst automatyczny.

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

enum (Type)

Typ tego automatycznego tekstu.

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 opisuje wygląd i styl punktorów 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))

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

NestingLevel

Zawiera właściwości opisujące wygląd i sposób działania punktu listy na danym poziomie zagnieżdżenia.

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

object (TextStyle)

Styl punktu na tym poziomie zagnieżdżania.