Text

TextContent

Konten teks umum. Teks harus berada dalam bentuk yang kompatibel (misalnya, kotak teks atau persegi panjang) atau sel tabel di halaman.

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

object (TextElement)

Konten teks dibagi menjadi beberapa bagian komponennya, termasuk informasi gaya visual. Properti ini bersifat hanya baca.

lists

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

Daftar berbutir yang dimuat dalam teks ini, dikunci dengan ID daftar.

TextElement

TextElement menjelaskan konten dari rentang indeks dalam konten teks Shape atau TableCell.

Representasi 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.
}
Kolom
startIndex

integer

Indeks awal berbasis nol dari elemen teks ini, dalam unit kode Unicode.

endIndex

integer

Indeks akhir berbasis nol dari elemen teks ini, eksklusif, dalam unit kode Unicode.

Kolom union kind. Jenis teks yang diwakili elemen ini. kind hanya dapat berupa salah satu dari hal berikut:
paragraphMarker

object (ParagraphMarker)

Penanda yang mewakili awal paragraf baru.

Tujuan startIndex dan endIndex TextElement ini mewakili rentang paragraf. TextElements lain dengan rentang indeks yang terdapat dalam rentang paragraf ini dianggap sebagai bagian dari paragraf ini. Rentang indeks dari dua paragraf terpisah tidak akan pernah tumpang tindih.

textRun

object (TextRun)

TextElement yang mewakili rangkaian teks dengan semua karakter dalam run memiliki TextStyle.

Tujuan startIndex dan endIndex TextRuns akan selalu sepenuhnya terkandung dalam rentang indeks dari satu paragraphMarker {i>TextElement<i}. Dengan kata lain, TextRun tidak akan pernah mencakup beberapa paragraf.

autoText

object (AutoText)

TextElement yang mewakili tempat dalam teks yang secara dinamis diganti dengan konten yang dapat berubah dari waktu ke waktu.

ParagraphMarker

Jenis TextElement yang mewakili awal paragraf baru.

Representasi JSON
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Kolom
style

object (ParagraphStyle)

Gaya paragraf

bullet

object (Bullet)

Butir untuk paragraf ini. Jika tidak ada, paragraf tersebut bukan milik daftar.

ParagraphStyle

Gaya yang berlaku untuk seluruh paragraf.

Jika teks ini dimuat dalam bentuk dengan induk placeholder, maka gaya paragraf ini mungkin diwarisi dari induk. Gaya paragraf mana yang diwarisi bergantung pada tingkat hierarki daftar:

  • Paragraf yang tidak ada dalam daftar akan mewarisi gaya paragrafnya dari paragraf di tingkat 0 bertingkat daftar di dalam placeholder induk.
  • Paragraf dalam daftar akan mewarisi gaya paragrafnya dari paragraf pada tingkat susunan yang sesuai dengan daftar di dalam placeholder induk.

Gaya paragraf yang diwariskan ditunjukkan sebagai kolom yang tidak ditetapkan dalam pesan ini.

Representasi 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)
}
Kolom
lineSpacing

number

Jumlah spasi antar-garis, sebagai persentase dari nilai normal, jika normal dinyatakan sebagai 100,0. Jika tidak disetel, nilai akan diwarisi dari induk.

alignment

enum (Alignment)

Perataan teks untuk paragraf ini.

indentStart

object (Dimension)

Indentasi jumlah untuk paragraf di sisi yang sesuai dengan awal teks, berdasarkan arah teks saat ini. Jika tidak disetel, nilai akan diwarisi dari induk.

indentEnd

object (Dimension)

Indentasi jumlah untuk paragraf di sisi yang sesuai dengan akhir teks, berdasarkan arah teks saat ini. Jika tidak disetel, nilai akan diwarisi dari induk.

spaceAbove

object (Dimension)

Jumlah spasi tambahan di atas paragraf. Jika tidak disetel, nilai akan diwarisi dari induk.

spaceBelow

object (Dimension)

Jumlah spasi tambahan di bawah paragraf. Jika tidak disetel, nilai akan diwarisi dari induk.

indentFirstLine

object (Dimension)

Jumlah indentasi untuk awal baris pertama paragraf. Jika tidak disetel, nilai akan diwarisi dari induk.

direction

enum (TextDirection)

Arah teks paragraf ini. Jika tidak disetel, nilai secara default akan LEFT_TO_RIGHT karena arah teks tidak diwariskan.

spacingMode

enum (SpacingMode)

Mode spasi untuk paragraf.

Perataan

Jenis perataan teks untuk paragraf.

