ส่งคำขอ
การอัปเดตเดียวที่จะใช้กับเอกสาร
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
request คําขอเฉพาะที่ใช้ ต้องป้อนเพียง 1 ช่องเท่านั้น
request
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
replaceAllText
|
แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ระบุ |
insertText
|
แทรกข้อความที่ตําแหน่งที่ระบุ |
updateTextStyle
|
อัปเดตรูปแบบข้อความในช่วงที่ระบุ |
createParagraphBullets
|
สร้างหัวข้อย่อยสําหรับย่อหน้า |
deleteParagraphBullets
|
ลบหัวข้อย่อยออกจากย่อหน้า |
createNamedRange
|
สร้างช่วงที่มีชื่อ |
deleteNamedRange
|
ลบช่วงที่ตั้งชื่อแล้ว |
updateParagraphStyle
|
อัปเดตรูปแบบย่อหน้าในช่วงที่ระบุ |
deleteContentRange
|
ลบเนื้อหาออกจากเอกสาร |
insertInlineImage
|
แทรกรูปภาพในบรรทัดในตําแหน่งที่ระบุ |
insertTable
|
แทรกตารางในตําแหน่งที่ระบุ |
insertTableRow
|
แทรกแถวที่ว่างเปล่าลงในตาราง |
insertTableColumn
|
แทรกคอลัมน์ที่ว่างเปล่าลงในตาราง |
deleteTableRow
|
ลบแถวออกจากตาราง |
deleteTableColumn
|
ลบคอลัมน์ออกจากตาราง |
insertPageBreak
|
แทรกตัวแบ่งหน้าในตําแหน่งที่ระบุ |
deletePositionedObject
|
ลบวัตถุที่วางตําแหน่งออกจากเอกสาร |
updateTableColumnProperties
|
อัปเดตคุณสมบัติของคอลัมน์ในตาราง |
updateTableCellStyle
|
อัปเดตรูปแบบของเซลล์ตาราง |
updateTableRowStyle
|
อัปเดตรูปแบบแถวในตาราง |
replaceImage
|
แทนที่รูปภาพในเอกสาร |
updateDocumentStyle
|
อัปเดตรูปแบบของเอกสาร |
mergeTableCells
|
ผสานเซลล์ในตาราง |
unmergeTableCells
|
เลิกผสานเซลล์ในตาราง |
createHeader
|
สร้างส่วนหัว |
createFooter
|
สร้างส่วนท้าย |
createFootnote
|
สร้างเชิงอรรถ |
replaceNamedRangeContent
|
แทนที่เนื้อหาในช่วงที่มีชื่อ |
updateSectionStyle
|
อัปเดตรูปแบบหัวข้อของช่วงที่ระบุ |
insertSectionBreak
|
แทรกตัวแบ่งส่วนในตําแหน่งที่ระบุ |
deleteHeader
|
ลบส่วนหัวออกจากเอกสาร |
deleteFooter
|
ลบส่วนท้ายออกจากเอกสาร |
pinTableHeaderRows
|
อัปเดตจํานวนแถวส่วนหัวที่ปักหมุดในตาราง |
คําขอแทนที่ข้อความทั้งหมด
แทนที่ข้อความทุกข้อความที่ตรงกับเกณฑ์ด้วย replace text
การแสดง JSON |
---|
{ "replaceText": string, // Union field |
ช่อง | |
---|---|
replaceText
|
ข้อความที่จะแทนที่ข้อความที่ตรงกัน |
ช่อง Union
criteria เกณฑ์ที่ใช้ในการจับคู่ข้อความเพื่อแทนที่
criteria
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
containsText
|
ค้นหาข้อความในเอกสารที่ตรงกับสตริงย่อยนี้ |
สตริงย่อยของเกณฑ์
เกณฑ์ที่ตรงกับสตริงข้อความที่เฉพาะเจาะจงในเอกสาร
การแสดง JSON |
---|
{ "text": string, "matchCase": boolean } |
ช่อง | |
---|---|
text
|
ข้อความที่จะค้นหาในเอกสาร |
matchCase
|
ระบุว่าการค้นหาควรคํานึงถึงตัวพิมพ์เล็กหรือใหญ่หรือไม่ ดังนี้
|
ใส่ข้อความคําขอ
แทรกข้อความที่ตําแหน่งที่ระบุ
การแสดง JSON |
---|
{ "text": string, // Union field |
ช่อง | |
---|---|
text
|
ข้อความที่จะแทรก
การแทรกอักขระขึ้นบรรทัดใหม่จะสร้าง ระบบจะกําหนดรูปแบบข้อความที่ถูกแทรกโดยอัตโนมัติ และโดยทั่วไปจะคงการจัดรูปแบบข้อความใกล้เคียงไว้ โดยส่วนใหญ่แล้ว สไตล์ข้อความสําหรับข้อความที่แทรกจะจับคู่กับข้อความก่อนดัชนีการแทรก อักขระควบคุม (U+0000-U+0008, U+000C-U+001F) และอักขระจากพื้นที่ใช้งานส่วนตัวแบบระนาบพื้นฐาน Unicode (U+E000-U+F8FF) จะถูกตัดออกจากข้อความที่แทรก |
ช่อง Union
insertion_location ตําแหน่งที่จะแทรกข้อความ
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกข้อความในดัชนีที่ต้องการในเอกสาร
ข้อความต้องแทรกอยู่ภายในขอบเขตของ |
endOfSegmentLocation
|
แทรกข้อความท้ายส่วนหัว ส่วนท้าย หรือเชิงอรรถ |
ตำแหน่ง
ตําแหน่งที่เจาะจงในเอกสาร
การแสดง JSON |
---|
{ "segmentId": string, "index": integer } |
ช่อง | |
---|---|
segmentId
|
รหัสของส่วนหัว ส่วนท้าย หรือเชิงอรรถของตําแหน่งที่ตั้ง รหัสกลุ่มว่างเปล่าคือส่วนเนื้อหาของเอกสาร |
index
|
ดัชนีแบบ 0 ในหน่วยโค้ด UTF-16
ดัชนีนี้จะสัมพันธ์กับส่วนต้นของส่วนที่ระบุโดย |
ตําแหน่งสิ้นสุดของกลุ่ม
ตําแหน่งที่อยู่ท้ายเนื้อหา ส่วนหัว ส่วนท้าย หรือเชิงอรรถ ตําแหน่งจะอยู่ก่อนบรรทัดใหม่สุดท้ายในกลุ่มเอกสาร
การแสดง JSON |
---|
{ "segmentId": string } |
ช่อง | |
---|---|
segmentId
|
รหัสของส่วนหัว ส่วนท้าย หรือเชิงอรรถของตําแหน่งที่ตั้ง รหัสกลุ่มว่างเปล่าคือส่วนเนื้อหาของเอกสาร |
อัปเดตรูปแบบข้อความคําขอ
อัปเดตการจัดรูปแบบข้อความ
การแสดง JSON |
---|
{ "textStyle": { object ( |
ช่อง | |
---|---|
textStyle
|
รูปแบบที่ตั้งค่าในข้อความ หากค่าสําหรับสไตล์เฉพาะตรงกับค่าระดับบนสุด สไตล์นั้นจะได้รับการตั้งค่าไปรับค่าเดิม
การเปลี่ยนแปลงรูปแบบข้อความบางอย่างอาจทําให้เกิดการเปลี่ยนแปลงอื่นๆ เหมือนกับการทํางานของเครื่องมือแก้ไขเอกสาร ดูข้อมูลเพิ่มเติมในเอกสารของ |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
เช่น หากต้องการอัปเดตรูปแบบข้อความเป็นตัวหนา ให้ตั้งค่า หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อของช่องนั้นไว้ในมาสก์ของช่องโดยไม่ต้องตั้งค่าใดๆ |
ช่อง Union
insertion_location ประเภทของช่วงที่ใช้อัปเดตรูปแบบข้อความ
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
range
|
ช่วงของข้อความเพื่อจัดรูปแบบ สามารถขยายช่วงเพื่อรวมบรรทัดใหม่ที่อยู่ติดกัน หากช่วงดังกล่าวมีย่อหน้าที่เป็นของรายการโดยสมบูรณ์ หัวข้อย่อยของย่อหน้าก็จะมีการอัปเดตด้วยรูปแบบข้อความที่ตรงกัน แทรกช่วงภายใน UpdateTextStyleRequest แบบสัมพัทธ์ไม่ได้ |
CreateParagraphBulletsRequest
สร้างหัวข้อย่อยของทุกย่อหน้าที่ซ้อนทับกับช่วงที่ระบุ
ระดับที่ซ้อนกันของแต่ละย่อหน้าจะกําหนดโดยการนับแท็บหน้าหน้าแต่ละย่อหน้า หากต้องการหลีกเลี่ยงพื้นที่เกินระหว่างหัวข้อย่อยและย่อหน้าที่เกี่ยวข้อง แท็บที่ติดอยู่เหล่านี้จะถูกลบออกโดยคําขอนี้ การดําเนินการนี้อาจเปลี่ยนแปลงดัชนีของส่วนต่างๆ ของข้อความ
หากย่อหน้าก่อนย่อหน้าที่อัปเดตได้รับการอัปเดตอยู่ในรายการชุดค่าที่กําหนดล่วงหน้าที่ตรงกัน ระบบจะเพิ่มย่อหน้าที่กําลังอัปเดตลงในรายชื่อดังกล่าว
การแสดง JSON |
---|
{ "range": { object ( |
ช่อง | |
---|---|
range
|
ช่วงที่จะใช้ค่าที่กําหนดล่วงหน้าของหัวข้อย่อย |
bulletPreset
|
ชนิดของสัญลักษณ์หัวข้อย่อยที่จะใช้ |
ค่าที่กําหนดล่วงหน้าของ BulletGlyph
รูปแบบที่กําหนดไว้ของสัญลักษณ์หัวข้อย่อยของรายการ
รูปแบบเหล่านี้ใช้หัวข้อย่อยต่อไปนี้
-
ARROW
: ลูกศรที่สอดคล้องกับโค้ดจุด Unicode U+2794 -
ARROW3D
: ลูกศรที่มีแรเงา 3 มิติ ซึ่งสัมพันธ์กับจุดโค้ด Unicode U+27a2 -
CHECKBOX
: สี่เหลี่ยมจัตุรัสโปร่งซึ่งสอดคล้องกับจุดโค้ด Unicode U+274f -
CIRCLE
: วงกลมแบบกลวง ซึ่งสัมพันธ์กับจุดโค้ด Unicode U+25cb -
DIAMOND
: ข้าวหลามตัดแบบแข็งที่สัมพันธ์กับรหัสจุด Unicode U+25c6 -
DIAMONDX
: ไดมอนด์ที่มี "x" สอดคล้องกับโค้ดจุด Unicode U+2756 -
HOLLOWDIAMOND
: ข้าวหลามตัดแบบโปร่งจะแสดงในจุดโค้ด Unicode U+25c7 -
DISC
: วงกลมสีทึบ ซึ่งสัมพันธ์กับจุดโค้ด Unicode U+25cf -
SQUARE
: สี่เหลี่ยมจัตุรัสทึบที่สอดคล้องกับจุดโค้ด Unicode U+25a0 -
STAR
: ดาวที่สัมพันธ์กับจุดโค้ด Unicode U+2605 -
ALPHA
: อักษรตัวพิมพ์เล็ก เช่น "a", "b" หรือ "c" -
UPPERALPHA
: ตัวอักษรพิมพ์ใหญ่ เช่น "A" "B" หรือ "C" -
DECIMAL
: ตัวเลข เช่น '1', '2' หรือ '3' -
ZERODECIMAL
: ตัวเลขที่มีตัวเลข 1 ตัวนําหน้าด้วย 0 เช่น "01" "02" หรือ "03" ตัวเลขที่มีมากกว่า 1 หลักจะไม่ขึ้นต้นด้วย 0 -
ROMAN
: ตัวเลขโรมันตัวพิมพ์เล็ก เช่น "i", "ii" หรือ "iii" -
UPPERROMAN
: เลขโรมันแบบอักษรตัวใหญ่ เช่น "I" "III" หรือ "III" -
LEFTTRIANGLE
: สามเหลี่ยมชี้ไปทางซ้าย ซึ่งสอดคล้องกับโค้ด Unicode U+25c4
Enum | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
ไม่ได้ระบุค่าที่กําหนดล่วงหน้าของสัญลักษณ์หัวข้อย่อย |
BULLET_DISC_CIRCLE_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย DISC , CIRCLE และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย DIAMONDX , ARROW3D และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_CHECKBOX
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย CHECKBOX สําหรับระดับที่ซ้อนกันทุกรายการ
|
BULLET_ARROW_DIAMOND_DISC
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย ARROW , DIAMOND และ DISC สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_STAR_CIRCLE_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย STAR , CIRCLE และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย ARROW3D , CIRCLE และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย LEFTTRIANGLE , DIAMOND และ DISC สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย DIAMONDX , HOLLOWDIAMOND และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
รายการสัญลักษณ์หัวข้อย่อยที่มีสัญลักษณ์หัวข้อย่อย DIAMOND , CIRCLE และ SQUARE สําหรับระดับการซ้อน 3 รายการแรก
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
รายการลําดับเลขที่มีสัญลักษณ์ตัวเลข DECIMAL , ALPHA และ ROMAN สําหรับระดับการซ้อน 3 รายการแรกตามด้วยเครื่องหมายจุด
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
รายการลําดับเลขที่มีสัญลักษณ์ตัวเลข DECIMAL , ALPHA และ ROMAN สําหรับระดับการซ้อน 3 รายการแรก ตามด้วยวงเล็บ
|
NUMBERED_DECIMAL_NESTED
|
รายการลําดับเลขที่มีรูปอักขระตัวเลข DECIMAL ตัวคั่นด้วยจุด ซึ่งระดับการซ้อนแต่ละระดับจะใช้สัญลักษณ์รูประดับการซ้อนก่อนหน้าเป็นคํานําหน้า ตัวอย่างเช่น: '1.', "1.1." "2.", "2.2."
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
รายการลําดับเลขที่มีสัญลักษณ์ตัวเลข UPPERALPHA , ALPHA และ ROMAN สําหรับระดับการซ้อน 3 รายการแรกตามด้วยเครื่องหมายจุด
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
รายการลําดับเลขที่มีสัญลักษณ์ตัวเลข UPPERROMAN , UPPERALPHA และ DECIMAL สําหรับระดับการซ้อน 3 รายการแรกตามด้วยเครื่องหมายจุด
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
รายการลําดับเลขที่มีสัญลักษณ์ตัวเลข ZERODECIMAL , ALPHA และ ROMAN สําหรับระดับการซ้อน 3 รายการแรกตามด้วยเครื่องหมายจุด
|
ลบย่อหน้าหัวข้อย่อย
ลบหัวข้อย่อยออกจากทุกย่อหน้าที่ซ้อนทับกับช่วงที่กําหนด
ระดับที่ซ้อนกันของแต่ละย่อหน้าจะถูกเก็บรักษาไว้ด้วยการเพิ่มการเยื้องที่จุดเริ่มต้นของย่อหน้านั้นๆ
การแสดง JSON |
---|
{
"range": {
object (
|
ช่อง | |
---|---|
range
|
ช่วงที่จะลบสัญลักษณ์หัวข้อย่อย |
สร้างช่วงชื่อคําขอ
สร้าง NamedRange
ที่อ้างอิงช่วงที่ระบุ
การแสดง JSON |
---|
{
"name": string,
"range": {
object (
|
ช่อง | |
---|---|
name
|
ชื่อของ NamedRange โดยชื่อไม่จําเป็นต้องซ้ํากัน ชื่อต้องมีอักขระอย่างน้อย 1 ตัวและไม่เกิน 256 ตัวโดยวัดเป็นหน่วยโค้ด UTF-16 |
range
|
ช่วงที่จะใช้ชื่อ |
ลบช่วงชื่อ
ลบ NamedRange
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
named_range_reference ค่าที่จะเป็นตัวกําหนดช่วงหรือลบ ต้องตั้งค่าอย่างใดอย่างหนึ่งเท่านั้น
named_range_reference
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
namedRangeId
|
รหัสของช่วงที่ตั้งชื่อเพื่อลบ |
name
|
ชื่อของช่วงที่จะลบ ช่วงที่มีชื่อทั้งหมดที่มีชื่อตามที่กําหนดจะถูกลบออก |
อัปเดตลักษณะของย่อหน้า
อัปเดตการจัดรูปแบบของย่อหน้าทั้งหมดที่ซ้อนทับกับช่วงที่ระบุ
การแสดง JSON |
---|
{ "paragraphStyle": { object ( |
ช่อง | |
---|---|
paragraphStyle
|
รูปแบบที่จะกําหนดในย่อหน้า
การเปลี่ยนแปลงรูปแบบย่อหน้าบางอย่างอาจทําให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อสะท้อนลักษณะการทํางานของเครื่องมือแก้ไขเอกสาร ดูข้อมูลเพิ่มเติมในเอกสารของ |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
ตัวอย่างเช่น หากต้องการอัปเดตคุณสมบัติการปรับแนวของรูปแบบย่อหน้า ให้ตั้งค่า หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อของช่องนั้นไว้ในมาสก์ของช่องโดยไม่ต้องตั้งค่าใดๆ |
ช่อง Union
insertion_location ประเภทของช่วงที่ใช้อัปเดตรูปแบบย่อหน้า
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
range
|
ช่วงจะซ้อนทับกันของย่อหน้า |
ลบเนื้อหาของช่วงเนื้อหา
ลบเนื้อหาออกจากเอกสาร
การแสดง JSON |
---|
{
"range": {
object (
|
ช่อง | |
---|---|
range
|
ช่วงของเนื้อหาที่จะลบ การลบข้อความที่ข้ามขอบเขตของย่อหน้าอาจทําให้เกิดการเปลี่ยนแปลงรูปแบบย่อหน้า รายการ วัตถุที่จัดวางตําแหน่ง และบุ๊กมาร์กเมื่อรวมย่อหน้าทั้งสองเข้าด้วยกัน ความพยายามลบบางช่วงอาจทําให้โครงสร้างเอกสารไม่ถูกต้อง ซึ่งจะทําให้ 400 เกิดข้อผิดพลาดเกี่ยวกับคําขอที่ไม่ถูกต้อง ตัวอย่างคําขอลบที่ไม่ถูกต้องมีดังนี้
|
แทรกรูปภาพในบรรทัด
แทรก InlineObject
ที่มีรูปภาพในตําแหน่งที่ระบุ
การแสดง JSON |
---|
{ "uri": string, "objectSize": { object ( |
ช่อง | |
---|---|
uri
|
URI รูปภาพ ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในขณะแทรก และจัดเก็บสําเนาไว้เพื่อแสดงภายในเอกสาร รูปภาพต้องมีขนาดน้อยกว่า 50MB และต้องไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF
URI ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีความยาวไม่เกิน 2 KB URI จะถูกบันทึกพร้อมกับรูปภาพและจะแสดงผ่านช่อง |
objectSize
|
ขนาดรูปภาพที่ปรากฏในเอกสาร คุณสมบัตินี้เป็นตัวเลือกและขนาดสุดท้ายของรูปภาพในเอกสารถูกกําหนดโดยกฎต่อไปนี้: * ถ้าไม่ได้ระบุความกว้างหรือความสูง ระบบจะคํานวณขนาดเริ่มต้นของภาพตามความละเอียดของภาพ * หากระบุขนาดไว้ อีกมิติหนึ่งจะคํานวณเพื่อรักษาอัตราส่วนของรูปภาพ * ถ้ามีการระบุทั้งความกว้างและความสูง ภาพจะถูกปรับขนาดให้พอดีกับขนาดที่ระบุโดยที่ยังรักษาอัตราส่วนเดิมอยู่ |
ช่อง Union
insertion_location ตําแหน่งที่จะแทรกรูปภาพ
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกรูปภาพในดัชนีที่เจาะจงในเอกสาร
รูปภาพต้องแทรกอยู่ภายในขอบเขตของ ไม่สามารถแทรกรูปภาพในบรรทัดในเชิงอรรถหรือสมการ |
endOfSegmentLocation
|
แทรกข้อความไว้ที่ท้ายส่วนหัว ท้ายกระดาษ หรือเนื้อความในเอกสาร ไม่สามารถแทรกรูปภาพในบรรทัดในเชิงอรรถ |
แทรกตาราง
แทรกตารางในตําแหน่งที่ระบุ
ระบบจะแทรกอักขระขึ้นบรรทัดใหม่ก่อนตารางที่แทรก
การแสดง JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
ช่อง | |
---|---|
rows
|
จํานวนแถวในตาราง |
columns
|
จํานวนคอลัมน์ในตาราง |
ช่อง Union
insertion_location ตําแหน่งที่จะแทรกตาราง
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกตารางที่ดัชนีโมเดลที่ระบุ ระบบจะแทรกอักขระขึ้นบรรทัดใหม่ก่อนตารางที่แทรก ดังนั้นดัชนีจุดเริ่มต้นตารางจะอยู่ที่ดัชนีตําแหน่งที่ระบุ + 1
ต้องแทรกตารางไว้ภายในขอบเขตของ ไม่สามารถแทรกตารางภายในเชิงอรรถหรือสมการได้ |
endOfSegmentLocation
|
แทรกตารางที่ท้ายส่วนหัว ส่วนท้าย หรือเนื้อหาของเอกสาร ระบบจะแทรกอักขระขึ้นบรรทัดใหม่ก่อนตารางที่แทรก ไม่สามารถแทรกตารางภายในเชิงอรรถ |
แทรกแถวในตารางคําขอ
แทรกแถวที่ว่างเปล่าลงในตาราง
การแสดง JSON |
---|
{
"tableCellLocation": {
object (
|
ช่อง | |
---|---|
tableCellLocation
|
ตําแหน่งเซลล์ของตารางอ้างอิงที่จะแทรกแถว ระบบจะแทรกแถวใหม่ที่ด้านบน (หรือด้านล่าง) ของแถวที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสานกัน ระบบจะแทรกแถวใหม่ด้านบน (หรือด้านล่าง) เซลล์ที่ผสาน |
insertBelow
|
แทรกแถวใหม่ใต้ตําแหน่งของเซลล์อ้างอิงหรือไม่
|
ตําแหน่งเซลล์ตาราง
ตําแหน่งของเซลล์เดียวภายในตาราง
การแสดง JSON |
---|
{
"tableStartLocation": {
object (
|
ช่อง | |
---|---|
tableStartLocation
|
ตําแหน่งที่ตารางเริ่มต้นในเอกสาร |
rowIndex
|
ดัชนีแถวที่เป็นศูนย์ ตัวอย่างเช่น แถวที่สองในตารางมีดัชนีแถวเป็น 1 |
columnIndex
|
ดัชนีคอลัมน์ฐาน 0 ตัวอย่างเช่น คอลัมน์ที่สองในตารางมีดัชนีคอลัมน์เป็น 1 |
แทรกตารางคอลัมน์
แทรกคอลัมน์ที่ว่างเปล่าลงในตาราง
การแสดง JSON |
---|
{
"tableCellLocation": {
object (
|
ช่อง | |
---|---|
tableCellLocation
|
ตําแหน่งเซลล์ของตารางอ้างอิงที่จะแทรกคอลัมน์ ระบบจะแทรกคอลัมน์ใหม่ทางซ้าย (หรือขวา) ของคอลัมน์ที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสาน ระบบจะแทรกคอลัมน์ใหม่ทางซ้าย (หรือขวา) ของเซลล์ที่ผสาน |
insertRight
|
แทรกคอลัมน์ใหม่ที่ด้านขวาของตําแหน่งเซลล์อ้างอิงหรือไม่
|
ลบตารางคําขอ
ลบแถวออกจากตาราง
การแสดง JSON |
---|
{
"tableCellLocation": {
object (
|
ช่อง | |
---|---|
tableCellLocation
|
ตําแหน่งของเซลล์ตารางอ้างอิงซึ่งแถวจะถูกลบ แถวที่เซลล์นี้จะถูกลบ ถ้าเซลล์นี้เป็นเซลล์ที่รวมหลายแถว แถวทั้งหมดที่เซลล์นั้นสร้างขึ้นจะถูกลบออก หากไม่มีแถวเหลืออยู่ในตารางหลังจากการลบนี้ ระบบจะลบตารางทั้งหมด |
ลบตารางคอลัมน์
ลบคอลัมน์ออกจากตาราง
การแสดง JSON |
---|
{
"tableCellLocation": {
object (
|
ช่อง | |
---|---|
tableCellLocation
|
ตําแหน่งของเซลล์ตารางอ้างอิงซึ่งคอลัมน์จะถูกลบ คอลัมน์ของช่วงเซลล์นี้จะถูกลบออก ถ้าเซลล์นี้เป็นเซลล์ที่รวมหลายคอลัมน์ คอลัมน์ทั้งหมดที่เซลล์นั้นจะถูกลบออกออก หากไม่มีคอลัมน์ใดอยู่ในตารางหลังจากการลบนี้ ระบบจะลบตารางทั้งหมด |
แทรกตัวแบ่งหน้า
แทรกตัวแบ่งหน้าตามด้วยบรรทัดใหม่ในตําแหน่งที่ระบุ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
insertion_location ตําแหน่งที่จะแทรกตัวแบ่งหน้า
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกตัวแบ่งหน้าที่ดัชนีหนึ่งๆ ในเอกสาร
ต้องแทรกตัวแบ่งหน้าภายในขอบเขตของ
แทรกตัวแบ่งหน้าภายในตาราง สมการ เชิงอรรถ ส่วนหัว หรือส่วนท้ายไม่ได้ เนื่องจากแทรกตัวแบ่งหน้าได้เฉพาะภายในเนื้อหา ช่อง |
endOfSegmentLocation
|
แทรกตัวแบ่งหน้าที่ส่วนท้ายของเนื้อหาเอกสาร
แทรกตัวแบ่งหน้าภายในเชิงอรรถ ส่วนหัว หรือส่วนท้ายไม่ได้ เนื่องจากแทรกตัวแบ่งหน้าได้เฉพาะภายในเนื้อหา ช่อง |
ลบคําขอตําแหน่ง
ลบ PositionedObject
จากเอกสาร
การแสดง JSON |
---|
{ "objectId": string } |
ช่อง | |
---|---|
objectId
|
รหัสของรายการที่วางตําแหน่งที่จะลบ |
อัปเดตคุณสมบัติของคอลัมน์ในตาราง
อัปเดต TableColumnProperties
ของคอลัมน์ในตาราง
การแสดง JSON |
---|
{ "tableStartLocation": { object ( |
ช่อง | |
---|---|
tableStartLocation
|
ตําแหน่งที่ตารางเริ่มต้นในเอกสาร |
columnIndices[]
|
รายการดัชนีคอลัมน์ที่ต้องเป็นศูนย์ซึ่งควรอัปเดตพร็อพเพอร์ตี้ หากไม่มีการระบุดัชนี คอลัมน์ทั้งหมดจะได้รับการอัปเดต |
tableColumnProperties
|
คุณสมบัติของคอลัมน์ในตารางที่จะอัปเดต
หากค่าของ |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
ตัวอย่างเช่น หากต้องการอัปเดตความกว้างของคอลัมน์ ให้ตั้งค่า |
UpdateRequestCellStyleRequest
อัปเดตรูปแบบของช่วงของเซลล์ตาราง
การแสดง JSON |
---|
{ "tableCellStyle": { object ( |
ช่อง | |
---|---|
tableCellStyle
|
รูปแบบที่ตั้งค่าในเซลล์ตาราง เมื่ออัปเดตเส้นขอบ หากเซลล์แชร์เส้นขอบกับเซลล์ติดกัน ระบบจะอัปเดตคุณสมบัติเส้นขอบของเซลล์ที่ติดกันด้วย เส้นขอบที่รวมและมองไม่เห็นจะไม่อัปเดต เนื่องจากการอัปเดตเส้นขอบที่แชร์โดยเซลล์ที่อยู่ติดกันในคําขอเดียวกันอาจทําให้การอัปเดตเส้นขอบที่ขัดแย้งกัน จึงมีการใช้การอัปเดตเส้นขอบตามลําดับต่อไปนี้:
|
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
เช่น อัปเดตสีพื้นหลังของเซลล์ในตาราง ให้ตั้งค่า หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อของช่องนั้นไว้ในมาสก์ของช่องโดยไม่ต้องตั้งค่าใดๆ |
ช่อง Union
cells เซลล์ที่จะอัปเดต
cells
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
tableRange
|
ช่วงตารางที่แสดงชุดย่อยของตารางที่จะนําการอัปเดตไปใช้ |
tableStartLocation
|
ตําแหน่งที่ตารางเริ่มต้นในเอกสาร เมื่อระบุแล้ว การอัปเดตจะมีผลกับเซลล์ทั้งหมดในตาราง |
ช่วงตาราง
ช่วงตารางจะหมายถึงการอ้างอิงชุดย่อยของตาราง
โปรดทราบว่าเซลล์ที่ระบุตามช่วงตารางไม่จําเป็นต้องเป็นสี่เหลี่ยมผืนผ้า ตัวอย่างเช่น สมมติว่าเรามีตารางขนาด 3 x 3 ที่เซลล์ทั้งหมดของแถวสุดท้ายจะถูกรวมเข้าด้วยกัน ตารางจะมีลักษณะดังนี้
[ ][ ][ ]
[ ][ ][ ]
[ ]
ช่วงตารางที่มีตําแหน่งเซลล์ตาราง = (tableStartLocation, แถว = 0, คอลัมน์ = 0), ช่วงแถว = 3 และช่วงคอลัมน์ = 2 ระบุเซลล์ต่อไปนี้
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
การแสดง JSON |
---|
{
"tableCellLocation": {
object (
|
ช่อง | |
---|---|
tableCellLocation
|
ตําแหน่งของเซลล์ที่ช่วงตารางเริ่มต้น |
rowSpan
|
ช่วงแถวของช่วงตาราง |
columnSpan
|
ช่วงคอลัมน์ของช่วงตาราง |
อัปเดตคําขอแถวของตาราง
อัปเดตแถว TableRowStyle
แถวในตาราง
การแสดง JSON |
---|
{ "tableStartLocation": { object ( |
ช่อง | |
---|---|
tableStartLocation
|
ตําแหน่งที่ตารางเริ่มต้นในเอกสาร |
rowIndices[]
|
รายการดัชนีแถวตามศูนย์ที่ควรมีการอัปเดตรูปแบบ หากไม่มีการระบุดัชนี แถวทั้งหมดจะได้รับการอัปเดต |
tableRowStyle
|
รูปแบบที่จะกําหนดในแถว |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
ตัวอย่างเช่น หากต้องการอัปเดตความสูงของแถวขั้นต่ํา ให้ตั้งค่า |
แทนที่คําขอรูปภาพ
แทนที่รูปภาพที่มีอยู่ด้วยรูปภาพใหม่
การแทนที่รูปภาพจะเป็นการนํา image effects
บางรายการออกจากรูปภาพที่มีอยู่เพื่อให้สอดคล้องกับลักษณะการทํางานของเครื่องมือแก้ไขเอกสาร
การแสดง JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
ช่อง | |
---|---|
imageObjectId
|
รหัสของรูปภาพที่มีอยู่ซึ่งจะแทนที่ คุณสามารถดึง ID ได้จากการตอบสนองต่อคําขอรับ |
uri
|
URI ของรูปภาพใหม่ ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในขณะแทรก และจัดเก็บสําเนาไว้เพื่อแสดงภายในเอกสาร รูปภาพต้องมีขนาดไม่เกิน 50 MB และมีขนาดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF
URI ที่ให้มาต้องไม่เกิน 2 KB บันทึก URI ด้วยรูปภาพ และเปิดเผยผ่านช่อง |
imageReplaceMethod
|
วิธีการแทนที่ |
วิธีแทนที่รูปภาพ
วิธีการแทนที่รูปภาพ
Enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
วิธีการแทนที่รูปภาพที่ไม่ระบุ และต้องไม่ใช้ค่านี้ |
CENTER_CROP
|
ปรับขนาดและจัดตําแหน่งรูปภาพให้อยู่กึ่งกลางเพื่อเติมขอบของรูปภาพต้นฉบับ ระบบอาจครอบตัดรูปภาพเพื่อเติมขอบของรูปภาพต้นฉบับ ขนาดภาพที่แสดงในภาพจะเท่ากับขนาดเดิม |
อัปเดตคําขอรูปแบบเอกสาร
อัปเดต DocumentStyle
การแสดง JSON |
---|
{
"documentStyle": {
object (
|
ช่อง | |
---|---|
documentStyle
|
รูปแบบที่จะกําหนดในเอกสาร
การเปลี่ยนแปลงรูปแบบเอกสารบางอย่างอาจทําให้เกิดการเปลี่ยนแปลงอื่นๆ เพื่อสะท้อนลักษณะการทํางานของเครื่องมือแก้ไขเอกสาร ดูข้อมูลเพิ่มเติมในเอกสารของ |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
ตัวอย่างเช่น หากต้องการอัปเดตพื้นหลัง ให้ตั้งค่า |
คําขอผสานตารางเซลล์
ผสานเซลล์ใน Table
การแสดง JSON |
---|
{
"tableRange": {
object (
|
ช่อง | |
---|---|
tableRange
|
ช่วงของตารางที่ระบุเซลล์ของตารางที่จะผสาน ข้อความในเซลล์ที่ผสานกันจะต่อกันและเก็บไว้ในเซลล์ "head" ของช่วง นี่คือเซลล์ที่ด้านซ้ายบนของช่วงเมื่อทิศทางของเนื้อหาจากซ้ายไปขวา และเซลล์ด้านขวาบนของช่วง หากช่วงนั้นไม่ใช่สี่เหลี่ยม (ซึ่งสามารถเกิดขึ้นได้ในบางกรณีที่ช่วงครอบคลุมเซลล์ที่ผสานไปแล้ว หรือตารางไม่เป็นสี่เหลี่ยมผืนผ้า) ระบบจะแสดงข้อผิดพลาดคําขอไม่ถูกต้อง 400 |
ยกเลิกการผสานเซลล์ตาราง
เลิกผสานเซลล์ใน Table
การแสดง JSON |
---|
{
"tableRange": {
object (
|
ช่อง | |
---|---|
tableRange
|
ช่วงของตารางที่ระบุเซลล์ของตารางที่จะยกเลิกการผสาน ระบบจะเลิกผสานเซลล์ทั้งหมดที่ผสานในช่วงนี้ และเซลล์ที่ไม่ได้ผสานอยู่แล้วจะไม่ได้รับผลกระทบ หากช่วงไม่มีเซลล์ที่ผสาน คําขอจะไม่ดําเนินการใดๆ หากมีข้อความในเซลล์ที่ผสานค่าใดก็ตาม ข้อความนั้นจะยังคงอยู่ในเซลล์ "head" ของบล็อกที่เป็นผลลัพธ์ของเซลล์ที่ไม่ได้ผสาน เซลล์ "head" คือเซลล์ด้านบนซ้ายเมื่อทิศทางของเนื้อหาจากซ้ายไปขวา และด้านขวาบน |
สร้างส่วนหัวของคําขอ
สร้าง Header
ส่วนหัวใหม่จะใช้กับ SectionStyle
ที่ตําแหน่งของ SectionBreak
หากระบุไว้ ไม่เช่นนั้นจะมีผลกับ DocumentStyle
ถ้ามีส่วนหัวของประเภทที่ระบุอยู่แล้ว ระบบจะแสดงผลคําขอผิดพลาด 400
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type
|
ประเภทของส่วนหัวที่จะสร้าง |
sectionBreakLocation
|
ตําแหน่งของ |
สร้างคําขอเชิงอรรถ
สร้างกลุ่ม Footnote
และแทรก FootnoteReference
ใหม่ลงในกลุ่ม ณ ตําแหน่งที่ระบุ
ส่วน Footnote
ใหม่จะมีการเว้นวรรคตามด้วยอักขระขึ้นบรรทัดใหม่
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
footnote_reference_location ตําแหน่งที่จะแทรกการอ้างอิงเชิงอรรถ
footnote_reference_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกการอ้างอิงเชิงอรรถที่ดัชนีเฉพาะในเอกสาร
ต้องแทรกการอ้างอิงเชิงอรรถภายในขอบเขตของ
แทรกการอ้างอิงในเชิงอรรถภายในสมการ ส่วนหัว ส่วนท้าย หรือเชิงอรรถไม่ได้ เนื่องจากแทรกการอ้างอิงเชิงอรรถได้เฉพาะในเนื้อหา ช่อง |
endOfSegmentLocation
|
แทรกการอ้างอิงเชิงอรรถไว้ที่ท้ายเนื้อหาของเอกสาร
แทรกการอ้างอิงในเชิงอรรถภายในส่วนหัว ส่วนท้าย หรือเชิงอรรถไม่ได้ เนื่องจากแทรกการอ้างอิงเชิงอรรถได้เฉพาะในเนื้อหา ช่อง |
แทนที่ช่วงเนื้อหาที่ส่งคําขอ
แทนที่เนื้อหาของ NamedRange
หรือ NamedRanges
ที่ระบุด้วยเนื้อหาแทนที่ที่ระบุ
โปรดทราบว่า NamedRange
แต่ละรายการอาจมี ranges
ต่อเนื่องหลายรายการ ในกรณีนี้ เฉพาะเนื้อหาในช่วงแรกเท่านั้นที่จะถูกแทนที่ ระบบจะลบช่วงอื่นๆ และเนื้อหาช่วงนั้น
ในกรณีที่การแทนที่หรือลบช่วงใดทําให้โครงสร้างเอกสารไม่ถูกต้อง จะแสดงข้อผิดพลาด 400 ในคําขอไม่ถูกต้อง
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
replacement_content เนื้อหาที่จะแทนที่เนื้อหาที่มีอยู่ของช่วงที่ตั้งชื่อด้วย
replacement_content
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
text
|
แทนที่เนื้อหาของช่วงที่มีชื่อที่ระบุด้วยข้อความที่กําหนด |
ช่อง Union
named_range_reference การอ้างอิงไปยังช่วงที่ตั้งชื่อแล้วซึ่งเนื้อหาจะถูกแทนที่
named_range_reference
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
namedRangeId
|
รหัสของช่วงที่ตั้งชื่อแล้วซึ่งเนื้อหาจะถูกแทนที่ หากไม่มีช่วงที่มีชื่อที่ระบุ ID จะแสดงข้อผิดพลาด 400 เป็นคําขอที่ไม่ถูกต้อง |
namedRangeName
|
ชื่อของ
หากมี |
อัปเดตส่วนรูปแบบส่วน
อัปเดต SectionStyle
การแสดง JSON |
---|
{ "range": { object ( |
ช่อง | |
---|---|
range
|
ช่วงจะซ้อนทับส่วนต่างๆ เพื่อจัดรูปแบบ
เนื่องจากแทรกตัวแบ่งส่วนได้เฉพาะภายในส่วนเนื้อหา ช่อง |
sectionStyle
|
รูปแบบที่จะกําหนดในส่วน
การเปลี่ยนแปลงรูปแบบบางส่วนอาจทําให้การเปลี่ยนแปลงอื่นๆ เหมือนกับการทํางานของเครื่องมือแก้ไขเอกสาร ดูข้อมูลเพิ่มเติมในเอกสารของ |
fields
|
ช่องที่ควรอัปเดต
ต้องระบุอย่างน้อย 1 ช่อง รูท
เช่น หากต้องการอัปเดตระยะขอบด้านซ้าย ให้ตั้งค่า |
แทรกตัวแบ่งส่วน
แทรกตัวแบ่งส่วนในตําแหน่งที่กําหนด
ระบบจะแทรกอักขระขึ้นบรรทัดใหม่ก่อนตัวแบ่งส่วน
การแสดง JSON |
---|
{ "sectionType": enum ( |
ช่อง | |
---|---|
sectionType
|
ประเภทของส่วนที่จะแทรก |
ช่อง Union
insertion_location ตําแหน่งที่จะแทรกตัวแบ่ง
insertion_location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
location
|
แทรกบรรทัดใหม่และตัวแบ่งส่วนในดัชนีที่ต้องการในเอกสาร
ต้องแทรกตัวแบ่งส่วนภายในขอบเขตของ
แทรกตัวแบ่งส่วนภายในตาราง สมการ เชิงอรรถ ส่วนหัว หรือส่วนท้ายไม่ได้ เนื่องจากแทรกตัวแบ่งส่วนได้เฉพาะภายในส่วนเนื้อหา ช่อง |
endOfSegmentLocation
|
แทรกบรรทัดใหม่และตัวแบ่งส่วนที่อยู่ท้ายเนื้อหาของเอกสาร
แทรกตัวแบ่งส่วนภายในเชิงอรรถ ส่วนหัว หรือส่วนท้ายไม่ได้ เนื่องจากแทรกตัวแบ่งส่วนได้เฉพาะภายในส่วนเนื้อหา ช่อง |
ลบส่วนหัวของคําขอ
ลบ Header
จากเอกสาร
การแสดง JSON |
---|
{ "headerId": string } |
ช่อง | |
---|---|
headerId
|
รหัสของส่วนหัวที่จะลบ หากมีการกําหนดส่วนหัวนี้ไว้ใน |
PinTableHeaderRowsRequest
อัปเดตจํานวนแถวส่วนหัวของตารางที่ปักหมุดในตาราง
การแสดง JSON |
---|
{
"tableStartLocation": {
object (
|
ช่อง | |
---|---|
tableStartLocation
|
ตําแหน่งที่ตารางเริ่มต้นในเอกสาร |
pinnedHeaderRowsCount
|
จํานวนแถวในตารางที่จะตรึง โดย 0 บ่งบอกว่าไม่ได้ตรึงแถวทั้งหมด |