REST Resource: documents

Referensi: Dokumen

Dokumen Google Dokumen.

Representasi JSON
{
  "documentId": string,
  "title": string,
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Kolom
documentId

string

Hanya output. ID dokumen.

title

string

Judul dokumen.

body

object (Body)

Hanya output. Isi utama dokumen.

headers

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

Hanya output. Header dalam dokumen, dengan kunci ID header.

footers

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

Hanya output. Footer dalam dokumen, dengan kunci ID footer.

footnotes

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

Hanya output. Catatan kaki dalam dokumen, dengan kunci ID catatan kaki.

documentStyle

object (DocumentStyle)

Hanya output. Gaya dokumen.

suggestedDocumentStyleChanges

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

Hanya output. Perubahan yang disarankan pada gaya dokumen, sesuai dengan ID saran.

namedStyles

object (NamedStyles)

Hanya output. Gaya dokumen yang diberi nama.

suggestedNamedStylesChanges

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

Hanya output. Perubahan yang disarankan pada gaya dokumen yang diberi nama, dengan kunci ID saran.

lists

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

Hanya output. Daftar dalam dokumen, yang dikunci oleh ID daftar.

namedRanges

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

Hanya output. Rentang bernama dalam dokumen, dikunci berdasarkan nama.

revisionId

string

Hanya output. ID revisi dokumen. Dapat digunakan dalam permintaan pembaruan untuk menentukan revisi dokumen yang akan diterapkan pembaruan dan bagaimana perilaku permintaan jika dokumen telah diedit sejak revisi tersebut. Hanya diisi jika pengguna memiliki akses edit ke dokumen.

ID revisi bukan nomor berurutan, melainkan string buram. Format ID revisi dapat berubah seiring waktu. ID revisi yang ditampilkan hanya dijamin valid selama 24 jam setelah ditampilkan dan tidak dapat dibagikan kepada pengguna lain. Jika ID revisi tidak berubah di antara panggilan, berarti dokumen belum berubah. Sebaliknya, ID yang diubah (untuk dokumen dan pengguna yang sama) biasanya berarti dokumen telah diperbarui. Namun, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

suggestionsViewMode

enum (SuggestionsViewMode)

Hanya output. Mode tampilan saran diterapkan ke dokumen.

Catatan: Saat mengedit dokumen, perubahan harus didasarkan pada dokumen dengan SUGGESTIONS_INLINE.

inlineObjects

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

Hanya output. Objek inline dalam dokumen, dikunci oleh ID objek.

positionedObjects

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

Hanya output. Objek yang diposisikan dalam dokumen, dikunci oleh ID objek.

Isi

Isi dokumen.

Isi biasanya berisi konten dokumen lengkap, kecuali untuk headers, footers, dan footnotes.

Representasi JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Kolom
content[]

object (StructuralElement)

Isi dari isi pesan.

Indeks untuk konten isi dimulai dari nol.

Elemen Struktural

StructuralElement menjelaskan konten yang memberikan struktur pada dokumen.

Representasi JSON
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Kolom
startIndex

integer

Indeks awal berbasis nol dari elemen struktural ini, dalam unit kode UTF-16.

endIndex

integer

Indeks akhir berbasis nol dari elemen struktural ini, eksklusif, dalam unit kode UTF-16.

Kolom union content. Konten elemen struktural. content hanya dapat berupa salah satu dari berikut:
paragraph

object (Paragraph)

Jenis paragraf dari elemen struktural.

sectionBreak

object (SectionBreak)

Jenis jeda bagian dari elemen struktural.

table

object (Table)

Jenis tabel elemen struktural.

tableOfContents

object (TableOfContents)

Jenis daftar isi elemen struktural.

Paragraf

StructuralElement yang mewakili paragraf. Paragraf adalah rentang konten yang diakhiri dengan karakter baris baru.

Representasi JSON
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Kolom
elements[]

object (ParagraphElement)

Konten paragraf, dibagi menjadi beberapa bagian komponen.

paragraphStyle

object (ParagraphStyle)

Gaya paragraf ini.

suggestedParagraphStyleChanges

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

Gaya paragraf yang disarankan berubah pada paragraf ini, dengan kunci ID saran.

bullet

object (Bullet)

Butir untuk paragraf ini. Jika tidak ada, paragraf tersebut tidak termasuk dalam daftar.

suggestedBulletChanges

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

Perubahan yang disarankan pada butir paragraf ini.

positionedObjectIds[]

string

ID objek yang diposisikan yang di-tether ke paragraf ini.

suggestedPositionedObjectIds

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

ID objek yang diposisikan yang disarankan untuk dilampirkan ke paragraf ini, dengan kunci ID saran.

ParagraphElement

ParagraphElement mendeskripsikan konten dalam Paragraph.

Representasi JSON
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
Kolom
startIndex

integer

Indeks awal berbasis nol dari elemen paragraf ini, dalam unit kode UTF-16.

endIndex

integer

Indeks akhir dasar nol dari elemen paragraf ini, eksklusif, dalam unit kode UTF-16.

Kolom union content. Konten elemen paragraf. content hanya dapat berupa salah satu dari berikut:
textRun

object (TextRun)

Elemen paragraf berbasis teks.

autoText

object (AutoText)

Elemen paragraf teks otomatis.

pageBreak

object (PageBreak)

Elemen paragraf batas halaman.

columnBreak

object (ColumnBreak)

Elemen paragraf jeda kolom.

footnoteReference

object (FootnoteReference)

Elemen paragraf referensi catatan kaki.

horizontalRule

object (HorizontalRule)

Elemen paragraf garis horizontal.

equation

object (Equation)

Elemen paragraf persamaan.

inlineObjectElement

object (InlineObjectElement)

Elemen paragraf objek inline.

person

object (Person)

Elemen paragraf yang tertaut ke seseorang atau alamat email.

Jalankan Teks

ParagraphElement yang mewakili seluruh teks yang memiliki gaya yang sama.

Representasi JSON
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
content

string

Teks operasi ini.

Setiap elemen non-teks yang berjalan akan diganti dengan karakter Unicode U+E907.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. TextRun dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks operasi ini.

suggestedTextStyleChanges

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

Gaya teks yang disarankan akan berubah agar berjalan, dengan kunci ID saran.

TextStyle

Menampilkan gaya yang bisa diterapkan pada teks.

Gaya teks yang diwarisi ditampilkan sebagai kolom yang tidak ditetapkan dalam pesan ini. Induk gaya teks bergantung pada tempat gaya teks ditentukan:

  • TextStyle teks dalam Paragraph mewarisi dari named style type paragraf yang sesuai.
  • TextStyle pada named style mewarisi dari gaya bernama normal text.
  • TextStyle dari gaya bernama normal text mewarisi dari gaya teks default di editor Dokumen.
  • TextStyle pada elemen Paragraph yang terdapat dalam tabel dapat mewarisi gaya teksnya dari gaya tabel.

Jika gaya teks tidak mewarisi dari induk, kolom yang tidak disetel akan mengembalikan gaya ke nilai yang cocok dengan default di editor Dokumen.

Representasi JSON
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
Kolom
bold

boolean

Apakah teks dirender sebagai tebal.

italic

boolean

Apakah teks dicetak miring atau tidak.

underline

boolean

Apakah teks digarisbawahi atau tidak.

strikethrough

boolean

Apakah teks dicoret atau tidak.

smallCaps

boolean

Apakah teks menggunakan huruf besar kecil.

backgroundColor

object (OptionalColor)

Warna latar belakang teks. Jika ditetapkan, warna akan menjadi warna RGB atau transparan, bergantung pada kolom color.

foregroundColor

object (OptionalColor)

Warna latar depan teks. Jika ditetapkan, warna akan menjadi warna RGB atau transparan, bergantung pada kolom color.

fontSize

object (Dimension)

Ukuran font teks.

weightedFontFamily

object (WeightedFontFamily)

Jenis font dan ketebalan teks yang dirender.

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

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

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

baselineOffset

enum (BaselineOffset)

Offset vertikal teks dari posisi normalnya.

Teks dengan offset dasar pengukuran SUPERSCRIPT atau SUBSCRIPT otomatis dirender dalam ukuran font yang lebih kecil, dihitung berdasarkan kolom fontSize. Perubahan di kolom ini tidak memengaruhi fontSize.

WarnaOpsional

Warna yang bisa sepenuhnya buram atau sepenuhnya transparan.

Representasi JSON
{
  "color": {
    object (Color)
  }
}
Kolom
color

object (Color)

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

Warna

Warna solid.

Representasi JSON
{
  "rgbColor": {
    object (RgbColor)
  }
}
Kolom
rgbColor

object (RgbColor)

Nilai warna RGB.

Warna Rgb

Warna RGB.

Representasi JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Kolom
red

number

Komponen merah warna, dari 0,0 hingga 1,0.

green

number

Komponen warna hijau, dari 0,0 hingga 1,0.

blue

number

Komponen biru warna, dari 0,0 hingga 1,0.

Dimensi

Besarnya dalam satu arah dalam satuan yang ditentukan.

Representasi JSON
{
  "magnitude": number,
  "unit": enum (Unit)
}
Kolom
magnitude

number

Magnitudo.

unit

enum (Unit)

Satuan untuk magnitudo.

Satuan

Satuan ukur.

Enum
UNIT_UNSPECIFIED Unit tidak diketahui.
PT Satu poin, 1/72 inci.

WeightedFontFamily

Menampilkan jenis font dan ketebalan teks.

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

string

Jenis font teks.

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

weight

integer

Ketebalan font. 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.

Nilai defaultnya adalah 400 ("normal").

Ketebalan font hanya terdiri dari satu komponen dari ketebalan font yang dirender. Kombinasi weight dan nilai bold yang di-resolve gaya teks menentukan bobot yang dirender, setelah memperhitungkan pewarisan:

  • Jika teks dicetak tebal dan kurang dari 400, bobot yang dirender adalah 400.
  • Jika teks dicetak tebal dan tebal lebih besar dari atau sama dengan 400 tetapi kurang dari 700, bobot yang dirender adalah 700.
  • Jika bobot lebih besar dari atau sama dengan 700, bobot yang dirender sama dengan bobot.
  • Jika teks tidak tebal, bobot yang dirender sama dengan bobot.

Offset Dasar Pengukuran

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

Enum
BASELINE_OFFSET_UNSPECIFIED Offset dasar pengukuran teks diwariskan 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).