Enum
ALIGNMENT_UNSPECIFIED Perataan paragraf diwarisi dari induk.
START Paragraf sejajar dengan bagian awal baris. Rata kiri untuk teks LTR, rata kanan untuk teks LTR.
CENTER Paragraf berada di tengah.
END Paragraf sejajar dengan akhir baris. Rata kanan untuk teks LTR, rata kiri untuk teks LTR.
JUSTIFIED Paragraf dibenarkan.

TextDirection

Teks petunjuk arah bisa mengalir.

Enum
TEXT_DIRECTION_UNSPECIFIED Arah teks diwarisi dari induk.
LEFT_TO_RIGHT Teks ditulis dari kiri ke kanan.
RIGHT_TO_LEFT Teks ditulis dari kanan ke kiri.

SpacingMode

Berbagai mode untuk spasi paragraf.

Enum
SPACING_MODE_UNSPECIFIED Mode spasi diwarisi dari induk.
NEVER_COLLAPSE Spasi paragraf selalu dirender.
COLLAPSE_LISTS Spasi paragraf dilewati di antara elemen daftar.

Butir

Menjelaskan butir dari suatu paragraf.

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

string

ID daftar yang ada di paragraf ini.

nestingLevel

integer

Tingkat bertingkat paragraf ini dalam daftar.

glyph

string

bullet glyph yang dirender untuk paragraf ini.

bulletStyle

object (TextStyle)

Gaya teks khusus paragraf yang diterapkan ke butir ini.

TextStyle

Merepresentasikan gaya yang dapat diterapkan ke TextRun.

Jika teks ini dimuat dalam bentuk dengan induk placeholder, maka gaya teks ini mungkin diwarisi dari induk. Gaya teks mana yang diwarisi bergantung pada tingkat hierarki daftar:

  • Teks yang berjalan dalam paragraf yang tidak ada dalam daftar akan mewarisi gaya teksnya dari karakter baris baru dalam paragraf di tingkat 0 bertingkat daftar di dalam placeholder induk.
  • Teks yang berjalan dalam paragraf yang berada dalam daftar akan mewarisi gaya teksnya dari karakter baris baru dalam paragraf pada tingkat bertingkat yang sesuai dari daftar di dalam placeholder induk.

Gaya teks yang diwarisi ditunjukkan sebagai kolom yang tidak ditetapkan dalam pesan ini. Jika teks dimuat dalam bentuk tanpa placeholder induk, menghapus setelan kolom ini akan mengembalikan gaya ke nilai yang cocok dengan default di editor Slide.

Representasi 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)
  }
}
Kolom
backgroundColor

object (OptionalColor)

Warna latar belakang teks. Jika disetel, warna akan buram atau transparan, tergantung apakah opaqueColor isian di dalamnya sudah diatur.

foregroundColor

object (OptionalColor)

Warna teks itu sendiri. Jika disetel, warna akan buram atau transparan, tergantung apakah opaqueColor isian di dalamnya sudah diatur.

bold

boolean

Apakah teks dirender sebagai tebal atau tidak.

italic

boolean

Apakah teks dicetak miring atau tidak.

fontFamily

string

Jenis font teks.

Jenis font dapat berupa font apa pun dari menu Font di Slide atau dari Google Fonts. Jika nama font tidak dikenal, teks akan dirender dengan Arial.

Beberapa font dapat memengaruhi ketebalan teks. Jika permintaan pembaruan menentukan nilai untuk fontFamily dan bold, yang ditetapkan secara eksplisit bold nilai default yang digunakan.

fontSize

object (Dimension)

Ukuran font teks. Saat dibaca, atribut fontSize akan ditentukan dalam poin.

baselineOffset

enum (BaselineOffset)

Offset vertikal teks dari posisi normalnya.

Kirim pesan teks dengan SUPERSCRIPT atau SUBSCRIPT offset dasar pengukuran otomatis dirender dalam ukuran font yang lebih kecil, dihitung berdasarkan fontSize kolom tersebut. Tujuan fontSize itu sendiri tidak terpengaruh oleh perubahan dalam bidang ini.

smallCaps

boolean

Apakah teks dalam huruf kapital kecil atau tidak.

strikethrough

boolean

Apakah teks dicoret atau tidak.

underline

boolean

Apakah teks digarisbawahi atau tidak.

weightedFontFamily

object (WeightedFontFamily)

Jenis font dan ketebalan teks yang dirender.

