Text

TextContent

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

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

object (TextElement)

Isi teks dipecah menjadi bagian-bagian komponennya, termasuk informasi gaya. Properti ini bersifat hanya baca.

lists

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

Daftar berbutir yang ada dalam teks ini, yang dikelompokkan berdasarkan ID daftar.

TextElement

TextElement menjelaskan konten 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 gabungan kind. Jenis teks yang diwakili oleh elemen ini. kind hanya dapat berupa salah satu dari berikut:
paragraphMarker

object (ParagraphMarker)

Penanda yang merepresentasikan awal paragraf baru.

startIndex dan endIndex TextElement ini merepresentasikan rentang paragraf. TextElement lain dengan rentang indeks yang ada di dalam rentang paragraf ini dianggap sebagai bagian dari paragraf ini. Rentang indeks dua paragraf terpisah tidak akan pernah tumpang-tindih.

textRun

object (TextRun)

TextElement yang merepresentasikan rangkaian teks yang semua karakternya dalam rangkaian tersebut memiliki TextStyle.

startIndex dan endIndex TextRun akan selalu sepenuhnya berada dalam rentang indeks satu paragraphMarker TextElement. Dengan kata lain, TextRun tidak akan pernah mencakup beberapa paragraf.

autoText

object (AutoText)

TextElement yang merepresentasikan tempat dalam teks yang diganti secara dinamis dengan konten yang dapat berubah seiring waktu.

ParagraphMarker

Jenis TextElement yang merepresentasikan 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 tidak termasuk dalam daftar.

ParagraphStyle

Gaya yang diterapkan ke seluruh paragraf.

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

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

Gaya paragraf yang diwarisi ditampilkan sebagai kolom yang tidak disetel 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 ruang di antara garis, sebagai persentase normal, dengan normal direpresentasikan sebagai 100,0. Jika tidak ditetapkan, nilai akan diwarisi dari induk.

alignment

enum (Alignment)

Perataan teks untuk paragraf ini.

indentStart

object (Dimension)

Jumlah indentasi untuk paragraf di sisi yang sesuai dengan awal teks, berdasarkan arah teks saat ini. Jika tidak ditetapkan, 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 ditetapkan, nilai akan diwarisi dari induk.

spaceAbove

object (Dimension)

Jumlah ruang ekstra di atas paragraf. Jika tidak ditetapkan, nilai akan diwarisi dari induk.

spaceBelow

object (Dimension)

Jumlah ruang ekstra di bawah paragraf. Jika tidak ditetapkan, nilai akan diwarisi dari induk.

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

Arah teks paragraf ini. Jika tidak disetel, nilai defaultnya adalah LEFT_TO_RIGHT karena arah teks tidak diwarisi.

spacingMode

enum (SpacingMode)

Mode penspasian untuk paragraf.

Perataan

Jenis perataan teks untuk paragraf.

Enum
ALIGNMENT_UNSPECIFIED Perataan paragraf diwarisi dari induk.
START Paragraf disejajarkan dengan awal baris. Diratakan kiri untuk teks LTR, diratakan kanan untuk teks lainnya.
CENTER Paragraf berada di tengah.
END Paragraf disejajarkan dengan akhir baris. Diratakan ke kanan untuk teks LTR, diratakan ke kiri untuk teks lainnya.
JUSTIFIED Paragraf diratakan.

TextDirection

Teks petunjuk arah dapat muncul.

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

SpacingMode

Berbagai mode untuk jarak paragraf.

Enum
SPACING_MODE_UNSPECIFIED Mode penspasian diwarisi dari induk.
NEVER_COLLAPSE Jarak antarparagraf selalu dirender.
COLLAPSE_LISTS Jarak antar-paragraf dilewati di antara elemen daftar.

Butir

Mendeskripsikan poin paragraf.

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

string

ID daftar tempat paragraf ini berada.

nestingLevel

integer

Level bertingkat paragraf ini dalam daftar.

glyph

string

Glyph butir yang dirender untuk paragraf ini.

bulletStyle

object (TextStyle)

Gaya teks khusus paragraf yang diterapkan pada poin ini.

TextStyle

Mewakili gaya yang dapat diterapkan ke TextRun.