GayaTeks yang Disarankan

Perubahan yang disarankan untuk TextStyle.

Representasi JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Kolom
textStyle

object (TextStyle)

TextStyle yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan textStyleSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

textStyleSuggestionState

object (TextStyleSuggestionState)

Mask yang menunjukkan kolom mana pada TextStyle dasar yang telah diubah dalam saran ini.

TextStyleSuggestionState

Mask yang menunjukkan kolom mana pada TextStyle dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
Kolom
boldSuggested

boolean

Menunjukkan apakah ada saran perubahan pada bold.

italicSuggested

boolean

Menunjukkan apakah ada saran perubahan pada italic.

underlineSuggested

boolean

Menunjukkan apakah ada saran perubahan pada underline.

strikethroughSuggested

boolean

Menunjukkan apakah ada saran perubahan pada strikethrough.

smallCapsSuggested

boolean

Menunjukkan apakah ada saran perubahan pada smallCaps.

backgroundColorSuggested

boolean

Menunjukkan apakah ada saran perubahan pada backgroundColor.

foregroundColorSuggested

boolean

Menunjukkan apakah ada saran perubahan pada foregroundColor.

fontSizeSuggested

boolean

Menunjukkan apakah ada saran perubahan pada fontSize.

weightedFontFamilySuggested

boolean

Menunjukkan apakah ada saran perubahan pada weightedFontFamily.

baselineOffsetSuggested

boolean

Menunjukkan apakah ada saran perubahan pada baselineOffset.

Teks Otomatis

ParagraphElement yang mewakili tempat dalam teks yang secara dinamis diganti dengan konten yang dapat berubah dari waktu ke waktu, seperti nomor halaman.

Representasi JSON
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
type

enum (Type)

Jenis teks otomatis ini.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. AutoText dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks AutoText ini.

suggestedTextStyleChanges

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

Gaya teks yang disarankan akan berubah menjadi AutoText ini, sesuai dengan ID saran.

Type

Jenis teks otomatis.

Enum
TYPE_UNSPECIFIED Jenis teks otomatis yang tidak ditentukan.
PAGE_NUMBER Ketik teks otomatis yang mewakili nomor halaman saat ini.
PAGE_COUNT Ketik untuk teks otomatis yang mewakili jumlah total halaman dalam dokumen.

Batas Halaman

ParagraphElement yang mewakili batas halaman. Batas halaman membuat teks berikutnya dimulai di bagian atas halaman berikutnya.

Representasi JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
suggestedInsertionIds[]

string

ID penyisipan yang disarankan. PageBreak dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks PageBreak ini.

Mirip dengan konten teks, seperti teks yang berjalan dan referensi catatan kaki, gaya teks batas halaman dapat memengaruhi tata letak konten serta gaya teks yang disisipkan di sampingnya.

suggestedTextStyleChanges

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

Gaya teks yang disarankan berubah pada PageBreak ini, yang dikunci oleh ID saran.

Batas Kolom

ParagraphElement yang mewakili batas kolom. Batas kolom membuat teks berikutnya dimulai di bagian atas kolom berikutnya.

Representasi JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
suggestedInsertionIds[]

string

ID penyisipan yang disarankan. ColumnBreak dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks ColumnBreak ini.

Mirip dengan konten teks, seperti teks yang berjalan dan referensi catatan kaki, gaya teks jeda kolom dapat memengaruhi tata letak konten serta gaya teks yang disisipkan di sampingnya.

suggestedTextStyleChanges

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

Gaya teks yang disarankan berubah pada ColumnBreak ini, dengan kunci ID saran.

ReferensiCatatan Kaki

ParagraphElement yang mewakili referensi catatan kaki. Referensi catatan kaki adalah konten {i>inline<i} yang dirender dengan angka dan digunakan untuk mengidentifikasi catatan kaki.

Representasi JSON
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
footnoteId

string

ID footnote yang berisi konten referensi catatan kaki ini.

footnoteNumber

string

Jumlah yang dirender untuk catatan kaki ini.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. FootnoteReference dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks FootnoteReference ini.

suggestedTextStyleChanges

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

Gaya teks yang disarankan berubah pada FootnoteReference ini, yang dikunci oleh ID saran.

Aturan Horizontal

ParagraphElement yang merepresentasikan garis horizontal.

Representasi JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
suggestedInsertionIds[]

string

ID penyisipan yang disarankan. HorizontalRule dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks HorizontalRule ini.

Mirip dengan konten teks, seperti urutan teks dan referensi catatan kaki, gaya teks penggaris horizontal dapat memengaruhi tata letak konten serta gaya teks yang disisipkan di sampingnya.

suggestedTextStyleChanges

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

Gaya teks yang disarankan berubah menjadi HorizontalRule ini, dengan kunci ID saran.

Persamaan

ParagraphElement yang mewakili persamaan.

Representasi JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Kolom
suggestedInsertionIds[]

string

ID penyisipan yang disarankan. Equation dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

InlineObjectElement

ParagraphElement yang berisi InlineObject.

Representasi JSON
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Kolom
inlineObjectId

string

ID InlineObject yang dimuat elemen ini.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. InlineObjectElement dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

textStyle

object (TextStyle)

Gaya teks InlineObjectElement ini.

Serupa dengan konten teks, seperti teks berjalan dan referensi catatan kaki, gaya teks dari elemen objek inline dapat memengaruhi tata letak konten serta gaya teks yang disisipkan di sebelahnya.

suggestedTextStyleChanges

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

Gaya teks yang disarankan berubah menjadi InlineObject ini, dengan kunci ID saran.

Orang

Orang atau alamat email yang disebutkan dalam dokumen. Sebutan ini berfungsi sebagai satu elemen yang tidak dapat diubah yang berisi nama atau alamat email orang.

Representasi JSON
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
Kolom
personId

string

Hanya output. ID unik link ini.

suggestedInsertionIds[]

string

ID untuk saran yang menyisipkan link orang ini ke dalam dokumen. Person mungkin memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat (misalnya, saran dalam saran yang dibuat oleh pengguna yang berbeda). Jika kosong, berarti link orang ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID untuk saran yang menghapus link orang ini dari dokumen. Person dapat memiliki beberapa ID penghapusan jika, misalnya, beberapa pengguna menyarankan untuk menghapusnya. Jika kosong, link orang ini tidak akan disarankan untuk dihapus.

textStyle

object (TextStyle)

Gaya teks Person ini.

suggestedTextStyleChanges

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

Gaya teks yang disarankan akan berubah menjadi Person ini, yang dikunci oleh ID saran.

personProperties

object (PersonProperties)

Hanya output. Properti Person ini. Kolom ini selalu ada.

PropertiPersona

Properti khusus untuk Person tertaut.

Representasi JSON
{
  "name": string,
  "email": string
}
Kolom
name

string

Hanya output. Nama orang jika ditampilkan dalam teks link, bukan alamat email orang tersebut.

email

string

Hanya output. Alamat email yang ditautkan ke Person ini. Kolom ini selalu ada.

RichLinkProperties

Properti khusus untuk RichLink.

Representasi JSON
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Kolom
title

string

Hanya output. Judul RichLink seperti yang ditampilkan dalam link. Judul ini cocok dengan judul resource yang ditautkan pada saat penyisipan atau pembaruan terakhir link. Kolom ini selalu ada.

uri

string

Hanya output. URI ke RichLink. Kolom ini selalu ada.

mimeType

string

Hanya output. Jenis MIME dari RichLink, jika ada (misalnya, saat berupa file di Drive).

ParagraphStyle

Gaya yang berlaku untuk seluruh paragraf.

Gaya paragraf yang diwarisi ditampilkan sebagai kolom yang tidak ditetapkan dalam pesan ini. Induk gaya paragraf bergantung pada tempat gaya paragraf ditentukan:

  • ParagraphStyle di Paragraph mewarisi dari named style type paragraf yang sesuai.
  • ParagraphStyle di named style mewarisi dari gaya bernama normal text.
  • ParagraphStyle dari gaya bernama normal text mewarisi dari gaya paragraf default di editor Dokumen.
  • ParagraphStyle pada elemen Paragraph yang terdapat dalam tabel dapat mewarisi gaya paragraf dari gaya tabel.

Jika gaya paragraf tidak mewarisi dari induk, kolom yang tidak disetel akan mengembalikan gaya ke nilai yang cocok dengan default di editor Dokumen.

Representasi JSON
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Kolom
headingId

string

ID judul paragraf. Jika kosong, paragraf ini bukan judul.

Properti ini bersifat hanya baca.

namedStyleType

enum (NamedStyleType)

Jenis gaya paragraf yang diberi nama.

Karena memperbarui jenis gaya bernama memengaruhi properti lain dalam ParagraphStyle, jenis gaya bernama akan diterapkan sebelum properti lainnya diperbarui.

alignment

enum (Alignment)

Perataan teks untuk paragraf ini.

lineSpacing

number

Jumlah spasi antarbaris, dalam persentase normal, dengan normal direpresentasikan sebagai 100,0. Jika tidak disetel, nilai akan diwariskan dari induk.

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

Mode spasi untuk paragraf.

spaceAbove

object (Dimension)