Bidang ini merupakan perluasan dari fontFamily dimaksudkan untuk mendukung bobot font eksplisit tanpa memutus kompatibilitas mundur. Dengan demikian, saat membaca gaya suatu rentang teks, nilai weightedFontFamily#fontFamily akan selalu sama dengan fontFamily. Namun, saat menulis, jika kedua kolom disertakan dalam mask kolom (baik secara eksplisit maupun melalui karakter pengganti "*"), nilainya direkonsiliasi sebagai berikut:

  • Jika fontFamily sudah diatur dan weightedFontFamily tidak, nilai fontFamily diterapkan dengan bobot 400 ("normal").
  • Jika kedua isian telah ditetapkan, nilai fontFamily harus sesuai dengan weightedFontFamily#fontFamily. Jika demikian, jenis {i>font<i} dan ketebalan weightedFontFamily akan diterapkan. Jika tidak, error permintaan buruk 400 akan ditampilkan.
  • Jika weightedFontFamily sudah diatur dan fontFamily jenis dan ketebalan {i>font<i} dari weightedFontFamily akan diterapkan.
  • Jika tidak ada kolom yang ditetapkan, jenis font dan ketebalan teks mewarisi dari induknya. Perhatikan bahwa properti ini tidak dapat mewarisi secara terpisah satu sama lain.

Jika permintaan pembaruan menentukan nilai untuk weightedFontFamily dan bold, weightedFontFamily diterapkan terlebih dahulu, lalu bold.

Jika weightedFontFamily#weight tidak disetel, defaultnya adalah 400.

Jika weightedFontFamily sudah diatur, maka weightedFontFamily#fontFamily harus ditetapkan dengan nilai yang tidak kosong. Jika tidak, error permintaan buruk 400 akan ditampilkan.

OptionalColor

Warna yang bisa sepenuhnya buram atau sepenuhnya transparan.

Representasi JSON
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Kolom
opaqueColor

object (OpaqueColor)

Jika disetel, warna ini akan digunakan sebagai warna buram. Jika tidak disetel, warna ini akan mewakili warna transparan.

BaselineOffset

Cara teks dapat di-offset secara vertikal dari posisi normalnya.

Enum
BASELINE_OFFSET_UNSPECIFIED Offset dasar pengukuran teks diwarisi dari induk.
NONE Teks tidak di-offset secara vertikal.
SUPERSCRIPT Teks di-offset secara vertikal ke atas (superskrip).
SUBSCRIPT Teks di-offset secara vertikal ke bawah (subskrip).

WeightedFontFamily

Mewakili jenis dan ketebalan font yang digunakan untuk menata gaya TextRun.

Representasi JSON
{
  "fontFamily": string,
  "weight": integer
}
Kolom
fontFamily

string

Jenis font teks.

Jenis font dapat berupa font apa pun dari menu Font di Slide atau dari Google Fonts. Jika nama font tidak dikenal, teks akan dirender dengan Arial.

weight

integer

Bobot teks yang dirender. Kolom ini dapat memiliki nilai apa pun yang merupakan kelipatan 100 antara 100 dan 900, inklusif. Rentang ini sesuai dengan nilai numerik yang dijelaskan dalam Spesifikasi CSS 2.1, pasal 15.6, dengan nilai non-numerik tidak diizinkan. Bobot yang lebih besar dari atau sama dengan 700 dianggap tebal, dan bobot kurang dari 700 tidak tebal. Nilai defaultnya adalah 400 ("normal").

TextRun

Jenis TextElement yang mewakili rangkaian teks yang semuanya memiliki gaya yang sama.

Representasi JSON
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Kolom
content

string

Teks operasi ini.

style

object (TextStyle)

Gaya yang diterapkan untuk lari ini.

AutoText

Jenis TextElement yang mewakili teks otomatis.

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

enum (Type)

Jenis teks otomatis ini.

content

string

Konten yang dirender dari teks otomatis ini, jika tersedia.

style

object (TextStyle)

Gaya yang diterapkan ke teks otomatis ini.

Jenis

Jenis teks otomatis

Enum
TYPE_UNSPECIFIED Jenis teks otomatis yang tidak ditentukan.
SLIDE_NUMBER Ketik untuk teks otomatis yang mewakili nomor slide saat ini.

Daftar

{i>List <i}mendeskripsikan tampilan dan nuansa poin-poin milik paragraf yang terkait dengan sebuah daftar. Paragraf yang merupakan bagian dari daftar memiliki referensi implisit ke ID daftar tersebut.

Representasi JSON
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Kolom
listId

string

ID daftar.

nestingLevel

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

Peta tingkat bertingkat ke properti butir pada tingkat yang terkait. Sebuah daftar memiliki paling banyak sembilan tingkat bertingkat, sehingga nilai yang mungkin untuk kunci peta ini adalah 0 sampai 8, inklusif.

NestingLevel

Berisi properti yang menjelaskan tampilan dan nuansa poin daftar pada tingkat penyusunan bertingkat tertentu.

Representasi JSON
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Kolom
bulletStyle

object (TextStyle)

Gaya butir pada tingkat penyusunan bertingkat ini.