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 terdapat dalam teks ini, yang diberi kunci 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 hal berikut:
paragraphMarker

object (ParagraphMarker)

Penanda yang mewakili awal paragraf baru.

startIndex dan endIndex dari 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 run teks dengan semua karakter dalam run memiliki TextStyle yang sama.

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

autoText

object (AutoText)

TextElement yang mewakili tempat dalam teks yang diganti secara dinamis 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 tidak termasuk dalam daftar.

ParagraphStyle

Gaya yang berlaku untuk seluruh paragraf.

Jika teks ini terdapat dalam bentuk dengan placeholder induk, 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 0 bertingkat daftar di dalam placeholder induk.
  • Paragraf dalam daftar akan mewarisi gaya paragrafnya dari paragraf pada tingkat bertingkat yang sesuai dari daftar di dalam placeholder induk.

Gaya paragraf yang diwarisi direpresentasikan 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 di antara baris, sebagai persentase dari 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 disetel, nilai akan diwarisi dari induk.

spaceAbove

object (Dimension)

Jumlah spasi tambahan di atas paragraf. Jika tidak ditetapkan, 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 ditetapkan, nilai defaultnya adalah LEFT_TO_RIGHT karena arah teks tidak diwarisi.

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 awal baris. Diratakan ke kiri untuk teks LTR, diratakan ke kanan jika tidak.
CENTER Paragraf berada di tengah.
END Paragraf disejajarkan ke akhir baris. Rata kanan untuk teks LTR, rata kiri jika tidak.
JUSTIFIED Paragraf rata kanan.

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 berjalan dari kanan ke kiri.

SpacingMode

Berbagai mode untuk spasi paragraf.

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

Butir

Menjelaskan poin paragraf.

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

string

ID daftar tempat paragraf ini tercantum.

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 visual 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 pada tingkat bertingkat 0 dari daftar di dalam placeholder induk.
  • Jalur teks dalam paragraf yang ada dalam daftar akan mewarisi gaya teksnya dari karakter baris baru dalam paragraf pada tingkat susunan daftar yang sesuai 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 ditetapkan, warnanya buram atau transparan, bergantung pada apakah kolom opaqueColor di dalamnya ditetapkan.

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, nilai bold yang ditetapkan secara eksplisit akan digunakan.

fontSize

object (Dimension)

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

baselineOffset

enum (BaselineOffset)

Offset vertikal teks dari posisi normalnya.

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

Bidang ini merupakan perluasan dari fontFamily dimaksudkan untuk mendukung bobot font eksplisit tanpa memutus 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 direkonsiliasi sebagai berikut:

  • Jika fontFamily sudah diatur dan weightedFontFamily tidak, nilai fontFamily diterapkan dengan bobot 400 ("normal").
  • Jika kedua {i>field<i} telah diatur, nilai fontFamily harus sesuai dengan weightedFontFamily#fontFamily. Jika demikian, jenis font 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 akan diwarisi dari induk. Perhatikan bahwa properti ini tidak dapat diwarisi secara terpisah dari satu sama lain.

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

Jika weightedFontFamily#weight tidak ditetapkan, setelan 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 dapat sepenuhnya buram atau sepenuhnya transparan.

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

object (OpaqueColor)

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

BaselineOffset

Cara teks dapat dioffset 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 dioffset secara vertikal ke atas (superskrip).
SUBSCRIPT Teks dioffset secara vertikal ke bawah (subskrip).

WeightedFontFamily

Merepresentasikan 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

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, bagian 15.6, dengan nilai non-numerik yang tidak diizinkan. Bobot yang lebih besar dari atau sama dengan 700 dianggap tebal, dan bobot yang 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 dari operasi ini.

style

object (TextStyle)

Gaya yang diterapkan ke operasi 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 visual 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. Daftar memiliki maksimal sembilan tingkat tingkatan, sehingga kemungkinan nilai untuk kunci peta ini adalah 0 hingga 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.