Jumlah spasi ekstra di atas paragraf. Jika tidak disetel, nilai akan diwariskan dari induk.

spaceBelow

object (Dimension)

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

borderBetween

object (ParagraphBorder)

Batas antara paragraf ini dan paragraf berikutnya dan sebelumnya. Jika tidak disetel, nilai akan diwariskan dari induk.

Antar-batas dirender jika paragraf yang bersebelahan memiliki properti batas dan indentasi yang sama.

Batas paragraf tidak dapat diperbarui sebagian. Saat mengubah batas paragraf, batas baru harus ditentukan secara keseluruhan.

borderTop

object (ParagraphBorder)

Batas di bagian atas paragraf ini. Jika tidak disetel, nilai akan diwariskan dari induk.

Batas atas dirender jika paragraf di atas memiliki properti batas dan indentasi yang berbeda.

Batas paragraf tidak dapat diperbarui sebagian. Saat mengubah batas paragraf, batas baru harus ditentukan secara keseluruhan.

borderBottom

object (ParagraphBorder)

Batas di bagian bawah paragraf ini. Jika tidak disetel, nilai akan diwariskan dari induk.

Batas bawah dirender saat paragraf di bawah memiliki properti batas dan indentasi yang berbeda.

Batas paragraf tidak dapat diperbarui sebagian. Saat mengubah batas paragraf, batas baru harus ditentukan secara keseluruhan.

borderLeft

object (ParagraphBorder)

Batas di sebelah kiri paragraf ini. Jika tidak disetel, nilai akan diwariskan dari induk.

Batas paragraf tidak dapat diperbarui sebagian. Saat mengubah batas paragraf, batas baru harus ditentukan secara keseluruhan.

borderRight

object (ParagraphBorder)

Batas di sebelah kanan paragraf ini. Jika tidak disetel, nilai akan diwariskan dari induk.

Batas paragraf tidak dapat diperbarui sebagian. Saat mengubah batas paragraf, batas baru harus ditentukan secara keseluruhan.

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

Jumlah indentasi untuk paragraf di samping yang sesuai dengan awal teks, berdasarkan arah paragraf saat ini. Jika tidak disetel, nilai akan diwariskan dari induk.

indentEnd

object (Dimension)

Jumlah indentasi untuk paragraf di sisi yang sesuai dengan akhir teks, berdasarkan arah paragraf saat ini. Jika tidak disetel, nilai akan diwariskan dari induk.

tabStops[]

object (TabStop)

Daftar tab akan berhenti untuk paragraf ini. Daftar tab-stop tidak diwariskan.

Properti ini bersifat hanya baca.

keepLinesTogether

boolean

Apakah semua baris paragraf harus diletakkan pada halaman atau kolom yang sama jika memungkinkan. Jika tidak disetel, nilai akan diwariskan dari induk.

keepWithNext

boolean

Apakah setidaknya sebagian paragraf ini harus diletakkan pada halaman atau kolom yang sama dengan paragraf berikutnya jika memungkinkan. Jika tidak disetel, nilai akan diwariskan dari induk.

avoidWidowAndOrphan

boolean

Apakah ingin menghindari janda dan anak yatim untuk paragraf. Jika tidak disetel, nilai akan diwariskan dari induk.

shading

object (Shading)

Bayangan paragraf. Jika tidak disetel, nilai akan diwariskan dari induk.

pageBreakBefore

boolean

Apakah paragraf saat ini harus selalu dimulai di awal halaman. Jika tidak disetel, nilai akan diwariskan dari induk.

Mencoba memperbarui pageBreakBefore untuk paragraf di wilayah yang tidak didukung, termasuk Table, Header, Footer, dan Footnote, dapat mengakibatkan status dokumen tidak valid yang menampilkan error permintaan buruk 400.

NamedStyleType

Jenis gaya yang diberi nama.

Enum
NAMED_STYLE_TYPE_UNSPECIFIED Jenis gaya bernama tidak ditentukan.
NORMAL_TEXT Teks normal.
TITLE Judul.
SUBTITLE Subtitel.
HEADING_1 Judul 1.
HEADING_2 Judul 2.
HEADING_3 Judul 3.
HEADING_4 Judul 4.
HEADING_5 Judul 5.
HEADING_6 Judul 6.

Perataan

Jenis-jenis perataan teks untuk paragraf.

Enum
ALIGNMENT_UNSPECIFIED Perataan paragraf diwariskan dari induk.
START Paragraf sejajar dengan awal baris. Diratakan kiri untuk teks LTR, diratakan ke kanan.
CENTER Paragraf berada di tengah.
END Paragraf sejajar dengan akhir baris. Diratakan kanan untuk teks LTR, dirata kiri jika tidak.
JUSTIFIED Paragraf wajar.

ArahKonten

Konten arah dapat mengalir.

Enum
CONTENT_DIRECTION_UNSPECIFIED Arah konten tidak ditentukan.
LEFT_TO_RIGHT Konten membentang dari kiri ke kanan.
RIGHT_TO_LEFT Konten membentang dari kanan ke kiri.

Mode Spasi

Berbagai mode untuk jarak antar-paragraf.

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

Batas Paragraf

Batas di sekeliling paragraf.

Representasi JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Kolom
color

object (OptionalColor)

Warna batas.

width

object (Dimension)

Lebar batas.

padding

object (Dimension)

Padding batas.

dashStyle

enum (DashStyle)

Gaya garis putus-putus batas.

Gaya Garis Putus

Jenis tanda hubung yang dapat digunakan untuk merender geometri linear. Nilai ini didasarkan pada jenis sederhana "ST_PresetLineDashVal" yang dijelaskan di pasal 20.1.10.48 "Format File XML Open Office - Dasar-Dasar dan Referensi Bahasa Markup", bagian 1 dari edisi ke-4 ECMA-376.

Enum
DASH_STYLE_UNSPECIFIED Gaya tanda pisah tidak ditetapkan.
SOLID Garis solid. Terkait dengan nilai ECMA-376 ST_PresetLineDashVal 'solid'. Ini adalah gaya tanda pisah default.
DOT Garis titik-titik. Terkait dengan nilai 'dot' ECMA-376 ST_PresetLineDashVal.
DASH Garis putus-putus. Terkait dengan nilai 'dash' ECMA-376 ST_PresetLineDashVal.

Berhenti Tab

Batas tab dalam paragraf.

Representasi JSON
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Kolom
offset

object (Dimension)

Offset antara tab baru ini dan margin awal.

alignment

enum (TabStopAlignment)

Perataan tab ini akan berhenti. Jika tidak disetel, nilai akan ditetapkan secara default ke START.

{i>TabStopAlignment<i}

Perataan batas tab.

Enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Perataan tab-stop tidak ditentukan.
START Tab-stop sejajar dengan awal garis. Ini adalah defaultnya.
CENTER Tab-stop sejajar dengan bagian tengah garis.
END Tab-stop sejajar dengan akhir garis.

Bayangan

Bayangan paragraf.

Representasi JSON
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
Kolom
backgroundColor

object (OptionalColor)

Warna latar belakang bayangan paragraf ini.

GayaParagraf yang Disarankan

Perubahan yang disarankan untuk ParagraphStyle.

Representasi JSON
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Kolom
paragraphStyle

object (ParagraphStyle)

ParagraphStyle yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan paragraphStyleSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Mask yang menunjukkan kolom mana pada ParagraphStyle dasar yang telah diubah dalam saran ini.

ParagraphStyleSuggestionState

Mask yang menunjukkan kolom mana pada ParagraphStyle dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Kolom
headingIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada headingId.

namedStyleTypeSuggested

boolean

Menunjukkan apakah ada saran perubahan pada namedStyleType.

alignmentSuggested

boolean

Menunjukkan apakah ada saran perubahan pada alignment.

lineSpacingSuggested

boolean

Menunjukkan apakah ada saran perubahan pada lineSpacing.

directionSuggested

boolean

Menunjukkan apakah ada saran perubahan pada direction.

spacingModeSuggested

boolean

Menunjukkan apakah ada saran perubahan pada spacingMode.

spaceAboveSuggested

boolean

Menunjukkan apakah ada saran perubahan pada spaceAbove.

spaceBelowSuggested

boolean

Menunjukkan apakah ada saran perubahan pada spaceBelow.

borderBetweenSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderBetween.

borderTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderTop.

borderBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderBottom.

borderLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderLeft.

borderRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderRight.

indentFirstLineSuggested

boolean

Menunjukkan apakah ada saran perubahan pada indentFirstLine.

indentStartSuggested

boolean

Menunjukkan apakah ada saran perubahan pada indentStart.

indentEndSuggested

boolean

Menunjukkan apakah ada saran perubahan pada indentEnd.

keepLinesTogetherSuggested

boolean

Menunjukkan apakah ada saran perubahan pada keepLinesTogether.

keepWithNextSuggested

boolean

Menunjukkan apakah ada saran perubahan pada keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Menunjukkan apakah ada saran perubahan pada avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

Mask yang menunjukkan kolom mana di shading yang telah diubah dalam saran ini.

pageBreakBeforeSuggested

boolean

Menunjukkan apakah ada saran perubahan pada pageBreakBefore.

{i>ShadingSuggestionState<i}

Mask yang menunjukkan kolom mana di dasar Shading yang telah diubah dalam perubahan yang disarankan ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "backgroundColorSuggested": boolean
}
Kolom
backgroundColorSuggested

boolean

Menunjukkan apakah ada saran perubahan pada Shading.

Peluru

Menjelaskan poin-poin dalam paragraf.

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

string

ID daftar yang mencakup paragraf ini.

nestingLevel

integer

Tingkat penyusunan bertingkat paragraf ini dalam daftar.

textStyle

object (TextStyle)

Gaya teks khusus paragraf yang diterapkan ke butir ini.

Butir yang Disarankan

Perubahan yang disarankan untuk Bullet.