Jika teks ini ada dalam bentuk dengan placeholder induk, gaya teks ini dapat diwarisi dari induk. Gaya teks yang diwarisi bergantung pada tingkat penyusunan daftar:

  • Run teks dalam paragraf yang tidak ada dalam daftar akan mewarisi gaya teksnya dari karakter baris baru dalam paragraf pada tingkat nesting 0 dari daftar di dalam placeholder induk.
  • Run teks dalam paragraf yang ada dalam daftar akan mewarisi gaya teksnya dari karakter baris baru dalam paragraf pada tingkat bersarang yang sesuai dari daftar di dalam placeholder induk.

Gaya teks yang diwarisi ditampilkan sebagai kolom yang tidak disetel dalam pesan ini. Jika teks terdapat dalam bentuk tanpa placeholder induk, membatalkan 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, bergantung pada apakah kolom opaqueColor di dalamnya disetel.

foregroundColor

object (OptionalColor)

Warna teks itu sendiri. Jika disetel, warna akan buram atau transparan, bergantung pada apakah kolom opaqueColor di dalamnya disetel.

bold

boolean

Apakah teks dirender sebagai tebal atau tidak.

italic

boolean

Apakah teks dimiringkan 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 dikenali, teks akan dirender dalam Arial.

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

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

Offset vertikal teks dari posisi normalnya.

Teks dengan SUPERSCRIPT atau SUBSCRIPT offset dasar pengukuran dirender secara otomatis dalam ukuran font yang lebih kecil, yang dihitung berdasarkan kolom fontSize. fontSize sendirinya tidak terpengaruh oleh perubahan di kolom 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.

Kolom ini adalah ekstensi dari fontFamily yang dimaksudkan untuk mendukung ketebalan font eksplisit tanpa merusak kompatibilitas mundur. Dengan demikian, saat membaca gaya rentang teks, nilai weightedFontFamily#fontFamily akan selalu sama dengan nilai fontFamily. Namun, saat menulis, jika kedua kolom disertakan dalam mask kolom (baik secara eksplisit maupun melalui karakter pengganti "*"), nilainya akan disesuaikan sebagai berikut:

  • Jika fontFamily disetel dan weightedFontFamily tidak disetel, nilai fontFamily diterapkan dengan bobot 400 ("normal").
  • Jika kedua kolom ditetapkan, nilai fontFamily harus cocok dengan nilai weightedFontFamily#fontFamily. Jika demikian, jenis font dan ketebalan weightedFontFamily akan diterapkan. Jika tidak, error permintaan buruk 400 akan ditampilkan.
  • Jika weightedFontFamily disetel dan fontFamily tidak disetel, jenis dan ketebalan font weightedFontFamily akan diterapkan.
  • Jika kedua kolom tidak ditetapkan, jenis font dan ketebalan teks akan diwarisi dari induk. Perhatikan bahwa properti ini tidak dapat diwariskan secara terpisah satu sama lain.

Jika permintaan update menentukan nilai untuk weightedFontFamily dan bold, maka weightedFontFamily akan diterapkan terlebih dahulu, lalu bold.

Jika weightedFontFamily#weight tidak disetel, nilai defaultnya adalah 400.

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

OptionalColor

Warna yang dapat sepenuhnya buram atau sepenuhnya transparan.

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

object (OpaqueColor)

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

BaselineOffset

Cara teks dapat diimbangi secara vertikal dari posisi normalnya.

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

WeightedFontFamily

Mewakili jenis font dan ketebalan 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 dikenali, teks akan dirender dalam Arial.

weight

integer

Ketebalan 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, bagian 15.6, dengan nilai non-numerik tidak diizinkan. Ketebalan yang lebih besar dari atau sama dengan 700 dianggap tebal, dan ketebalan yang kurang dari 700 tidak tebal. Nilai defaultnya adalah 400 ("normal").

TextRun

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

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

string

Teks run ini.

style

object (TextStyle)

Gaya yang diterapkan pada proses ini.

AutoText

Jenis TextElement yang merepresentasikan 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 diterapkan ke teks otomatis ini.

Jenis

Jenis teks otomatis

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

Daftar

List menjelaskan tampilan dan nuansa butir yang termasuk dalam paragraf yang terkait dengan 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 di tingkat terkait. Daftar memiliki paling banyak sembilan tingkat penyusunan, sehingga kemungkinan nilai untuk kunci peta ini adalah 0 hingga 8, inklusif.

NestingLevel

Berisi properti yang menjelaskan tampilan dan nuansa butir daftar pada tingkat penataan tertentu.

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

object (TextStyle)

Gaya butir pada tingkat bertingkat ini.