Representasi JSON
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Kolom
bullet

object (Bullet)

Bullet yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan bulletSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

bulletSuggestionState

object (BulletSuggestionState)

Mask yang menunjukkan kolom mana pada Bullet dasar yang telah diubah dalam saran ini.

BulletSuggestionState

Mask yang menunjukkan kolom mana pada Bullet dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Kolom
listIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada listId.

nestingLevelSuggested

boolean

Menunjukkan apakah ada saran perubahan pada nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

Mask yang menunjukkan kolom mana di text style yang telah diubah dalam saran ini.

ObjectReferences

Kumpulan ID objek.

Representasi JSON
{
  "objectIds": [
    string
  ]
}
Kolom
objectIds[]

string

ID objek.

Batas Bagian

StructuralElement yang mewakili batas bagian. Bagian adalah rentang konten yang memiliki SectionStyle yang sama. Batas bagian mewakili awal bagian baru, dan gaya bagian berlaku untuk bagian setelah batas bagian.

Isi dokumen selalu dimulai dengan batas bagian.

Representasi JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Kolom
suggestedInsertionIds[]

string

ID penyisipan yang disarankan. SectionBreak dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

sectionStyle

object (SectionStyle)

Gaya bagian setelah bagian ini akan dibatasi.

Gaya Bagian

Gaya visual yang berlaku untuk suatu bagian.

Representasi JSON
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
Kolom
columnProperties[]

object (SectionColumnProperties)

Properti kolom bagian.

Jika kosong, bagian tersebut berisi satu kolom dengan properti default di editor Dokumen. Bagian dapat diperbarui agar memiliki maksimal 3 kolom.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menyebabkan error permintaan buruk 400.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Gaya pemisah kolom.

Gaya ini dapat disetel meskipun jika ada satu kolom di bagian tersebut.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

contentDirection

enum (ContentDirection)

Arah konten bagian ini. Jika tidak disetel, nilai akan ditetapkan secara default ke LEFT_TO_RIGHT.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

marginTop

object (Dimension)

Margin halaman atas bagian tersebut. Jika tidak disetel, nilai akan ditetapkan secara default ke marginTop dari DocumentStyle.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

marginBottom

object (Dimension)

Margin halaman bawah dari bagian tersebut. Jika tidak disetel, nilai akan ditetapkan secara default ke marginBottom dari DocumentStyle.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

marginRight

object (Dimension)

Margin halaman kanan dari bagian tersebut. Jika tidak disetel, nilai akan ditetapkan secara default ke marginRight dari DocumentStyle. Memperbarui margin kanan akan menyebabkan kolom di bagian ini berubah ukuran. Karena margin memengaruhi lebar kolom, margin ini diterapkan sebelum properti kolom.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

marginLeft

object (Dimension)

Margin halaman kiri bagian tersebut. Jika tidak disetel, nilai akan ditetapkan secara default ke marginLeft dari DocumentStyle. Memperbarui margin kiri akan menyebabkan kolom di bagian ini berubah ukuran. Karena margin memengaruhi lebar kolom, margin ini diterapkan sebelum properti kolom.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

marginHeader

object (Dimension)

Margin header bagian. Jika tidak disetel, nilai akan ditetapkan secara default ke marginHeader dari DocumentStyle. Jika diperbarui, useCustomHeaderFooterMargins akan disetel ke benar (true) di DocumentStyle. Nilai useCustomHeaderFooterMargins pada DocumentStyle menunjukkan apakah margin header akan dipatuhi untuk bagian ini.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

sectionType

enum (SectionType)

Hanya output. Jenis bagian.

defaultHeaderId

string

ID header default. Jika tidak disetel, nilai akan mewarisi dari sectionStyle SectionBreak's sebelumnya. Jika nilai tidak disetel di Bagian Break pertama, nilai tersebut akan diwarisi dari defaultHeaderId DocumentStyle.

Properti ini bersifat hanya baca.

firstPageHeaderId

string

ID header hanya digunakan untuk halaman pertama bagian tersebut. Jika useFirstPageHeaderFooter bernilai benar, nilai ini akan digunakan untuk header di halaman pertama bagian. Jika nilainya salah, header di halaman pertama bagian akan menggunakan defaultHeaderId. Jika tidak disetel, nilai akan mewarisi dari sectionStyle SectionBreak's sebelumnya. Jika nilai tidak disetel di Bagian Break pertama, nilai tersebut akan diwarisi dari firstPageHeaderId DocumentStyle.

Properti ini bersifat hanya baca.

evenPageHeaderId

string

ID header hanya digunakan untuk halaman genap. Jika nilai useEvenPageHeaderFooter DocumentStyle adalah benar, nilai ini akan digunakan untuk header pada halaman genap di bagian tersebut. Jika nilainya salah, header pada halaman genap akan menggunakan defaultHeaderId. Jika tidak disetel, nilai akan mewarisi dari sectionStyle SectionBreak's sebelumnya. Jika nilai tidak disetel di Bagian Break pertama, nilai tersebut akan diwarisi dari evenPageHeaderId DocumentStyle.

Properti ini bersifat hanya baca.

pageNumberStart

integer

Nomor halaman untuk mulai menghitung jumlah halaman untuk bagian ini. Jika tidak disetel, penomoran halaman akan dilanjutkan dari bagian sebelumnya. Jika nilai tidak disetel di SectionBreak pertama, lihat pageNumberStart DocumentStyle.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

flipPageOrientation

boolean

Opsional. Menunjukkan apakah akan membalik dimensi pageSize DocumentStyle untuk bagian ini, yang memungkinkan perubahan orientasi halaman antara potret dan lanskap. Jika tidak disetel, nilai akan mewarisi dari flipPageOrientation DocumentStyle.

Saat memperbarui properti ini, Anda harus menetapkan nilai konkret. Membatalkan setelan properti ini akan menghasilkan error permintaan buruk 400.

BagianKolomProperti

Properti yang berlaku untuk kolom bagian.

Representasi JSON
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Kolom
width

object (Dimension)

Hanya output. Lebar kolom.

paddingEnd

object (Dimension)

Padding di akhir kolom.

{i>ColumnSeparatorStyle<i}

Gaya pemisah kolom di antara kolom.

Enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Gaya pemisah kolom yang tidak ditentukan.
NONE Tidak ada garis pemisah kolom di antara kolom.
BETWEEN_EACH_COLUMN Merender garis pemisah kolom di antara setiap kolom.

SectionType

Menampilkan bagaimana posisi awal bagian saat ini relatif terhadap bagian sebelumnya.

Enum
SECTION_TYPE_UNSPECIFIED Jenis bagian tidak ditentukan.
CONTINUOUS Bagian ini dimulai tepat setelah paragraf terakhir dari bagian sebelumnya.
NEXT_PAGE Bagian ini dimulai pada halaman berikutnya.

Tabel

StructuralElement yang mewakili tabel.

Representasi JSON
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Kolom
rows

integer

Jumlah baris dalam tabel.

columns

integer

Jumlah kolom dalam tabel.

Tabel dapat berbentuk non-persegi panjang, sehingga beberapa baris mungkin memiliki jumlah sel yang berbeda.

tableRows[]

object (TableRow)

Konten dan gaya setiap baris.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. Table dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

tableStyle

object (TableStyle)

Gaya tabel.

BarisTabel

Konten dan gaya baris dalam Table.

Representasi JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
Kolom
startIndex

integer

Indeks awal berbasis nol dari baris ini, dalam unit kode UTF-16.

endIndex

integer

Indeks akhir berbasis nol dari baris ini, eksklusif, dalam unit kode UTF-16.

tableCells[]

object (TableCell)

Isi dan gaya setiap sel di baris ini.

Tabel dapat berbentuk non-persegi panjang, sehingga beberapa baris mungkin memiliki jumlah sel yang berbeda dari baris lain dalam tabel yang sama.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. TableRow dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

tableRowStyle

object (TableRowStyle)

Gaya baris tabel.

suggestedTableRowStyleChanges

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

Gaya yang disarankan akan berubah pada baris ini, dengan kunci ID saran.

Sel Meja

Konten dan gaya sel dalam Table.

Representasi JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Kolom
startIndex

integer

Indeks awal berbasis nol dari sel ini, dalam unit kode UTF-16.

endIndex

integer

Indeks akhir berbasis nol dari sel ini, eksklusif, dalam unit kode UTF-16.

content[]

object (StructuralElement)

Konten sel.

tableCellStyle

object (TableCellStyle)

Gaya sel.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. TableCell dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

suggestedTableCellStyleChanges

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

Perubahan yang disarankan pada gaya sel tabel, sesuai dengan ID saran.

{i>TableCellStyle<i}

Gaya TableCell.

Gaya sel tabel yang diwarisi ditampilkan sebagai kolom yang tidak ditetapkan dalam pesan ini. Gaya sel tabel dapat mewarisi dari gaya tabel.

Representasi JSON
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Kolom
rowSpan

integer

Rentang baris sel.

Properti ini bersifat hanya baca.

columnSpan

integer

Rentang kolom sel.

Properti ini bersifat hanya baca.

backgroundColor

object (OptionalColor)

Warna latar belakang sel.

borderLeft

object (TableCellBorder)

Batas kiri sel.

borderRight

object (TableCellBorder)

Batas kanan sel.

borderTop

object (TableCellBorder)

Batas atas sel.

borderBottom

object (TableCellBorder)

Batas bawah sel.

paddingLeft

object (Dimension)

Padding kiri pada sel.

paddingRight

object (Dimension)

Padding kanan pada sel.

paddingTop

object (Dimension)

Padding atas sel.

paddingBottom

object (Dimension)

Padding bawah sel.

contentAlignment

enum (ContentAlignment)

Perataan konten dalam sel tabel. Perataan default cocok dengan perataan untuk sel tabel yang baru dibuat di editor Dokumen.

Batas SelTabel

Batas di sekeliling sel tabel.

Batas sel tabel tidak boleh transparan. Untuk menyembunyikan batas sel tabel, buat lebarnya 0.

Representasi JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Kolom
color

object (OptionalColor)

Warna batas.

Warna ini tidak boleh transparan.

width

object (Dimension)

Lebar batas.

dashStyle

enum (DashStyle)

Gaya garis putus-putus batas.

ContentAlignment

Jenis-jenis penyelarasan konten.

Diturunkan dari subset nilai jenis sederhana "ST_TextAnchoringType" di bagian 20.1.10.59 dari "Office Open XML Format Files - Fundamentals and Markup Language Reference", bagian 1 dari ECMA-376 edisi ke-4.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Perataan konten yang tidak ditentukan. Perataan konten diwariskan dari induk jika ada.
CONTENT_ALIGNMENT_UNSUPPORTED Penyelarasan konten tidak didukung.
TOP Perataan yang meratakan konten ke bagian atas holder konten. Terkait dengan ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Perataan yang menyelaraskan konten ke bagian tengah holder konten. Terkait dengan 'ctr' ECMA-376 ST_TextAnchoringType.
BOTTOM Perataan yang meratakan konten ke bagian bawah holder konten. Terkait dengan ECMA-376 ST_TextAnchoringType 'b'.

SaranTableCellStyle

Perubahan yang disarankan untuk TableCellStyle.

Representasi JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Kolom
tableCellStyle

object (TableCellStyle)

TableCellStyle yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan tableCellStyleSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Mask yang menunjukkan kolom mana pada TableCellStyle dasar yang telah diubah dalam saran ini.

TableCellStyleSuggestionState

Mask yang menunjukkan kolom mana pada TableCellStyle dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
Kolom
rowSpanSuggested

boolean

Menunjukkan apakah ada saran perubahan pada rowSpan.

columnSpanSuggested

boolean

Menunjukkan apakah ada saran perubahan pada columnSpan.

backgroundColorSuggested

boolean

Menunjukkan apakah ada saran perubahan pada backgroundColor.

borderLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderLeft.

borderRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderRight.

borderTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderTop.

borderBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada borderBottom.

paddingLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada paddingLeft.

paddingRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada paddingRight.

paddingTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada paddingTop.

paddingBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada paddingBottom.

contentAlignmentSuggested

boolean

Menunjukkan apakah ada saran perubahan pada contentAlignment.

TableRowStyle

Gaya yang diterapkan pada baris tabel.

Representasi JSON
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Kolom
minRowHeight

object (Dimension)

Tinggi minimum baris. Baris akan dirender di editor Dokumen pada tinggi yang sama dengan atau lebih besar dari nilai ini untuk menampilkan semua konten di sel baris.

tableHeader

boolean

Apakah baris merupakan header tabel atau tidak.

preventOverflow

boolean

Apakah baris tidak boleh melebihi batas halaman atau kolom.

DisarankanTableRowStyle

Perubahan yang disarankan untuk TableRowStyle.

Representasi JSON
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Kolom
tableRowStyle

object (TableRowStyle)

TableRowStyle yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan tableRowStyleSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Mask yang menunjukkan kolom mana pada TableRowStyle dasar yang telah diubah dalam saran ini.

TableRowStyleSuggestionState

Mask yang menunjukkan kolom mana pada TableRowStyle dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "minRowHeightSuggested": boolean
}
Kolom
minRowHeightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada minRowHeight.

GayaTabel

Gaya yang berlaku pada tabel.

Representasi JSON
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Kolom
tableColumnProperties[]

object (TableColumnProperties)

Properti setiap kolom.

Perhatikan bahwa di Dokumen, tabel berisi baris dan baris berisi sel, mirip dengan HTML. Jadi, properti untuk suatu baris dapat ditemukan pada tableRowStyle baris.

PropertiKolomTabel

Properti kolom dalam tabel.

Representasi JSON
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Kolom
widthType

enum (WidthType)

Jenis lebar kolom.

width

object (Dimension)

Lebar kolom. Tetapkan saat widthType kolom adalah FIXED_WIDTH.

Jenis Lebar

Jenis lebar kolom.

Enum
WIDTH_TYPE_UNSPECIFIED Jenis lebar kolom tidak ditentukan.
EVENLY_DISTRIBUTED

Lebar kolom didistribusikan secara merata di antara kolom lainnya yang didistribusikan secara merata.

Lebar kolom secara otomatis ditentukan dan akan memiliki bagian yang sama dari lebar yang tersisa untuk tabel setelah memperhitungkan semua kolom dengan lebar yang ditentukan.

FIXED_WIDTH Lebar kolom tetap. Properti [width][google.apps.docs.v1.TableColumnProperties.width] berisi lebar kolom.

{i>TableOfContents<i}

StructuralElement yang mewakili daftar isi.

Representasi JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Kolom
content[]

object (StructuralElement)

Isi daftar isi.

suggestedInsertionIds[]

string

ID penyisipan yang disarankan. TableOfContents dapat memiliki beberapa ID penyisipan jika merupakan perubahan yang disarankan bertingkat. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

Catatan Kaki

Catatan kaki dokumen.

Representasi JSON
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Kolom
footnoteId

string

ID catatan kaki.

content[]

object (StructuralElement)

Isi catatan kaki.

Indeks untuk konten catatan kaki dimulai dari nol.

DocumentStyle

Gaya dokumen.

Representasi JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
Kolom
background

object (Background)

Latar belakang dokumen. Dokumen tidak boleh memiliki warna latar belakang transparan.

defaultHeaderId

string

ID header default. Jika tidak disetel, tidak ada header default.

Properti ini bersifat hanya baca.

evenPageHeaderId

string

ID header hanya digunakan untuk halaman genap. Nilai useEvenPageHeaderFooter menentukan apakah akan menggunakan defaultHeaderId atau nilai ini untuk header di halaman genap. Jika tidak disetel, tidak akan ada header halaman genap.

Properti ini bersifat hanya baca.

firstPageHeaderId

string

ID header hanya digunakan untuk halaman pertama. Jika tidak ditetapkan, header unik untuk halaman pertama tidak akan ada. Nilai useFirstPageHeaderFooter menentukan apakah akan menggunakan defaultHeaderId atau nilai ini untuk header di halaman pertama. Jika tidak ditetapkan, header halaman pertama tidak akan tersedia.

Properti ini bersifat hanya baca.

pageNumberStart

integer

Nomor halaman untuk mulai menghitung jumlah halaman.

marginTop

object (Dimension)

Margin halaman atas.

Memperbarui margin halaman atas pada gaya dokumen akan menghapus margin halaman atas di semua gaya bagian.

marginBottom

object (Dimension)

Margin halaman bawah.

Memperbarui margin halaman bawah pada gaya dokumen akan menghapus margin halaman bawah pada semua gaya bagian.

marginRight

object (Dimension)

Margin halaman kanan.

Memperbarui margin halaman kanan pada gaya dokumen akan menghapus margin halaman kanan pada semua gaya bagian. Perubahan ini juga dapat menyebabkan kolom berubah ukuran di semua bagian.

marginLeft

object (Dimension)

Margin halaman kiri.

Memperbarui margin halaman kiri pada gaya dokumen akan menghapus margin halaman kiri pada semua gaya bagian. Perubahan ini juga dapat menyebabkan kolom berubah ukuran di semua bagian.

pageSize

object (Size)

Ukuran halaman dalam dokumen.

marginHeader

object (Dimension)

Jarak antara bagian atas halaman dan konten {i>header<i}.

flipPageOrientation

boolean

Opsional. Menunjukkan apakah dimensi pageSize akan dibalik, yang memungkinkan perubahan orientasi halaman antara potret dan lanskap.

Latar belakang

Menampilkan latar belakang dokumen.

Representasi JSON
{
  "color": {
    object (OptionalColor)
  }
}
Kolom
color

object (OptionalColor)

Warna latar belakang.

Ukuran

Lebar dan tinggi.

Representasi JSON
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Kolom
height

object (Dimension)

Tinggi objek.

width

object (Dimension)

Lebar objek.

GayaDokumen yang Disarankan

Perubahan yang disarankan untuk DocumentStyle.

Representasi JSON
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Kolom
documentStyle

object (DocumentStyle)

DocumentStyle yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan documentStyleSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Mask yang menunjukkan kolom mana pada DocumentStyle dasar yang telah diubah dalam saran ini.

DocumentStyleSuggestionState

Mask yang menunjukkan kolom mana pada DocumentStyle dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Kolom
backgroundSuggestionState

object (BackgroundSuggestionState)

Mask yang menunjukkan kolom mana di background yang telah diubah dalam saran ini.

defaultHeaderIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada firstPageHeaderId.

pageNumberStartSuggested

boolean

Menunjukkan apakah ada saran perubahan pada pageNumberStart.

marginTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginTop.

marginBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginBottom.

marginRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginRight.

marginLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Mask yang menunjukkan kolom mana dalam [ukuran] [google.apps.docs.v1.DocumentStyle.size] yang telah diubah dalam saran ini.

marginHeaderSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginHeader.

flipPageOrientationSuggested

boolean

Opsional. Menunjukkan apakah ada saran perubahan pada flipPageOrientation.

BackgroundSuggestionState

Mask yang menunjukkan kolom mana pada Background dasar yang telah diubah dalam saran ini. Untuk kolom yang ditetapkan ke benar (true), Backgound memiliki nilai baru yang disarankan.

Representasi JSON
{
  "backgroundColorSuggested": boolean
}
Kolom
backgroundColorSuggested

boolean

Menunjukkan apakah warna latar belakang saat ini telah diubah dalam saran ini.

SizeSuggestionState

Mask yang menunjukkan kolom mana pada Size dasar yang telah diubah dalam saran ini. Untuk kolom yang ditetapkan ke benar (true), Size memiliki nilai baru yang disarankan.

Representasi JSON
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Kolom
heightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada height.

widthSuggested

boolean

Menunjukkan apakah ada saran perubahan pada width.

GayaBernama

Gaya yang diberi nama. Paragraf dalam dokumen dapat mewarisi TextStyle dan ParagraphStyle dari gaya yang dinamai ini.

Representasi JSON
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Kolom
styles[]

object (NamedStyle)

Gaya yang diberi nama.

Ada entri untuk setiap named style types yang mungkin.

GayaBernama

Gaya yang telah diberi nama. Paragraf dalam dokumen dapat mewarisi TextStyle dan ParagraphStyle dari gaya bernama ini jika memiliki jenis gaya bernama yang sama.

Representasi JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Kolom
namedStyleType

enum (NamedStyleType)

Jenis gaya bernama ini.

textStyle

object (TextStyle)

Gaya teks dari gaya yang diberi nama ini.

paragraphStyle

object (ParagraphStyle)

Gaya paragraf dari gaya yang diberi nama ini.

GayaBernamayang Disarankan

Perubahan yang disarankan untuk NamedStyles.

Representasi JSON
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Kolom
namedStyles

object (NamedStyles)

NamedStyles yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan namedStylesSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Mask yang menunjukkan kolom mana pada NamedStyles dasar yang telah diubah dalam saran ini.

NamedStylesSuggestionState

Status saran pesan NamedStyles.

Representasi JSON
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Kolom
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Mask yang menunjukkan kolom mana pada NamedStyle terkait di styles yang telah diubah dalam saran ini.

Urutan status saran gaya bernama ini sesuai dengan urutan gaya bernama yang sesuai dalam saran named styles.

NamedStyleSuggestionState

Status saran pesan NamedStyle.

Representasi JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Kolom
namedStyleType

enum (NamedStyleType)

Jenis gaya bernama yang sesuai dengan status saran ini.

Kolom ini disediakan untuk memudahkan pencocokan NamedStyleSuggestionState dengan NamedStyle yang sesuai.

textStyleSuggestionState

object (TextStyleSuggestionState)

Mask yang menunjukkan kolom mana di text style yang telah diubah dalam saran ini.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Mask yang menunjukkan kolom mana di paragraph style yang telah diubah dalam saran ini.

Daftar

{i>List<i} merepresentasikan atribut daftar untuk sekelompok paragraf di mana semuanya berada dalam daftar yang sama. Paragraf yang merupakan bagian dari daftar memiliki referensi ke ID daftar dalam bullet.

Representasi JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Kolom
listProperties

object (ListProperties)

Properti daftar.

suggestedListPropertiesChanges

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

Perubahan yang disarankan pada properti daftar, yang dikunci oleh ID saran.

suggestedInsertionId

string

ID penyisipan yang disarankan. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada penghapusan yang disarankan untuk daftar ini.

{i>ListProperties<i}

Properti list yang mendeskripsikan tampilan dan nuansa butir dalam paragraf yang terkait dengan daftar.

Representasi JSON
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Kolom
nestingLevels[]

object (NestingLevel)

Mendeskripsikan properti butir di tingkat terkait.

Sebuah daftar memiliki paling banyak 9 tingkat sarang dengan tingkat susunan 0 yang berkaitan dengan tingkat paling atas dan tingkat sarang 8 yang sesuai dengan tingkat yang paling banyak disarangkan. Tingkat {i>nesting<i} ditampilkan dalam urutan menaik dengan nilai bertingkat yang paling sedikit ditampilkan terlebih dahulu.

Tingkat Nest

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

Representasi JSON
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Kolom
bulletAlignment

enum (BulletAlignment)

Perataan butir dalam ruang yang dialokasikan untuk merender butir.

glyphFormat

string

String format yang digunakan poin pada level penyusunan ini.

Format glyph berisi satu atau beberapa placeholder, dan placeholder ini diganti dengan nilai yang sesuai, bergantung pada glyphType atau glyphSymbol. Placeholder mengikuti pola %[nestingLevel]. Selain itu, placeholder dapat memiliki awalan dan akhiran. Dengan demikian, format glyph mengikuti pola <prefix>%[nestingLevel]<suffix>. Perhatikan bahwa awalan dan akhiran bersifat opsional dan dapat berupa string arbitrer.

Misalnya, format glyph %0. menunjukkan bahwa glyph yang dirender akan menggantikan placeholder dengan glyph yang sesuai untuk tingkat bertingkat 0, diikuti dengan titik sebagai akhiran. Jadi daftar dengan jenis glyph UPPER_ALPHA dan format glyph %0. pada tingkat susunan 0 akan menghasilkan daftar dengan glyph yang dirender

A.

B.

C.

Format glyph dapat berisi placeholder untuk tingkat sarang saat ini serta placeholder untuk tingkat sarang induk. Misalnya, daftar dapat memiliki format glyph %0. pada tingkat susunan 0 dan format glyph %0.%1. pada tingkat susunan 1. Dengan asumsi bahwa kedua tingkat bertingkat memiliki jenis glyph DECIMAL, hal ini akan menghasilkan daftar dengan glyph yang dirender

1.

2.

2.1.

2.2.

3.

Untuk tingkat bertingkat yang diurutkan, string yang menggantikan placeholder dalam format glyph untuk paragraf tertentu bergantung pada urutan paragraf dalam daftar.

indentFirstLine

object (Dimension)

Jumlah indentasi untuk baris pertama paragraf pada level penyusunan ini.

indentStart

object (Dimension)

Jumlah indentasi untuk paragraf pada level penyusunan ini. Diterapkan ke sisi yang sesuai dengan awal teks, berdasarkan arah konten paragraf.

textStyle

object (TextStyle)

Gaya teks poin pada level penyusunan ini.

startNumber

integer

Jumlah item daftar pertama di tingkat hierarki ini.

Nilai 0 diperlakukan sebagai nilai 1 untuk daftar berhuruf dan daftar angka Romawi. Untuk nilai 0 dan 1, daftar dengan huruf dan angka Romawi masing-masing akan dimulai pada a dan i.

Nilai ini diabaikan untuk tingkat bertingkat dengan glyph yang tidak diurutkan.

Kolom union glyph_kind. Jenis glyph yang digunakan oleh butir. Ini menentukan bullet-glyph yang menggantikan placeholder di glyph_format. glyph_kind hanya dapat berupa salah satu dari berikut:
glyphType

enum (GlyphType)

Jenis glyph yang digunakan oleh butir ketika paragraf pada tingkat tingkatan ini diurutkan.

Jenis glyph menentukan jenis glyph yang digunakan untuk mengganti placeholder dalam glyphFormat ketika paragraf pada tingkat tingkatan ini diurutkan. Misalnya, jika tingkat bertingkat adalah 0, glyphFormat adalah %0., dan jenis glyph DECIMAL, maka glyph yang dirender akan menggantikan placeholder %0 dalam format glyph dengan angka yang sesuai dengan urutan item daftar dalam daftar.

glyphSymbol

string

Simbol glyph kustom yang digunakan oleh butir ketika paragraf pada level bertingkat ini tidak berurutan.

Simbol glyph menggantikan placeholder dalam glyphFormat. Misalnya, jika glyphSymbol adalah lingkaran solid yang sesuai dengan titik kode Unicode U+25cf dan glyphFormat adalah %0, glyph yang dirender akan berupa lingkaran solid.

Perataan Butir

Jenis perataan untuk butir.

Enum
BULLET_ALIGNMENT_UNSPECIFIED Perataan butir tidak ditentukan.
START Butir ini sejajar dengan awal ruang yang dialokasikan untuk merender butir. Diratakan kiri untuk teks LTR, diratakan ke kanan.
CENTER Butir sejajar dengan bagian tengah ruang yang disediakan untuk merender butir.
END Butir disejajarkan dengan akhir ruang yang dialokasikan untuk merender butir. Diratakan kanan untuk teks LTR, dirata kiri jika tidak.

Jenis Glyph

Jenis glyph yang digunakan oleh butir ketika paragraf pada tingkat tingkatan ini diurutkan.

Enum
GLYPH_TYPE_UNSPECIFIED Jenis glyph tidak ditentukan atau tidak didukung.
NONE String kosong.
DECIMAL Angka, seperti 1, 2, atau 3.
ZERO_DECIMAL Angka dengan angka satu digit diawali dengan nol, seperti 01, 02, atau 03. Angka dengan lebih dari satu digit tidak akan diawali dengan angka nol.
UPPER_ALPHA Huruf besar, seperti A, B, atau C.
ALPHA Huruf kecil, seperti a, b, atau c.
UPPER_ROMAN Angka Romawi huruf besar, seperti I, II, atau III.
ROMAN Angka Romawi huruf kecil, seperti i, ii, atau iii.

DisarankanListProperties

Perubahan yang disarankan untuk ListProperties.

Representasi JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Kolom
listProperties

object (ListProperties)

ListProperties yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan listPropertiesSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Mask yang menunjukkan kolom mana pada ListProperties dasar yang telah diubah dalam saran ini.

ListPropertiesSuggestionState

Mask yang menunjukkan kolom mana pada ListProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Kolom
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Mask yang menunjukkan kolom mana pada NestingLevel terkait di nestingLevels yang telah diubah dalam saran ini.

Status saran tingkat bertingkat ditampilkan dalam urutan menaik dari level bertingkat dengan hierarki bertingkat paling sedikit ditampilkan terlebih dahulu.

NestingLevelSuggestionState

Mask yang menunjukkan kolom mana pada NestingLevel dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Kolom
bulletAlignmentSuggested

boolean

Menunjukkan apakah ada saran perubahan pada bulletAlignment.

glyphTypeSuggested

boolean

Menunjukkan apakah ada saran perubahan pada glyphType.

glyphFormatSuggested

boolean

Menunjukkan apakah ada saran perubahan pada glyphFormat.

glyphSymbolSuggested

boolean

Menunjukkan apakah ada saran perubahan pada glyphSymbol.

indentFirstLineSuggested

boolean

Menunjukkan apakah ada saran perubahan pada indentFirstLine.

indentStartSuggested

boolean

Menunjukkan apakah ada saran perubahan pada indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

Mask yang menunjukkan kolom mana di text style yang telah diubah dalam saran ini.

startNumberSuggested

boolean

Menunjukkan apakah ada saran perubahan pada startNumber.

RentangBernama

Koleksi semua NamedRange dalam dokumen yang memiliki nama tertentu.

Representasi JSON
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Kolom
name

string

Nama yang digunakan bersama oleh semua named ranges.

namedRanges[]

object (NamedRange)

NamedRange yang memiliki nama yang sama.

RentangBernama

Koleksi Range dengan ID rentang bernama yang sama.

Rentang bernama memungkinkan developer mengaitkan bagian dokumen dengan label arbitrer yang ditentukan pengguna sehingga kontennya dapat dibaca atau diedit secara terprogram nanti. Dokumen dapat berisi beberapa rentang bernama dengan nama yang sama, tetapi setiap rentang bernama memiliki ID unik.

Rentang bernama dibuat dengan satu Range, dan konten yang disisipkan ke dalam rentang bernama umumnya memperluas rentang tersebut. Namun, perubahan dokumen tertentu dapat menyebabkan rentang dibagi menjadi beberapa rentang.

Rentang bernama tidak bersifat pribadi. Semua aplikasi dan kolaborator yang memiliki akses ke dokumen dapat melihat rentang bernama dokumen.

Representasi JSON
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Kolom
namedRangeId

string

ID rentang bernama.

name

string

Nama rentang bernama.

ranges[]

object (Range)

Rentang yang termasuk dalam rentang bernama ini.

Rentang

Menentukan rentang teks yang berdekatan.

Representasi JSON
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer
}
Kolom
segmentId

string

ID header, footer, atau catatan kaki yang mencakup rentang ini. ID segmen kosong menandakan isi dokumen.

startIndex

integer

Indeks awal berbasis nol dari rentang ini, dalam unit kode UTF-16.

Untuk semua penggunaan saat ini, indeks awal harus disediakan. Kolom ini merupakan Int32Value untuk mengakomodasi kasus penggunaan di masa mendatang dengan rentang terbuka.

endIndex

integer

Indeks akhir berbasis nol dari rentang ini, eksklusif, dalam unit kode UTF-16.

Untuk semua penggunaan saat ini, indeks akhir harus disediakan. Kolom ini merupakan Int32Value untuk mengakomodasi kasus penggunaan di masa mendatang dengan rentang terbuka.

SaranViewMode

Mode tampilan saran yang diterapkan pada dokumen yang menunjukkan bagaimana perubahan yang disarankan ditunjukkan. Memberikan opsi untuk membaca dokumen dengan semua saran secara inline, diterima, atau ditolak.

Enum
DEFAULT_FOR_CURRENT_ACCESS SaranViewMode yang diterapkan ke dokumen yang ditampilkan bergantung pada tingkat akses pengguna saat ini. Jika pengguna hanya memiliki akses lihat, PREVIEW_WITHOUT_SUGGESTIONS akan diterapkan. Jika tidak, SUGGESTIONS_INLINE akan diterapkan. Ini adalah mode tampilan saran default.
SUGGESTIONS_INLINE

Dokumen yang ditampilkan memiliki saran inline. Perubahan yang disarankan akan dibedakan dari konten dasar dalam dokumen.

Permintaan untuk mengambil dokumen menggunakan mode ini akan menampilkan error 403 jika pengguna tidak memiliki izin untuk melihat perubahan yang disarankan.

PREVIEW_SUGGESTIONS_ACCEPTED

Dokumen yang ditampilkan adalah pratinjau dengan semua perubahan yang disarankan diterima.

Permintaan untuk mengambil dokumen menggunakan mode ini akan menampilkan error 403 jika pengguna tidak memiliki izin untuk melihat perubahan yang disarankan.

PREVIEW_WITHOUT_SUGGESTIONS Dokumen yang ditampilkan adalah pratinjau dengan semua perubahan yang disarankan akan ditolak jika ada saran dalam dokumen.

{i>InlineObject<i}

Objek yang muncul inline dengan teks. InlineObject berisi EmbeddedObject seperti gambar.

Representasi JSON
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Kolom
objectId

string

ID objek inline ini. Dapat digunakan untuk memperbarui properti objek.

inlineObjectProperties

object (InlineObjectProperties)

Properti objek inline ini.

suggestedInlineObjectPropertiesChanges

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

Perubahan yang disarankan pada properti objek inline, yang dikunci oleh ID saran.

suggestedInsertionId

string

ID penyisipan yang disarankan. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

{i>InlineObjectProperties<i}

Properti InlineObject.

Representasi JSON
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Kolom
embeddedObject

object (EmbeddedObject)

Objek yang disematkan dari objek inline ini.

EmbeddedObject

Objek yang disematkan dalam dokumen.

Representasi JSON
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Kolom
title

string

Judul objek yang disematkan. title dan description digabungkan untuk menampilkan teks alternatif.

description

string

Deskripsi objek yang disematkan. title dan description digabungkan untuk menampilkan teks alternatif.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Batas objek yang disematkan.

size

object (Size)

Ukuran gambar yang terlihat setelah pemangkasan.

marginTop

object (Dimension)

Margin atas objek yang disematkan.

marginBottom

object (Dimension)

Margin bawah objek yang disematkan.

marginRight

object (Dimension)

Margin kanan objek yang disematkan.

marginLeft

object (Dimension)

Margin kiri objek yang disematkan.

linkedContentReference

object (LinkedContentReference)

Referensi ke konten sumber link eksternal. Misalnya, objek ini berisi referensi ke diagram Google Spreadsheet sumber jika objek yang disematkan adalah diagram tertaut.

Jika tidak disetel, objek yang disematkan tidak akan ditautkan.

Kolom union properties. Properti yang spesifik untuk setiap jenis objek yang disematkan. properties hanya dapat berupa salah satu dari berikut:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Properti gambar tersemat.

imageProperties

object (ImageProperties)

Properti gambar.

PropertiGambar yang Disematkan

Jenis ini tidak memiliki kolom.

Properti gambar tersemat dan digunakan untuk membedakan jenis objek. Gambar yang disematkan adalah gambar yang dibuat dan diedit dalam dokumen. Perhatikan bahwa detail yang lengkap tidak didukung.

PropertiGambar

Properti gambar.

Representasi JSON
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Kolom
contentUri

string

URI ke gambar dengan masa aktif default 30 menit. URI ini diberi tag dengan akun pemohon. Siapa saja yang memiliki URI secara efektif mengakses gambar sebagai pemohon asli. Akses ke gambar mungkin hilang jika setelan berbagi dokumen berubah.

sourceUri

string

URI sumber adalah URI yang digunakan untuk menyisipkan gambar. URI sumber boleh kosong.

brightness

number

Efek kecerahan gambar. Nilainya harus dalam interval [-1.0, 1.0], dengan 0 berarti tidak ada pengaruh.

contrast

number

Efek kontras gambar. Nilainya harus dalam interval [-1.0, 1.0], dengan 0 berarti tidak ada pengaruh.

transparency

number

Efek transparansi gambar. Nilainya harus dalam interval [0,0, 1,0], di mana 0 berarti tidak ada efek dan 1 berarti transparan.

cropProperties

object (CropProperties)

Properti pangkas gambar.

angle

number

Sudut rotasi gambar searah jarum jam, dalam radian.

Properti Crop

Properti pangkas gambar.

Persegi panjang pangkas diwakili menggunakan offset pecahan dari 4 tepi konten asli.

  • Jika offset berada dalam interval (0, 1), tepi yang sesuai dari persegi panjang pangkas diposisikan di dalam persegi panjang pembatas asli gambar.
  • Jika offset negatif atau lebih besar dari 1, tepi kotak pangkas yang sesuai diposisikan di luar persegi panjang pembatas asli gambar.
  • Jika semua offset dan sudut rotasi adalah 0, gambar tidak akan dipangkas.
Representasi JSON
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Kolom
offsetLeft

number

Offset menentukan seberapa jauh tepi kiri kotak pangkas dari tepi kiri konten asli sebagai bagian kecil dari lebar konten asli.

offsetRight

number

Offset menentukan seberapa jauh tepi kanan kotak pangkas dari tepi kanan konten asli ke dalam ukuran kecil dari lebar konten asli.

offsetTop

number

Offset menentukan seberapa jauh tepi atas kotak pangkas dari tepi atas konten asli ke dalam kecil dari tinggi konten asli.

offsetBottom

number

Offset menentukan seberapa jauh ke dalam tepi bawah kotak pangkas dari tepi bawah konten asli sebagai pecahan dari tinggi konten asli.

angle

number

Sudut rotasi searah jarum jam pada persegi panjang pangkas di sekitar pusatnya, dalam radian. Rotasi diterapkan setelah offset.

EmbeddedObjectBorder

Batas di sekitar EmbeddedObject.

Representasi JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Kolom
color

object (OptionalColor)

Warna batas.

width

object (Dimension)

Lebar batas.

dashStyle

enum (DashStyle)

Gaya garis putus-putus batas.

propertyState

enum (PropertyState)

Status properti properti batas.

Status Properti

Kemungkinan status properti.

Enum
RENDERED Jika status properti adalah RENDERED, elemen tersebut memiliki properti yang sesuai saat dirender dalam dokumen. Nilai ini merupakan default.
NOT_RENDERED Jika status properti adalah NOT_RENDERED, elemen tidak memiliki properti yang sesuai saat dirender dalam dokumen.

LinkedContentReference

Referensi ke konten sumber link eksternal.

Representasi JSON
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Kolom
Kolom union reference. Referensi khusus untuk jenis konten yang ditautkan. reference hanya dapat berupa salah satu dari berikut:
sheetsChartReference

object (SheetsChartReference)

Referensi ke diagram tertaut.

SheetsChartReference

Referensi ke diagram tertaut yang disematkan dari Google Spreadsheet.

Representasi JSON
{
  "spreadsheetId": string,
  "chartId": integer
}
Kolom
spreadsheetId

string

ID spreadsheet Google Spreadsheet yang berisi diagram sumber.

chartId

integer

ID diagram tertentu dalam spreadsheet Google Spreadsheet yang disematkan.

DisarankanInlineObjectProperties

Perubahan yang disarankan untuk InlineObjectProperties.

Representasi JSON
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Kolom
inlineObjectProperties

object (InlineObjectProperties)

InlineObjectProperties yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan inlineObjectPropertiesSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Mask yang menunjukkan kolom mana pada InlineObjectProperties dasar yang telah diubah dalam saran ini.

InlineObjectPropertiesSuggestionState

Mask yang menunjukkan kolom mana pada InlineObjectProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Kolom
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Mask yang menunjukkan kolom mana di embeddedObject yang telah diubah dalam saran ini.

EmbeddedObjectSuggestionState

Mask yang menunjukkan kolom mana pada EmbeddedObject dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Kolom
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Mask yang menunjukkan kolom mana di embeddedDrawingProperties yang telah diubah dalam saran ini.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Mask yang menunjukkan kolom mana di imageProperties yang telah diubah dalam saran ini.

titleSuggested

boolean

Menunjukkan apakah ada saran perubahan pada title.

descriptionSuggested

boolean

Menunjukkan apakah ada saran perubahan pada description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Mask yang menunjukkan kolom mana di embeddedObjectBorder yang telah diubah dalam saran ini.

sizeSuggestionState

object (SizeSuggestionState)

Mask yang menunjukkan kolom mana di size yang telah diubah dalam saran ini.

marginLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginLeft.

marginRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginRight.

marginTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginTop.

marginBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Mask yang menunjukkan kolom mana di linkedContentReference yang telah diubah dalam saran ini.

EmbeddedDrawingPropertiesSuggestionState

Jenis ini tidak memiliki kolom.

Mask yang menunjukkan kolom mana pada EmbeddedDrawingProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

ImagePropertiesSuggestionState

Mask yang menunjukkan kolom mana pada ImageProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Kolom
contentUriSuggested

boolean

Menunjukkan apakah ada saran perubahan pada contentUri.

sourceUriSuggested

boolean

Menunjukkan apakah ada saran perubahan untuk [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

Menunjukkan apakah ada saran perubahan pada [brightness] [google.apps.docs.v1.EmbeddedObject.brightness].

contrastSuggested

boolean

Menunjukkan apakah ada saran perubahan untuk [kontras] [google.apps.docs.v1.EmbeddedObject.Contrast].

transparencySuggested

boolean

Menunjukkan jika ada saran perubahan pada [transparency] [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Mask yang menunjukkan kolom mana di cropProperties yang telah diubah dalam saran ini.

angleSuggested

boolean

Menunjukkan apakah ada saran perubahan pada [angle] [google.apps.docs.v1.EmbeddedObject.angle].

CropPropertiesSuggestionState

Mask yang menunjukkan kolom mana pada CropProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Kolom
offsetLeftSuggested

boolean

Menunjukkan apakah ada saran perubahan pada offsetLeft.

offsetRightSuggested

boolean

Menunjukkan apakah ada saran perubahan pada offsetRight.

offsetTopSuggested

boolean

Menunjukkan apakah ada saran perubahan pada offsetTop.

offsetBottomSuggested

boolean

Menunjukkan apakah ada saran perubahan pada offsetBottom.

angleSuggested

boolean

Menunjukkan apakah ada saran perubahan pada angle.

EmbeddedObjectBorderSuggestionState

Mask yang menunjukkan kolom mana pada EmbeddedObjectBorder dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Kolom
colorSuggested

boolean

Menunjukkan apakah ada saran perubahan pada [color] [google.apps.docs.v1.EmbeddedBorderObject.color].

widthSuggested

boolean

Menunjukkan apakah ada perubahan yang disarankan pada [width] [google.apps.docs.v1.EmbeddedBorderObject.width].

dashStyleSuggested

boolean

Menunjukkan apakah ada saran perubahan pada [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style].

propertyStateSuggested

boolean

Menunjukkan apakah ada saran perubahan pada [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state].

LinkedContentReferenceSuggestionState

Mask yang menunjukkan kolom mana pada LinkedContentReference dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
Kolom
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

Mask yang menunjukkan kolom mana di sheetsChartReference yang telah diubah dalam saran ini.

SheetsChartReferenceSuggestionState

Mask yang menunjukkan kolom mana pada SheetsChartReference dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Kolom
spreadsheetIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada spreadsheetId.

chartIdSuggested

boolean

Menunjukkan apakah ada saran perubahan pada chartId.

{i>PositionedObject<i}

Objek yang di-tether ke Paragraph dan diposisikan sesuai dengan awal paragraf. PositionedObject berisi EmbeddedObject seperti gambar.

Representasi JSON
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Kolom
objectId

string

ID objek yang diposisikan ini.

positionedObjectProperties

object (PositionedObjectProperties)

Properti objek yang diposisikan ini.

suggestedPositionedObjectPropertiesChanges

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

Perubahan yang disarankan pada properti objek yang diposisikan, dikunci oleh ID saran.

suggestedInsertionId

string

ID penyisipan yang disarankan. Jika kosong, ini bukan penyisipan yang disarankan.

suggestedDeletionIds[]

string

ID penghapusan yang disarankan. Jika kosong, tidak ada saran penghapusan konten ini.

{i>PositionedObjectProperties<i}

Properti PositionedObject.

Representasi JSON
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Kolom
positioning

object (PositionedObjectPositioning)

Pemosisian objek yang diposisikan ini relatif terhadap baris baru Paragraph yang mereferensikan objek yang diposisikan ini.

embeddedObject

object (EmbeddedObject)

Objek tersemat dari objek yang diposisikan ini.

PositionedObjectPositioning

Pengaturan posisi PositionedObject. Objek yang diposisikan diposisikan sesuai dengan awal Paragraph yang di-tethering.

Representasi JSON
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Kolom
layout

enum (PositionedObjectLayout)

Tata letak objek yang diposisikan ini.

leftOffset

object (Dimension)

Offset tepi kiri objek yang diposisikan relatif terhadap awal Paragraph tempatnya di-tethering. Pengaturan posisi objek yang tepat dapat bergantung pada konten lain dalam dokumen dan gaya dokumen.

topOffset

object (Dimension)

Offset tepi atas objek yang diposisikan terkait dengan awal Paragraph tempatnya di-tethering. Pengaturan posisi objek yang tepat dapat bergantung pada konten lain dalam dokumen dan gaya dokumen.

{i>PositionedObjectLayout<i}

Kemungkinan tata letak [PositionedObject][google.aps.docs.v1.PositionedObject].

Enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Tata letak tidak ditentukan.
WRAP_TEXT Teks membungkus di sekitar objek yang diposisikan.
BREAK_LEFT Memutuskan teks sedemikian rupa sehingga objek yang diposisikan berada di sebelah kiri dan teks berada di sebelah kanan.
BREAK_RIGHT Menghentikan teks sedemikian rupa sehingga objek yang diposisikan di sebelah kanan dan teks berada di sebelah kiri.
BREAK_LEFT_RIGHT Memecah teks sedemikian rupa sehingga tidak ada teks di sebelah kiri atau kanan objek yang diposisikan.
IN_FRONT_OF_TEXT Objek yang diposisikan berada di depan teks.
BEHIND_TEXT Objek yang diposisikan berada di belakang teks.

DisarankanPositionedObjectProperties

Perubahan yang disarankan untuk PositionedObjectProperties.

Representasi JSON
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Kolom
positionedObjectProperties

object (PositionedObjectProperties)

PositionedObjectProperties yang hanya menyertakan perubahan yang dibuat dalam saran ini. Fungsi ini dapat digunakan bersama dengan positionedObjectPropertiesSuggestionState untuk melihat kolom mana yang telah berubah dan nilai barunya.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Mask yang menunjukkan kolom mana pada PositionedObjectProperties dasar yang telah diubah dalam saran ini.

PositionedObjectPropertiesSuggestionState

Mask yang menunjukkan kolom mana pada PositionedObjectProperties dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Kolom
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Mask yang menunjukkan kolom mana di positioning yang telah diubah dalam saran ini.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Mask yang menunjukkan kolom mana di embeddedObject yang telah diubah dalam saran ini.

PositionedObjectPositioningSuggestionState

Mask yang menunjukkan kolom mana pada PositionedObjectPositioning dasar yang telah diubah dalam saran ini. Untuk setiap kolom yang ditetapkan ke true, ada nilai baru yang disarankan.

Representasi JSON
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Kolom
layoutSuggested

boolean

Menunjukkan apakah ada saran perubahan pada layout.

leftOffsetSuggested

boolean

Menunjukkan apakah ada saran perubahan pada leftOffset.

topOffsetSuggested

boolean

Menunjukkan apakah ada saran perubahan pada topOffset.

Metode

batchUpdate

Menerapkan satu atau beberapa pembaruan ke dokumen.

create

Membuat dokumen kosong menggunakan judul yang diberikan dalam permintaan.

get

Mendapatkan versi terbaru dari dokumen yang ditentukan.