Requests

ส่งคำขอ

การอัปเดตประเภทเดียวที่จะใช้กับงานนำเสนอ

การแสดง JSON 
{

  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
ช่อง
ประเภทของการอัปเดต ต้องระบุช่องเดียวเท่านั้น ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
createSlide

object (CreateSlideRequest)

สร้างสไลด์ใหม่

createShape

object (CreateShapeRequest)

สร้างรูปร่างใหม่

createTable

object (CreateTableRequest)

สร้างตารางใหม่

insertText

object (InsertTextRequest)

แทรกข้อความลงในรูปร่างหรือเซลล์ตาราง

insertTableRows

object (InsertTableRowsRequest)

แทรกแถวลงในตาราง

insertTableColumns

object (InsertTableColumnsRequest)

แทรกคอลัมน์ลงในตาราง

deleteTableRow

object (DeleteTableRowRequest)

ลบแถวออกจากตาราง

deleteTableColumn

object (DeleteTableColumnRequest)

ลบคอลัมน์ออกจากตาราง

replaceAllText

object (ReplaceAllTextRequest)

แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ระบุ

deleteObject

object (DeleteObjectRequest)

ลบหน้าหรือองค์ประกอบของหน้าจากงานนำเสนอ

updatePageElementTransform

object (UpdatePageElementTransformRequest)

อัปเดตการเปลี่ยนรูปขององค์ประกอบของหน้า

updateSlidesPosition

object (UpdateSlidesPositionRequest)

อัปเดตตำแหน่งของชุดสไลด์ในงานนำเสนอ

deleteText

object (DeleteTextRequest)

ลบข้อความออกจากรูปร่างหรือเซลล์ตาราง

createImage

object (CreateImageRequest)

สร้างรูปภาพ

createVideo

object (CreateVideoRequest)

สร้างวิดีโอ

createSheetsChart

object (CreateSheetsChartRequest)

สร้างแผนภูมิ Google ชีตแบบฝัง

createLine

object (CreateLineRequest)

สร้างเส้น

refreshSheetsChart

object (RefreshSheetsChartRequest)

รีเฟรชแผนภูมิ Google ชีต

updateShapeProperties

object (UpdateShapePropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Shape

updateImageProperties

object (UpdateImagePropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Image

updateVideoProperties

object (UpdateVideoPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Video

updatePageProperties

object (UpdatePagePropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Page

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ TableCell

updateLineProperties

object (UpdateLinePropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Line

createParagraphBullets

object (CreateParagraphBulletsRequest)

สร้างสัญลักษณ์หัวข้อย่อยสำหรับย่อหน้า

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

แทนที่รูปร่างทั้งหมดที่ตรงกับเกณฑ์บางอย่างด้วยรูปภาพ

duplicateObject

object (DuplicateObjectRequest)

ทำซ้ำองค์ประกอบสไลด์หรือองค์ประกอบของหน้า

updateTextStyle

object (UpdateTextStyleRequest)

อัปเดตการจัดรูปแบบข้อความภายใน Shape หรือ Table

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

แทนที่รูปร่างทั้งหมดที่ตรงกับเกณฑ์บางอย่างด้วยแผนภูมิ Google ชีต

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

ลบสัญลักษณ์แสดงหัวข้อย่อยออกจากย่อหน้า

updateParagraphStyle

object (UpdateParagraphStyleRequest)

อัปเดตการจัดรูปแบบย่อหน้าภายใน Shape หรือ Table

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของเส้นขอบตารางใน Table

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของคอลัมน์ Table

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของ Table แถว

mergeTableCells

object (MergeTableCellsRequest)

ผสานเซลล์ใน Table

unmergeTableCells

object (UnmergeTableCellsRequest)

ยกเลิกการผสานเซลล์ใน Table

groupObjects

object (GroupObjectsRequest)

จัดกลุ่มออบเจ็กต์ เช่น องค์ประกอบของหน้าเว็บ

ungroupObjects

object (UngroupObjectsRequest)

ยกเลิกการจัดกลุ่มออบเจ็กต์ เช่น groups

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

อัปเดตชื่อและ/หรือคำอธิบายข้อความแสดงแทนของ page element

replaceImage

object (ReplaceImageRequest)

แทนที่รูปภาพที่มีอยู่ด้วยรูปภาพใหม่

updateSlideProperties

object (UpdateSlidePropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของสไลด์

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

อัปเดตลำดับ Z ของ page elements

updateLineCategory

object (UpdateLineCategoryRequest)

อัปเดตหมวดหมู่ของ line

rerouteLine

object (RerouteLineRequest)

เปลี่ยนเส้นทาง line เพื่อให้เชื่อมต่อที่จุดเชื่อมต่อที่ใกล้ที่สุด 2 จุดในองค์ประกอบหน้าเว็บที่เชื่อมต่อ

insertComment

object (InsertCommentRequest)

แทรก CommentThread ลงในงานนำเสนอ

addCommentReply

object (AddCommentReplyRequest)

เพิ่มคำตอบใน CommentThread

updateCommentPost

object (UpdateCommentPostRequest)

อัปเดตโพสต์ที่มีอยู่ (โพสต์หลักหรือการตอบกลับ) ของ CommentThread

deleteComment

object (DeleteCommentRequest)

ลบ CommentThread

deleteCommentReply

object (DeleteCommentReplyRequest)

ลบการตอบกลับ Post จาก CommentThread

สิ้นสุดฟิลด์ที่แยกกัน

CreateSlideRequest

สร้างสไลด์

การแสดง JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจรวมถึงอักขระเหล่านั้น รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องอยู่ระหว่าง 5 ถึง 50 อักขระ

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

insertionIndex

integer

ดัชนีแบบ 0 ที่ไม่บังคับซึ่งระบุตำแหน่งที่จะแทรกสไลด์

หากคุณไม่ระบุดัชนี ระบบจะสร้างสไลด์ที่ส่วนท้าย

slideLayoutReference

object (LayoutReference)

การอ้างอิงเลย์เอาต์ของสไลด์ที่จะแทรกโดยอิงตามสไลด์ต้นแบบปัจจุบัน ซึ่งเป็นหนึ่งในรายการต่อไปนี้

  • มาสเตอร์ของดัชนีสไลด์ก่อนหน้า
  • ต้นแบบของสไลด์แรก หาก insertionIndex เป็น 0
  • มาสเตอร์แรกในงานนำเสนอ หากไม่มีสไลด์

หากไม่พบ LayoutReference ในมาสเตอร์ปัจจุบัน ระบบจะแสดงข้อผิดพลาด 400 Bad Request

หากไม่ได้ระบุการอ้างอิงเลย์เอาต์ สไลด์จะใช้เลย์เอาต์ BLANK ที่กำหนดไว้ล่วงหน้า

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

รายการการแมปรหัสออบเจ็กต์ที่ไม่บังคับจาก placeholder (s) ในเลย์เอาต์ไปยังตัวยึดตำแหน่งที่สร้างในสไลด์จากเลย์เอาต์ที่ระบุ ใช้ได้เฉพาะเมื่อระบุ slideLayoutReference

LayoutReference

การอ้างอิงเลย์เอาต์สไลด์ ซึ่งอาจอ้างอิงถึงรายการต่อไปนี้

  • เลย์เอาต์ที่กำหนดไว้ล่วงหน้า
  • เลย์เอาต์อย่างใดอย่างหนึ่งในงานนำเสนอ
การแสดง JSON 
{

  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
}
ช่อง
ประเภทของ LayoutReference ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
predefinedLayout

enum (PredefinedLayout)

เลย์เอาต์ที่กำหนดไว้ล่วงหน้า

layoutId

string

รหัสเลย์เอาต์: รหัสออบเจ็กต์ของเลย์เอาต์ใดเลย์เอาต์หนึ่งในงานนำเสนอ

สิ้นสุดฟิลด์ที่แยกกัน

PredefinedLayout

ประเภทเลย์เอาต์ที่กำหนดไว้ล่วงหน้า ซึ่งเป็นเลย์เอาต์ที่พบได้ทั่วไปในงานนำเสนอ อย่างไรก็ตาม เราไม่สามารถรับประกันได้ว่าเลย์เอาต์เหล่านี้จะอยู่ในสไลด์ต้นแบบปัจจุบัน เนื่องจากอาจถูกลบไปแล้วหรือไม่ได้เป็นส่วนหนึ่งของธีมที่ใช้ นอกจากนี้ ตัวยึดตำแหน่งในเลย์เอาต์แต่ละรายการอาจมีการเปลี่ยนแปลงด้วย

Enum
PREDEFINED_LAYOUT_UNSPECIFIED เลย์เอาต์ที่ไม่ได้ระบุ
BLANK เลย์เอาต์ว่างเปล่าที่ไม่มีตัวยึดตำแหน่ง
CAPTION_ONLY เลย์เอาต์ที่มีคำบรรยายแทนเสียงที่ด้านล่าง
TITLE เลย์เอาต์ที่มีชื่อและคำบรรยาย
TITLE_AND_BODY เลย์เอาต์ที่มีชื่อและเนื้อหา
TITLE_AND_TWO_COLUMNS เลย์เอาต์ที่มีชื่อและ 2 คอลัมน์
TITLE_ONLY เลย์เอาต์ที่มีเฉพาะชื่อ
SECTION_HEADER เลย์เอาต์ที่มีชื่อส่วน
SECTION_TITLE_AND_DESCRIPTION เลย์เอาต์ที่มีชื่อและคำบรรยายด้านหนึ่ง และคำอธิบายอีกด้านหนึ่ง
ONE_COLUMN_TEXT เลย์เอาต์ที่มีชื่อและเนื้อหาอย่างละ 1 รายการ จัดเรียงในคอลัมน์เดียว
MAIN_POINT เลย์เอาต์ที่มีประเด็นหลัก
BIG_NUMBER เลย์เอาต์ที่มีส่วนหัวเป็นตัวเลขขนาดใหญ่

LayoutPlaceholderIdMapping

การแมปรหัสที่ผู้ใช้ระบุสำหรับตัวยึดตำแหน่งที่จะสร้างในสไลด์จากเลย์เอาต์ที่ระบุ

การแสดง JSON 
{
  "objectId": string,

  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุสำหรับตัวยึดตำแหน่งที่ระบุไว้ข้างต้นเพื่อสร้างในสไลด์

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

ชนิดเพื่อระบุตัวยึดตำแหน่งในเลย์เอาต์ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
layoutPlaceholder

object (Placeholder)

ตัวยึดตำแหน่งในเลย์เอาต์ที่จะใช้กับสไลด์ คุณต้องระบุเพียง type และ index เท่านั้น เช่น เลย์เอาต์ที่กำหนดไว้ล่วงหน้า TITLE_AND_BODY มักจะมีตัวยึดตำแหน่ง TITLE ที่มีดัชนี 0 และตัวยึดตำแหน่ง BODY ที่มีดัชนี 0

layoutPlaceholderObjectId

string

รหัสออบเจ็กต์ของตัวยึดตำแหน่งในเลย์เอาต์ที่จะใช้กับสไลด์

สิ้นสุดฟิลด์ที่แยกกัน

CreateShapeRequest

สร้างรูปร่างใหม่

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50 หากไม่มีข้อมูล ระบบจะสร้างตัวระบุที่ไม่ซ้ำกัน

elementProperties

object (PageElementProperties)

พร็อพเพอร์ตี้ขององค์ประกอบสำหรับรูปร่าง

shapeType

enum (Type)

ประเภทรูปร่าง

PageElementProperties

พร็อพเพอร์ตี้ทั่วไปสำหรับองค์ประกอบของหน้า

หมายเหตุ: เมื่อสร้าง PageElementในครั้งแรก API อาจแก้ไขค่าของทั้ง size และ transform แต่ขนาดภาพจะไม่เปลี่ยนแปลง

การแสดง JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
ช่อง
pageObjectId

string

รหัสออบเจ็กต์ของหน้าที่องค์ประกอบอยู่

size

object (Size)

ขนาดขององค์ประกอบ

transform

object (AffineTransform)

การเปลี่ยนรูปแบบขององค์ประกอบ

CreateTableRequest

สร้างตารางใหม่

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

elementProperties

object (PageElementProperties)

คุณสมบัติขององค์ประกอบสำหรับตาราง

ระบบจะสร้างตารางตามขนาดที่ระบุ โดยมีขนาดขั้นต่ำ หากไม่ได้ระบุขนาด ระบบจะปรับขนาดตารางโดยอัตโนมัติ

การเปลี่ยนรูปแบบตารางต้องมีสเกลเป็น 1 และไม่มีคอมโพเนนต์การเฉือน หากไม่ได้ระบุการเปลี่ยนรูปแบบ ระบบจะจัดกึ่งกลางตารางในหน้า

rows

integer

จำนวนแถวในตาราง

columns

integer

จำนวนคอลัมน์ในตาราง

InsertTextRequest

แทรกข้อความลงในรูปร่างหรือเซลล์ตาราง

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่จะแทรกข้อความ

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตาราง (ไม่บังคับ) หากต้องการแทรกข้อความลงในเซลล์ในตาราง หากมี objectId จะต้องอ้างอิงถึงตาราง

text

string

ข้อความที่จะแทรก

การแทรกอักขระขึ้นบรรทัดใหม่จะเป็นการสร้าง ParagraphMarker ใหม่โดยนัยที่ดัชนีนั้น ระบบจะคัดลอกรูปแบบย่อหน้าของย่อหน้าใหม่จากย่อหน้าที่ดัชนีการแทรกปัจจุบัน รวมถึงรายการและสัญลักษณ์แสดงหัวข้อย่อย

ระบบจะกำหนดรูปแบบข้อความสำหรับข้อความที่แทรกโดยอัตโนมัติ ซึ่งโดยทั่วไปแล้วจะคงรูปแบบของข้อความที่อยู่ใกล้เคียง ในกรณีส่วนใหญ่ ระบบจะเพิ่มข้อความลงใน TextRun ที่ดัชนีการแทรก

ระบบจะนำอักขระควบคุมบางตัว (U+0000-U+0008, U+000C-U+001F) และอักขระจากพื้นที่การใช้งานส่วนตัวของระนาบหลายภาษาพื้นฐานของ Unicode (U+E000-U+F8FF) ออกจากข้อความที่แทรก

insertionIndex

integer

ดัชนีที่จะแทรกข้อความในหน่วยโค้ด Unicode โดยอิงตาม TextElement ดัชนี

ดัชนีเป็นแบบอิงตาม 0 และคำนวณจากจุดเริ่มต้นของสตริง ระบบอาจปรับดัชนีเพื่อป้องกันการแทรกภายในกลุ่มกราฟีม Unicode ในกรณีเหล่านี้ ระบบจะแทรกข้อความต่อจากกลุ่มกราฟีมทันที

InsertTableRowsRequest

แทรกแถวลงในตาราง

การแสดง JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
ช่อง
tableObjectId

string

ตารางที่จะแทรกแถว

cellLocation

object (TableCellLocation)

ตำแหน่งเซลล์ในตารางอ้างอิงที่จะแทรกแถว

ระบบจะแทรกแถวใหม่เหนือ (หรือใต้) แถวที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสาน ระบบจะแทรกแถวใหม่เหนือ (หรือใต้) เซลล์ที่ผสาน

insertBelow

boolean

ระบุว่าจะแทรกแถวใหม่ใต้ตำแหน่งเซลล์อ้างอิงหรือไม่

  • True : แทรกใต้เซลล์
  • False : แทรกเหนือเซลล์
number

integer

จำนวนแถวที่จะแทรก สูงสุด 20 รายการต่อคำขอ

InsertTableColumnsRequest

แทรกคอลัมน์ลงในตาราง

ระบบจะปรับขนาดคอลัมน์อื่นๆ ในตารางให้พอดีกับคอลัมน์ใหม่

การแสดง JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
ช่อง
tableObjectId

string

ตารางที่จะแทรกคอลัมน์

cellLocation

object (TableCellLocation)

ตำแหน่งเซลล์ในตารางอ้างอิงที่จะแทรกคอลัมน์

ระบบจะแทรกคอลัมน์ใหม่ทางด้านซ้าย (หรือขวา) ของคอลัมน์ที่มีเซลล์อ้างอิง หากเซลล์อ้างอิงเป็นเซลล์ที่ผสาน ระบบจะแทรกคอลัมน์ใหม่ทางด้านซ้าย (หรือขวา) ของเซลล์ที่ผสาน

insertRight

boolean

เลือกว่าจะแทรกคอลัมน์ใหม่ทางด้านขวาของตำแหน่งเซลล์อ้างอิงหรือไม่

  • True : แทรกไปทางขวา
  • False : แทรกไปทางซ้าย
number

integer

จำนวนคอลัมน์ที่จะแทรก สูงสุด 20 รายการต่อคำขอ

DeleteTableRowRequest

ลบแถวออกจากตาราง

การแสดง JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
ช่อง
tableObjectId

string

ตารางที่จะลบแถว

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตารางอ้างอิงที่จะลบแถว

ระบบจะลบแถวที่เซลล์นี้ครอบคลุม หากเป็นเซลล์ที่ผสาน ระบบจะลบหลายแถว หากไม่มีแถวเหลืออยู่ในตารางหลังจากการลบนี้ ระบบจะลบทั้งตาราง

DeleteTableColumnRequest

ลบคอลัมน์ออกจากตาราง

การแสดง JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
ช่อง
tableObjectId

string

ตารางที่จะลบคอลัมน์

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตารางอ้างอิงที่จะลบคอลัมน์

ระบบจะลบคอลัมน์ที่เซลล์นี้ครอบคลุม หากเป็นเซลล์ที่ผสาน ระบบจะลบคอลัมน์หลายรายการ หากไม่มีคอลัมน์เหลืออยู่ในตารางหลังจากการลบนี้ ระบบจะลบทั้งตาราง

ReplaceAllTextRequest

แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ตรงกับเกณฑ์ด้วย replace text

การแสดง JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
ช่อง
replaceText

string

ข้อความที่จะแทนที่ข้อความที่ตรงกัน

pageObjectIds[]

string

หากไม่ว่างเปล่า จะจำกัดการจับคู่เฉพาะองค์ประกอบของหน้าในหน้าเว็บที่ระบุ

แสดงข้อผิดพลาด 400 คำขอไม่ถูกต้องหากระบุรหัสออบเจ็กต์หน้าของ notes master หรือหากไม่มีหน้าที่มีรหัสออบเจ็กต์ดังกล่าวในงานนำเสนอ

เกณฑ์ที่ใช้ในการจับคู่ข้อความที่จะแทนที่ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
containsText

object (SubstringMatchCriteria)

ค้นหาข้อความในรูปร่างที่ตรงกับสตริงย่อยนี้

สิ้นสุดฟิลด์ที่แยกกัน

SubstringMatchCriteria

เกณฑ์ที่ตรงกับสตริงข้อความที่เฉพาะเจาะจงในรูปร่างหรือตาราง

การแสดง JSON 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
ช่อง
text

string

ข้อความที่จะค้นหาในรูปร่างหรือตาราง

matchCase

boolean

ระบุว่าการค้นหาควรคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่หรือไม่

  • True : การค้นหาคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • False : การค้นหาไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
searchByRegex

boolean

ไม่บังคับ จริง หากควรถือว่าค่าที่ค้นหาเป็นนิพจน์ทั่วไป ควรหลีกเลี่ยงการใช้แบ็กสแลชในรูปแบบ

  • True : ระบบจะถือว่าข้อความค้นหาเป็นนิพจน์ทั่วไป
  • False : ระบบจะถือว่าข้อความค้นหาเป็นสตริงย่อยสำหรับการจับคู่

DeleteObjectRequest

ลบออบเจ็กต์ pages หรือ page elements ออกจากงานนำเสนอ

การแสดง JSON 
{
  "objectId": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของหน้าหรือองค์ประกอบของหน้าที่ต้องการลบ

หากหลังจากการดำเนินการลบ group มีองค์ประกอบหน้าเพียง 1 รายการหรือไม่มีเลย ระบบจะลบกลุ่มด้วย

หากลบตัวยึดตำแหน่งในเลย์เอาต์ ระบบจะลบตัวยึดตำแหน่งที่ว่างเปล่าซึ่งรับค่ามาด้วย

UpdatePageElementTransformRequest

อัปเดตการเปลี่ยนรูปขององค์ประกอบของหน้า

การอัปเดตการเปลี่ยนรูปแบบของกลุ่มจะเปลี่ยนการเปลี่ยนรูปแบบสัมบูรณ์ขององค์ประกอบหน้าในกลุ่มนั้น ซึ่งอาจเปลี่ยนลักษณะที่ปรากฏขององค์ประกอบ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบสำหรับ PageElement.transform

การแสดง JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ขององค์ประกอบของหน้าที่จะอัปเดต

transform

object (AffineTransform)

เมทริกซ์การแปลงอินพุตที่ใช้เพื่ออัปเดตองค์ประกอบของหน้า

applyMode

enum (ApplyMode)

โหมดใช้ของการอัปเดตการเปลี่ยนรูป

ApplyMode

โหมดการใช้การอัปเดตการเปลี่ยนรูป

Enum
APPLY_MODE_UNSPECIFIED โหมดที่ไม่ได้ระบุ
RELATIVE ใช้เมทริกซ์ AffineTransform ใหม่กับเมทริกซ์ที่มีอยู่ และแทนที่เมทริกซ์ที่มีอยู่ด้วยการเชื่อมโยงที่ได้
ABSOLUTE แทนที่เมทริกซ์ AffineTransform ที่มีอยู่ด้วยเมทริกซ์ใหม่

UpdateSlidesPositionRequest

อัปเดตตำแหน่งของสไลด์ในงานนำเสนอ

การแสดง JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
ช่อง
slideObjectIds[]

string

รหัสของสไลด์ในงานนำเสนอที่ควรย้าย สไลด์ในรายการนี้ต้องอยู่ในลำดับการนำเสนอที่มีอยู่แล้วโดยไม่มีสไลด์ซ้ำ

insertionIndex

integer

ดัชนีที่ควรแทรกสไลด์ โดยอิงตามการจัดเรียงสไลด์ก่อนที่จะย้าย ต้องอยู่ระหว่าง 0 ถึงจำนวนสไลด์ในงานนำเสนอ (รวม)

DeleteTextRequest

ลบข้อความออกจากรูปร่างหรือเซลล์ตาราง

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่จะลบข้อความ

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตาราง (ไม่บังคับ) หากต้องการลบข้อความออกจากเซลล์ในตาราง หากมี objectId จะต้องอ้างอิงถึงตาราง

textRange

object (Range)

ช่วงของข้อความที่จะลบโดยอิงตาม TextElement ดัชนี

ที่ท้ายข้อความของรูปร่างหรือเซลล์ตารางจะมีอักขระขึ้นบรรทัดใหม่โดยนัยเสมอ ซึ่งลบไม่ได้ Range.Type.ALL จะใช้ขอบเขตที่ถูกต้อง แต่ต้องระมัดระวังเมื่อระบุขอบเขตที่ชัดเจนสำหรับประเภทช่วง FROM_START_INDEX และ FIXED_RANGE ตัวอย่างเช่น หากข้อความคือ "ABC" ตามด้วยบรรทัดใหม่โดยนัย ค่าสูงสุดจะเป็น 2 สำหรับ textRange.start_index และ 3 สำหรับ textRange.end_index

การลบข้อความที่ข้ามขอบเขตย่อหน้าอาจส่งผลให้เกิดการเปลี่ยนแปลงสไตล์ย่อหน้าและรายการ เนื่องจากระบบจะผสานย่อหน้าทั้ง 2 เข้าด้วยกัน

ระบบจะขยายช่วงที่มีหน่วยโค้ดของคู่แทนเพียงหน่วยเดียวให้รวมหน่วยโค้ดทั้ง 2 หน่วย

ช่วง

ระบุช่วงที่ต่อเนื่องของคอลเล็กชันที่จัดทำดัชนี เช่น อักขระในข้อความ

การแสดง JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
ช่อง
startIndex

integer

ดัชนีแบบอิงตาม 0 ที่ไม่บังคับของจุดเริ่มต้นของคอลเล็กชัน ต้องระบุสำหรับช่วง FIXED_RANGE และ FROM_START_INDEX

endIndex

integer

ดัชนีที่อิงตาม 0 ของตอนท้ายของคอลเล็กชัน (ไม่บังคับ) ต้องระบุสำหรับ FIXED_RANGE ช่วง

type

enum (Type)

ประเภทของช่วง

ประเภท

ประเภทของช่วง

Enum
RANGE_TYPE_UNSPECIFIED ประเภทช่วงที่ไม่ได้ระบุ ห้ามใช้ค่านี้
FIXED_RANGE ช่วงคงที่ ต้องระบุทั้ง startIndex และ endIndex
FROM_START_INDEX เริ่มช่วงที่ startIndex และดำเนินการต่อจนกว่าจะสิ้นสุดการเก็บรวบรวม ห้ามระบุ endIndex
ALL ตั้งค่าช่วงให้มีความยาวเท่ากับความยาวทั้งหมดของคอลเล็กชัน ต้องไม่ระบุทั้ง startIndex และ endIndex

CreateImageRequest

สร้างรูปภาพ

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  "url": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

elementProperties

object (PageElementProperties)

พร็อพเพอร์ตี้ขององค์ประกอบสำหรับรูปภาพ

เมื่อสัดส่วนภาพของขนาดที่ระบุไม่ตรงกับสัดส่วนภาพ ระบบจะปรับขนาดและจัดกึ่งกลางรูปภาพตามขนาดเพื่อให้คงสัดส่วนภาพไว้ ระบบจะใช้การเปลี่ยนรูปแบบที่ระบุหลังจากการดำเนินการนี้

พร็อพเพอร์ตี้ PageElementProperties.size เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ หากไม่ได้ระบุขนาด ระบบจะใช้ขนาดเริ่มต้นของรูปภาพ

พร็อพเพอร์ตี้ PageElementProperties.transform เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ หากไม่ได้ระบุการเปลี่ยนรูป ระบบจะวางรูปภาพไว้ที่มุมซ้ายบนของหน้า

ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
url

string

URL ของรูปภาพ

ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในเวลาที่แทรก และจัดเก็บสำเนาไว้เพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดไม่เกิน 50 MB, มีความละเอียดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีความยาวไม่เกิน 2 KB ระบบจะบันทึก URL พร้อมกับรูปภาพและแสดงผ่านฟิลด์ Image.source_url

สิ้นสุดฟิลด์ที่แยกกัน

CreateVideoRequest

สร้างวิดีโอ

หมายเหตุ: การสร้างวิดีโอจาก Google ไดรฟ์กำหนดให้แอปที่ขอต้องมีขอบเขต OAuth อย่างน้อย 1 รายการจาก drive, drive.readonly หรือ drive.file

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

elementProperties

object (PageElementProperties)

พร็อพเพอร์ตี้ขององค์ประกอบสำหรับวิดีโอ

พร็อพเพอร์ตี้ PageElementProperties.size เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ หากไม่ได้ระบุขนาด เซิร์ฟเวอร์จะเลือกขนาดเริ่มต้นให้

พร็อพเพอร์ตี้ PageElementProperties.transform เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ การเปลี่ยนรูปต้องไม่มีองค์ประกอบการเฉือน หากไม่ได้ระบุการเปลี่ยนรูปแบบ วิดีโอจะอยู่ที่มุมซ้ายบนของหน้า

source

enum (Source)

แหล่งที่มาของวิดีโอ

id

string

ตัวระบุที่ไม่ซ้ำกันของแหล่งที่มาของวิดีโอสำหรับวิดีโอนี้

เช่น สำหรับวิดีโอ YouTube https://www.youtube.com/watch?v=7U3axjORYZ0 รหัสคือ 7U3axjORYZ0 สำหรับวิดีโอใน Google ไดรฟ์ https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q รหัสคือ 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q

หากต้องการเข้าถึงไฟล์วิดีโอใน Google ไดรฟ์ คุณอาจต้องเพิ่มคีย์ทรัพยากรลงในส่วนหัว HTTP สำหรับชุดย่อยของไฟล์เก่า ดูข้อมูลเพิ่มเติมได้ที่ เข้าถึงไฟล์ที่แชร์ลิงก์โดยใช้คีย์ทรัพยากร

CreateSheetsChartRequest

สร้างแผนภูมิ Google ชีตแบบฝัง

หมายเหตุ: การสร้างแผนภูมิต้องใช้ขอบเขต OAuth อย่างน้อย 1 รายการจาก spreadsheets.readonly, spreadsheets, drive.readonly, drive.file หรือ drive

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากระบุไว้ รหัสต้องไม่ซ้ำกันในหน้าและองค์ประกอบของหน้าทั้งหมดในงานนำเสนอ รหัสควรขึ้นต้นด้วยอักขระของคำ [a-zA-Z0-9_] แล้วตามด้วยอักขระต่อไปนี้ [a-zA-Z0-9_-:] จำนวนเท่าใดก็ได้ ความยาวของรหัสไม่ควรน้อยกว่า 5 หรือมากกว่า 50 หากไม่มีข้อมูล ระบบจะสร้างตัวระบุที่ไม่ซ้ำกัน

elementProperties

object (PageElementProperties)

คุณสมบัติขององค์ประกอบสำหรับแผนภูมิ

เมื่อสัดส่วนภาพของขนาดที่ระบุไม่ตรงกับสัดส่วนภาพของแผนภูมิ ระบบจะปรับขนาดและจัดกึ่งกลางแผนภูมิตามขนาดเพื่อรักษาสัดส่วนภาพ ระบบจะใช้การเปลี่ยนรูปแบบที่ระบุหลังจากการดำเนินการนี้

spreadsheetId

string

รหัสของสเปรดชีตใน Google ชีตที่มีแผนภูมิ

คุณอาจต้องเพิ่มคีย์ทรัพยากรลงในส่วนหัว HTTP สำหรับไฟล์เก่าบางส่วน ดูข้อมูลเพิ่มเติมได้ที่ เข้าถึงไฟล์ที่แชร์ลิงก์โดยใช้คีย์ทรัพยากร

chartId

integer

รหัสของแผนภูมิที่เฉพาะเจาะจงในสเปรดชีต Google ชีต

linkingMode

enum (LinkingMode)

โหมดที่ลิงก์แผนภูมิกับสเปรดชีตต้นฉบับ หากไม่ได้ระบุ ระบบจะถือว่าแผนภูมิเป็นรูปภาพที่ไม่ได้ลิงก์

LinkingMode

โหมดที่ลิงก์แผนภูมิกับสเปรดชีตต้นฉบับ

Enum
NOT_LINKED_IMAGE แผนภูมิไม่ได้เชื่อมโยงกับสเปรดชีตต้นทางและอัปเดตไม่ได้ ระบบจะแทรกแผนภูมิที่ไม่ได้ลิงก์เป็นรูปภาพ
LINKED การลิงก์แผนภูมิจะช่วยให้อัปเดตได้ และผู้ทำงานร่วมกันคนอื่นๆ จะเห็นลิงก์ไปยังสเปรดชีต

CreateLineRequest

สร้างเส้น

การแสดง JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุ

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

elementProperties

object (PageElementProperties)

พร็อพเพอร์ตี้ขององค์ประกอบสำหรับเส้น

lineCategory
(deprecated)

enum (Category)

หมวดหมู่ของบรรทัดที่จะสร้าง

เลิกใช้งานแล้ว : ใช้ category แทน

ระบบจะกำหนด line type ที่แน่นอนซึ่งสร้างขึ้นตามหมวดหมู่และวิธีกำหนดเส้นทางเพื่อเชื่อมต่อกับองค์ประกอบอื่นๆ ของหน้าเว็บ

หากคุณระบุทั้ง category และ lineCategory category จะมีความสำคัญเหนือกว่า

category

enum (LineCategory)

หมวดหมู่ของบรรทัดที่จะสร้าง

ระบบจะกำหนด line type ที่แน่นอนตามหมวดหมู่และวิธีกำหนดเส้นทางเพื่อเชื่อมต่อกับองค์ประกอบอื่นๆ ของหน้า

หากคุณระบุทั้ง category และ lineCategory category จะมีความสำคัญเหนือกว่า

หากคุณไม่ได้ระบุค่าสำหรับ category แต่ระบุค่าสำหรับ lineCategory ระบบจะใช้ค่า lineCategory ที่ระบุ

หากคุณไม่ได้ระบุทั้ง 2 อย่าง ระบบจะใช้ STRAIGHT

หมวดหมู่

หมวดหมู่สาย

Enum
STRAIGHT ขั้วต่อตรง รวมถึงขั้วต่อตรง 1 โดยจะเป็นหมวดหมู่เริ่มต้นเมื่อไม่ได้ระบุหมวดหมู่
BENT ขั้วต่อที่งอ รวมถึงขั้วต่อที่งอ 2 ถึง 5
CURVED เส้นเชื่อมแบบโค้ง รวมถึงเส้นเชื่อมแบบโค้ง 2 ถึง 5

RefreshSheetsChartRequest

รีเฟรชแผนภูมิ Google ชีตที่ฝังโดยแทนที่ด้วยแผนภูมิเวอร์ชันล่าสุดจาก Google ชีต

หมายเหตุ: การรีเฟรชแผนภูมิต้องใช้ขอบเขต OAuth อย่างน้อย 1 รายการจาก spreadsheets.readonly, spreadsheets, drive.readonly หรือ drive

การแสดง JSON 
{
  "objectId": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของแผนภูมิที่จะรีเฟรช

UpdateShapePropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Shape

การแสดง JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างที่จะใช้การอัปเดต

shapeProperties

object (ShapeProperties)

พร็อพเพอร์ตี้รูปร่างที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท shapeProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเติมพื้นหลังแบบทึบของรูปร่าง ให้ตั้งค่า fields เป็น "shapeBackgroundFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdateImagePropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Image

การแสดง JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปภาพที่ใช้การอัปเดต

imageProperties

object (ImageProperties)

พร็อพเพอร์ตี้รูปภาพที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท imageProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเส้นขอบของรูปภาพ ให้ตั้งค่า fields เป็น "outline.outlineFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdateVideoPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Video

การแสดง JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของวิดีโอที่ใช้การอัปเดต

videoProperties

object (VideoProperties)

คุณสมบัติวิดีโอที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท videoProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเส้นขอบวิดีโอ ให้ตั้งค่า fields เป็น "outline.outlineFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdatePagePropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Page

การแสดง JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของหน้าที่ใช้การอัปเดต

pageProperties

object (PageProperties)

พร็อพเพอร์ตี้หน้าเว็บที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท pageProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีพื้นหลังแบบทึบของหน้าเว็บ ให้ตั้งค่า fields เป็น "pageBackgroundFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdateTableCellPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ TableCell

การแสดง JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

tableRange

object (TableRange)

ช่วงตารางที่แสดงถึงชุดย่อยของตารางที่จะใช้การอัปเดต หากไม่ได้ระบุช่วงตาราง การอัปเดตจะมีผลกับทั้งตาราง

tableCellProperties

object (TableCellProperties)

คุณสมบัติของเซลล์ตารางที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท tableCellProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเติมแบบทึบของพื้นหลังของตาราง ให้ตั้งค่า fields เป็น "tableCellBackgroundFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

TableRange

ช่วงตารางแสดงถึงการอ้างอิงไปยังชุดย่อยของตาราง

โปรดทราบว่าเซลล์ที่ระบุโดยช่วงตารางไม่จำเป็นต้องเป็นรูปสี่เหลี่ยมผืนผ้า ตัวอย่างเช่น สมมติว่าเรามีตารางขนาด 3 x 3 ที่ผสานเซลล์ทั้งหมดในแถวสุดท้ายเข้าด้วยกัน ตารางจะมีลักษณะดังนี้ 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

ช่วงตารางที่มีตำแหน่ง = (0, 0), ช่วงแถว = 3 และช่วงคอลัมน์ = 2 จะระบุเซลล์ต่อไปนี้ 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
การแสดง JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
ช่อง
location

object (TableCellLocation)

ตำแหน่งเริ่มต้นของช่วงตาราง

rowSpan

integer

ช่วงแถวของช่วงตาราง

columnSpan

integer

ช่วงคอลัมน์ของช่วงตาราง

UpdateLinePropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Line

การแสดง JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของบรรทัดที่ใช้การอัปเดต

lineProperties

object (LineProperties)

พร็อพเพอร์ตี้ของเส้นที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท lineProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเติมเส้นทึบ ให้ตั้งค่า fields เป็น "lineFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

CreateParagraphBulletsRequest

สร้างหัวข้อย่อยสำหรับย่อหน้าทั้งหมดที่ทับซ้อนกับช่วงดัชนีข้อความที่ระบุ

ระดับการซ้อนของแต่ละย่อหน้าจะกำหนดโดยการนับแท็บนำหน้าแต่ละย่อหน้า คำขอนี้จะนำแท็บนำออกเพื่อหลีกเลี่ยงช่องว่างที่มากเกินไประหว่างหัวข้อย่อยกับย่อหน้าที่เกี่ยวข้อง ซึ่งอาจเปลี่ยนดัชนีของข้อความบางส่วน

หากย่อหน้าก่อนหน้าย่อหน้าที่กำลังอัปเดตอยู่ในรายการที่มีค่าที่กำหนดไว้ล่วงหน้าที่ตรงกัน ระบบจะเพิ่มย่อหน้าที่กำลังอัปเดตลงในรายการก่อนหน้า

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่มีข้อความที่จะเพิ่มสัญลักษณ์แสดงหัวข้อย่อย

cellLocation

object (TableCellLocation)

ตำแหน่งเซลล์ตารางที่ไม่บังคับ หากข้อความที่จะแก้ไขอยู่ในเซลล์ตาราง หากมี objectId จะต้องอ้างอิงถึงตาราง

textRange

object (Range)

ช่วงของข้อความที่จะใช้ค่าที่ตั้งไว้ล่วงหน้าของหัวข้อย่อย โดยอิงตาม TextElement ดัชนี

bulletPreset

enum (BulletGlyphPreset)

ประเภทของสัญลักษณ์หัวข้อย่อยที่จะใช้ ค่าเริ่มต้นคือ BULLET_DISC_CIRCLE_SQUARE ที่กำหนดล่วงหน้า

BulletGlyphPreset

รูปแบบที่กำหนดไว้ล่วงหน้าของสัญลักษณ์หัวข้อย่อยสำหรับรายการในข้อความ

รูปแบบเหล่านี้ใช้หัวข้อย่อยต่อไปนี้

  • ARROW : ลูกศรที่สอดคล้องกับ Code Point ของ Unicode U+2794
  • ARROW3D : ลูกศรที่มีการแรเงาสามมิติ ซึ่งสอดคล้องกับโค้ดพอยต์ Unicode U+27a2
  • CHECKBOX : สี่เหลี่ยมกลวง ซึ่งสอดคล้องกับ Code Point ของ Unicode U+274f
  • CIRCLE : วงกลมกลวง ซึ่งสอดคล้องกับ Code Point ของ Unicode U+25cb
  • DIAMOND : เพชรทึบ ซึ่งสอดคล้องกับ Code Point ของ Unicode U+25c6
  • DIAMONDX : สี่เหลี่ยมข้าวหลามตัดที่มี "x" ซึ่งสอดคล้องกับ Code Point ของ Unicode U+2756
  • HOLLOWDIAMOND : ข้าวหลามตัดแบบโปร่ง ซึ่งสอดคล้องกับ Code Point ของ Unicode U+25c7
  • DISC : วงกลมทึบที่สอดคล้องกับ Code Point ของ Unicode U+25cf
  • SQUARE : สี่เหลี่ยมทึบที่สอดคล้องกับจุดโค้ด Unicode U+25a0
  • STAR : ดาว ซึ่งสอดคล้องกับ Code Point ของ Unicode U+2605
  • ALPHA : ตัวอักษรพิมพ์เล็ก เช่น "ก" "ข" หรือ "ค"
  • UPPERALPHA : ตัวพิมพ์ใหญ่ เช่น "A", "B" หรือ "C"
  • DIGIT : ตัวเลข เช่น "1" "2" หรือ "3"
  • ZERODIGIT : ตัวเลขที่นำหน้าตัวเลขหลักเดียวด้วย 0 เช่น "01" "02" หรือ "03" หมายเลขที่มีมากกว่า 1 หลักจะไม่มีคำนำหน้าเป็น 0
  • ROMAN : ตัวเลขโรมันพิมพ์เล็ก เช่น "i", "ii" หรือ "iii"
  • UPPERROMAN : เลขโรมันตัวพิมพ์ใหญ่ เช่น "I" "II" หรือ "III"
  • LEFTTRIANGLE : สามเหลี่ยมชี้ไปทางซ้าย ซึ่งสอดคล้องกับจุดโค้ด Unicode U+25c4
Enum
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_DIGIT_ALPHA_ROMAN รายการที่เรียงลำดับเลขซึ่งมี DIGIT, ALPHA และ ROMAN สัญลักษณ์ตัวเลขสำหรับระดับการซ้อนรายการ 3 ระดับแรก ตามด้วยจุด
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS รายการที่เรียงลำดับเลขที่มี DIGIT, ALPHA และ ROMAN รูปอักขระตัวเลขสำหรับระดับการซ้อนรายการ 3 ระดับแรก ตามด้วยวงเล็บ
NUMBERED_DIGIT_NESTED รายการที่เรียงลำดับเลขพร้อม DIGIT รูปอักขระตัวเลขที่คั่นด้วยจุด โดยแต่ละระดับการซ้อนจะใช้รูปอักขระของระดับการซ้อนก่อนหน้าเป็นคำนำหน้า เช่น "1." '1.1.', '2.', '2.2.'
NUMBERED_UPPERALPHA_ALPHA_ROMAN รายการที่เรียงลำดับเลขซึ่งมี UPPERALPHA, ALPHA และ ROMAN สัญลักษณ์รูปลักษณ์แบบตัวเลขสำหรับระดับการซ้อนรายการ 3 ระดับแรก ตามด้วยจุด
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT รายการที่เรียงลำดับเลขซึ่งมี UPPERROMAN, UPPERALPHA และ DIGIT สัญลักษณ์ตัวเลขสำหรับระดับการซ้อนรายการ 3 ระดับแรก ตามด้วยจุด
NUMBERED_ZERODIGIT_ALPHA_ROMAN รายการที่เรียงลำดับเลขซึ่งมี ZERODIGIT, ALPHA และ ROMAN สัญลักษณ์ตัวเลขสำหรับระดับการซ้อนรายการ 3 ระดับแรก ตามด้วยจุด

ReplaceAllShapesWithImageRequest

แทนที่รูปร่างทั้งหมดที่ตรงกับเกณฑ์ที่ระบุด้วยรูปภาพที่ให้ไว้

รูปภาพที่แทนที่รูปร่างจะเป็นสี่เหลี่ยมผืนผ้าหลังจากแทรกลงในงานนำเสนอ และจะไม่ใช้รูปแบบของรูปร่าง

การแสดง JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  "containsText": {
    object (SubstringMatchCriteria)
  }

  "imageUrl": string
}
ช่อง
replaceMethod
(deprecated)

enum (ReplaceMethod)

เมธอด replace

เลิกใช้งานแล้ว : ใช้ imageReplaceMethod แทน

หากคุณระบุทั้ง replaceMethod และ imageReplaceMethod imageReplaceMethod จะมีความสำคัญเหนือกว่า

imageReplaceMethod

enum (ImageReplaceMethod)

วิธีการแทนที่รูปภาพ

หากคุณระบุทั้ง replaceMethod และ imageReplaceMethod imageReplaceMethod จะมีความสำคัญเหนือกว่า

หากคุณไม่ได้ระบุค่าสำหรับ imageReplaceMethod แต่ระบุค่าสำหรับ replaceMethod ระบบจะใช้ค่า replaceMethod ที่ระบุ

หากไม่ได้ระบุทั้ง 2 อย่าง ระบบจะใช้ CENTER_INSIDE

pageObjectIds[]

string

หากไม่ว่างเปล่า จะจำกัดการจับคู่เฉพาะองค์ประกอบของหน้าในหน้าเว็บที่ระบุ

แสดงข้อผิดพลาด 400 คำขอไม่ถูกต้องหากระบุรหัสออบเจ็กต์หน้าของ notes page หรือ notes master หรือหากไม่มีหน้าที่มีรหัสออบเจ็กต์ดังกล่าวในงานนำเสนอ

เกณฑ์ที่รูปร่างต้องตรงกันจึงจะแทนที่ได้ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
containsText

object (SubstringMatchCriteria)

หากตั้งค่าไว้ คำขอนี้จะแทนที่รูปร่างทั้งหมดที่มีข้อความที่ระบุ

สิ้นสุดฟิลด์ที่แยกกัน
ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
imageUrl

string

URL ของรูปภาพ

ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในเวลาที่แทรก และจัดเก็บสำเนาไว้เพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดไม่เกิน 50 MB มีความละเอียดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URL ที่ระบุต้องมีความยาวไม่เกิน 2 KB ระบบจะบันทึก URL ไว้กับรูปภาพและแสดงผ่านฟิลด์ Image.source_url

สิ้นสุดฟิลด์ที่แยกกัน

ReplaceMethod

เมธอด replace

Enum
CENTER_INSIDE ปรับขนาดและจัดกึ่งกลางรูปภาพให้พอดีกับขอบเขตของรูปร่างต้นฉบับและรักษาสัดส่วนภาพของรูปภาพ ขนาดที่แสดงของรูปภาพอาจเล็กกว่าขนาดของรูปร่าง ซึ่งเป็นวิธีเริ่มต้นเมื่อไม่ได้ระบุวิธีใด
CENTER_CROP ปรับขนาดและจัดกึ่งกลางรูปภาพให้พอดีกับขอบเขตของรูปร่างเดิม ระบบอาจครอบตัดรูปภาพเพื่อให้พอดีกับรูปร่าง ขนาดที่แสดงของรูปภาพจะเท่ากับขนาดของรูปร่างเดิม

ImageReplaceMethod

วิธีการแทนที่รูปภาพ

Enum
IMAGE_REPLACE_METHOD_UNSPECIFIED วิธีการแทนที่รูปภาพที่ไม่ระบุ ห้ามใช้ค่านี้
CENTER_INSIDE ปรับขนาดและจัดกึ่งกลางรูปภาพให้พอดีกับขอบเขตของรูปร่างต้นฉบับและรักษาสัดส่วนภาพของรูปภาพ ขนาดที่แสดงของรูปภาพอาจเล็กกว่าขนาดของรูปร่าง ซึ่งเป็นวิธีเริ่มต้นเมื่อไม่ได้ระบุวิธีใด
CENTER_CROP ปรับขนาดและจัดกึ่งกลางรูปภาพให้พอดีกับขอบเขตของรูปร่างเดิม ระบบอาจครอบตัดรูปภาพเพื่อให้พอดีกับรูปร่าง ขนาดที่แสดงของรูปภาพจะมีขนาดเท่ากับรูปร่างเดิม

DuplicateObjectRequest

ทำซ้ำองค์ประกอบสไลด์หรือองค์ประกอบของหน้า

เมื่อทำซ้ำสไลด์ ระบบจะสร้างสไลด์ที่ทำซ้ำต่อจากสไลด์ที่ระบุทันที เมื่อทำซ้ำองค์ประกอบของหน้า ระบบจะวางองค์ประกอบที่ทำซ้ำไว้ในหน้าเดียวกันที่ตำแหน่งเดียวกับองค์ประกอบเดิม

การแสดง JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
ช่อง
objectId

string

รหัสของออบเจ็กต์ที่จะทำซ้ำ

objectIds

map (key: string, value: string)

ออบเจ็กต์ที่ทำซ้ำอาจมีออบเจ็กต์อื่นๆ เช่น เมื่อทำซ้ำสไลด์หรือองค์ประกอบหน้ากลุ่ม แผนที่นี้กำหนดวิธีสร้างรหัสของออบเจ็กต์ที่ซ้ำกัน โดยคีย์คือรหัสของออบเจ็กต์เดิม และค่าคือรหัสที่จะกำหนดให้กับออบเจ็กต์ที่ซ้ำกันที่เกี่ยวข้อง คุณยังระบุรหัสของออบเจ็กต์ต้นฉบับที่ซ้ำกันในแผนที่นี้ได้ด้วย โดยใช้ค่าเดียวกันของฟิลด์ objectId เป็นคีย์ และรหัสใหม่ที่ต้องการเป็นค่า

คีย์ทั้งหมดต้องสอดคล้องกับรหัสที่มีอยู่ในการนำเสนอ ค่าทั้งหมดต้องไม่ซ้ำกันในงานนำเสนอ และต้องขึ้นต้นด้วยตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสใหม่ต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากละเว้นรหัสของออบเจ็กต์แหล่งที่มาจากแผนที่ ระบบจะกำหนดรหัสแบบสุ่มใหม่ หากแผนที่ว่างเปล่าหรือไม่ได้ตั้งค่า ออบเจ็กต์ที่ซ้ำกันทั้งหมดจะได้รับรหัสแบบสุ่มใหม่

UpdateTextStyleRequest

อัปเดตรูปแบบของข้อความใน Shape หรือ Table

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่มีข้อความที่จะจัดรูปแบบ

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตารางที่มีข้อความที่จะจัดรูปแบบ หาก objectId อ้างอิงถึงตาราง cellLocation ต้องมีค่า ไม่เช่นนั้นจะต้องไม่ระบุ

style

object (TextStyle)

รูปแบบที่จะตั้งค่าในข้อความ

หากค่าของสไตล์ใดสไตล์หนึ่งตรงกับค่าของสไตล์ระดับบน ระบบจะตั้งค่าสไตล์นั้นให้รับค่า

การเปลี่ยนแปลงรูปแบบข้อความบางอย่างอาจทำให้เกิดการเปลี่ยนแปลงอื่นๆ ที่มีไว้เพื่อจำลองลักษณะการทำงานของโปรแกรมแก้ไขสไลด์ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ TextStyle

textRange

object (Range)

ช่วงของข้อความที่จะจัดรูปแบบ

ช่วงอาจขยายให้รวมบรรทัดใหม่ที่อยู่ติดกัน

หากช่วงมีย่อหน้าที่อยู่ในรายการอย่างสมบูรณ์ ระบบจะอัปเดตสัญลักษณ์หัวข้อย่อยของย่อหน้าด้วยรูปแบบข้อความที่ตรงกันด้วย

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท style อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตรูปแบบข้อความเป็นตัวหนา ให้ตั้งค่า fields เป็น "bold"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

ReplaceAllShapesWithSheetsChartRequest

แทนที่รูปร่างทั้งหมดที่ตรงกับเกณฑ์ที่ระบุด้วยแผนภูมิ Google ชีตที่ให้ไว้ ระบบจะปรับขนาดและจัดกึ่งกลางแผนภูมิให้พอดีกับขอบเขตของรูปร่างเดิม

หมายเหตุ: การแทนที่รูปร่างด้วยแผนภูมิต้องใช้ขอบเขต OAuth อย่างน้อย 1 รายการจาก spreadsheets.readonly, spreadsheets, drive.readonly หรือ drive

การแสดง JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
ช่อง
containsText

object (SubstringMatchCriteria)

เกณฑ์ที่รูปร่างต้องตรงกันจึงจะแทนที่ได้ คำขอจะแทนที่รูปร่างทั้งหมดที่มีข้อความที่ระบุ

spreadsheetId

string

รหัสของสเปรดชีตใน Google ชีตที่มีแผนภูมิ

chartId

integer

รหัสของแผนภูมิที่เฉพาะเจาะจงในสเปรดชีต Google ชีต

linkingMode

enum (LinkingMode)

โหมดที่ลิงก์แผนภูมิกับสเปรดชีตต้นฉบับ หากไม่ได้ระบุ ระบบจะถือว่าแผนภูมิเป็นรูปภาพที่ไม่ได้ลิงก์

pageObjectIds[]

string

หากไม่ว่างเปล่า จะจำกัดการจับคู่เฉพาะองค์ประกอบของหน้าในหน้าเว็บที่ระบุ

แสดงข้อผิดพลาด 400 คำขอไม่ถูกต้อง หากระบุรหัสออบเจ็กต์หน้าของ notes page หรือ notes master หรือหากไม่มีหน้าที่มีรหัสออบเจ็กต์ดังกล่าวในงานนำเสนอ

LinkingMode

โหมดที่ลิงก์แผนภูมิกับสเปรดชีตต้นฉบับ

Enum
NOT_LINKED_IMAGE แผนภูมิไม่ได้เชื่อมโยงกับสเปรดชีตต้นทางและอัปเดตไม่ได้ ระบบจะแทรกแผนภูมิที่ไม่ได้ลิงก์เป็นรูปภาพ
LINKED การลิงก์แผนภูมิจะช่วยให้อัปเดตได้ และผู้ทำงานร่วมกันคนอื่นๆ จะเห็นลิงก์ไปยังสเปรดชีต

DeleteParagraphBulletsRequest

ลบหัวข้อย่อยออกจากย่อหน้าทั้งหมดที่ทับซ้อนกับดัชนีข้อความที่ระบุ range

ระบบจะรักษาการฝังแต่ละย่อหน้าไว้ด้วยการเพิ่มการเยื้องที่จุดเริ่มต้นของย่อหน้าที่เกี่ยวข้อง

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่มีข้อความที่จะลบสัญลักษณ์แสดงหัวข้อย่อย

cellLocation

object (TableCellLocation)

ตำแหน่งเซลล์ตารางที่ไม่บังคับ หากข้อความที่จะแก้ไขอยู่ในเซลล์ตาราง หากมี objectId จะต้องอ้างอิงถึงตาราง

textRange

object (Range)

ช่วงของข้อความที่จะลบหัวข้อย่อยออก โดยอิงตาม TextElement ดัชนี

UpdateParagraphStyleRequest

อัปเดตรูปแบบสำหรับย่อหน้าทั้งหมดภายใน Shape หรือ Table ที่ทับซ้อนกับช่วงดัชนีข้อความที่ระบุ

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของรูปร่างหรือตารางที่มีข้อความที่จะจัดรูปแบบ

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตารางที่มีย่อหน้าที่จะจัดรูปแบบ หาก objectId อ้างอิงถึงตาราง cellLocation ต้องมีค่า ไม่เช่นนั้นจะต้องไม่ระบุ

style

object (ParagraphStyle)

รูปแบบของย่อหน้า

textRange

object (Range)

ช่วงของข้อความที่มีย่อหน้าที่ต้องการจัดรูปแบบ

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท style อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตการจัดแนวของย่อหน้า ให้ตั้งค่า fields เป็น "alignment"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdateTableBorderPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของเส้นขอบตารางใน Table

การแสดง JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

tableRange

object (TableRange)

ช่วงตารางที่แสดงถึงชุดย่อยของตารางที่จะใช้การอัปเดต หากไม่ได้ระบุช่วงตาราง การอัปเดตจะมีผลกับทั้งตาราง

borderPosition

enum (BorderPosition)

ตำแหน่งเส้นขอบในช่วงตารางที่ควรใช้การอัปเดต หากไม่ได้ระบุตำแหน่งเส้นขอบ การอัปเดตจะมีผลกับเส้นขอบทั้งหมดในช่วงตาราง

tableBorderProperties

object (TableBorderProperties)

คุณสมบัติเส้นขอบตารางที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท tableBorderProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตสีเติมทึบของเส้นขอบตาราง ให้ตั้งค่า fields เป็น "tableBorderFill.solidFill.color"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

BorderPosition

ตำแหน่งเส้นขอบตาราง

Enum
ALL เส้นขอบทั้งหมดในขอบเขต
BOTTOM ขอบเขตที่ด้านล่างของช่วง
INNER เส้นขอบด้านในของช่วง
INNER_HORIZONTAL เส้นขอบแนวนอนด้านในของช่วง
INNER_VERTICAL เส้นขอบแนวตั้งด้านในของช่วง
LEFT เส้นขอบทางด้านซ้ายของช่วง
OUTER เส้นขอบด้านนอกของช่วง
RIGHT เส้นขอบทางด้านขวาของช่วง
TOP ชายแดนที่อยู่ด้านบนสุดของช่วง

UpdateTableColumnPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของคอลัมน์ Table

การแสดง JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

columnIndices[]

integer

รายการดัชนีที่อิงตาม 0 ซึ่งระบุคอลัมน์ที่จะอัปเดต หากไม่ได้ระบุดัชนี ระบบจะอัปเดตคอลัมน์ทั้งหมดในตาราง

tableColumnProperties

object (TableColumnProperties)

พร็อพเพอร์ตี้ของคอลัมน์ในตารางที่จะอัปเดต

หากค่าของ tableColumnProperties#columnWidth ในคำขอน้อยกว่า 406,400 EMU (32 จุด) ระบบจะแสดงข้อผิดพลาด 400 Bad Request

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท tableColumnProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตความกว้างของคอลัมน์ ให้ตั้งค่า fields เป็น "columnWidth"

หากรวม '"columnWidth"' ไว้ในมาสก์ฟิลด์ แต่ไม่ได้ตั้งค่าพร็อพเพอร์ตี้ ระบบจะตั้งค่าเริ่มต้นความกว้างของคอลัมน์เป็น 406,400 EMU (32 จุด)

UpdateTableRowPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของ Table แถว

การแสดง JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

rowIndices[]

integer

รายการดัชนีที่อิงตาม 0 ซึ่งระบุแถวที่จะอัปเดต หากไม่ได้ระบุดัชนี ระบบจะอัปเดตแถวทั้งหมดในตาราง

tableRowProperties

object (TableRowProperties)

คุณสมบัติแถวของตารางที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท tableRowProperties อยู่แล้วและไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตความสูงขั้นต่ำของแถว ให้ตั้งค่า fields เป็น "minRowHeight"

หากรวม '"minRowHeight"' ไว้ในมาสก์ของฟิลด์ แต่ไม่ได้ตั้งค่าพร็อพเพอร์ตี้ไว้ ความสูงของแถวขั้นต่ำจะเป็น 0 โดยค่าเริ่มต้น

MergeTableCellsRequest

ผสานเซลล์ใน Table

การแสดง JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

tableRange

object (TableRange)

ช่วงตารางที่ระบุเซลล์ในตารางที่จะผสาน

ข้อความใดๆ ในเซลล์ที่ผสานจะเชื่อมต่อกันและจัดเก็บไว้ในเซลล์ด้านซ้ายบน ("ส่วนหัว") ของช่วง หากช่วงไม่ใช่สี่เหลี่ยมผืนผ้า (ซึ่งอาจเกิดขึ้นในบางกรณีที่ช่วงครอบคลุมเซลล์ที่ผสานไปแล้ว) ระบบจะแสดงข้อผิดพลาด 400 Bad Request

UnmergeTableCellsRequest

ยกเลิกการผสานเซลล์ใน Table

การแสดง JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

tableRange

object (TableRange)

ช่วงตารางที่ระบุเซลล์ในตารางที่จะยกเลิกการผสาน

ระบบจะยกเลิกการผสานเซลล์ทั้งหมดในช่วงนี้ และเซลล์ที่ยกเลิกการผสานไปแล้วจะไม่ได้รับผลกระทบ หากช่วงไม่มีเซลล์ที่ผสาน คำขอจะไม่ดำเนินการใดๆ หากมีข้อความในเซลล์ที่ผสาน ระบบจะเก็บข้อความไว้ในเซลล์ด้านซ้ายบน ("ส่วนหัว") ของบล็อกเซลล์ที่ไม่ได้ผสานที่ได้

GroupObjectsRequest

จัดกลุ่มออบเจ็กต์เพื่อสร้างกลุ่มออบเจ็กต์ เช่น กลุ่ม PageElements เพื่อสร้าง Group ในหน้าเดียวกันกับรายการย่อยทั้งหมด

การแสดง JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
ช่อง
groupObjectId

string

รหัสออบเจ็กต์ที่ผู้ใช้ระบุสำหรับกลุ่มที่จะสร้าง

หากคุณระบุรหัส รหัสดังกล่าวต้องไม่ซ้ำกันในหน้าเว็บและองค์ประกอบของหน้าเว็บทั้งหมดในงานนำเสนอ รหัสต้องขึ้นต้นด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_]) อักขระที่เหลืออาจมีอักขระดังกล่าว รวมถึงขีดกลางหรือโคลอน (ตรงกับนิพจน์ทั่วไป [a-zA-Z0-9_-:]) ความยาวของรหัสต้องไม่น้อยกว่า 5 หรือมากกว่า 50

หากไม่ได้ระบุรหัส ระบบจะสร้างรหัสที่ไม่ซ้ำกันให้

childrenObjectIds[]

string

รหัสออบเจ็กต์ของออบเจ็กต์ที่จะจัดกลุ่ม

จัดกลุ่มได้เฉพาะองค์ประกอบของหน้า ควรมีองค์ประกอบหน้าอย่างน้อย 2 รายการในหน้าเดียวกันที่ไม่ได้อยู่ในกลุ่มอื่นอยู่แล้ว จัดกลุ่มองค์ประกอบบางอย่างของหน้าเว็บไม่ได้ เช่น videos, tables และ placeholders

UngroupObjectsRequest

ยกเลิกการจัดกลุ่มออบเจ็กต์ เช่น groups

การแสดง JSON 
{
  "objectIds": [
    string
  ]
}
ช่อง
objectIds[]

string

รหัสออบเจ็กต์ของออบเจ็กต์ที่จะยกเลิกการจัดกลุ่ม

เฉพาะ groups ที่ไม่ได้อยู่ภายใน groups อื่นเท่านั้นที่จะยกเลิกการจัดกลุ่มได้ กลุ่มทั้งหมดควรอยู่ในหน้าเดียวกัน ระบบจะลบกลุ่มนั้นๆ ระบบจะคงขนาดและตำแหน่งของภาพเด็กทุกคนไว้

UpdatePageElementAltTextRequest

อัปเดตชื่อและ/หรือคำอธิบายข้อความแสดงแทนของ page element

การแสดง JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ขององค์ประกอบของหน้าเว็บที่ใช้การอัปเดต

title

string

ชื่อข้อความแสดงแทนที่อัปเดตแล้วขององค์ประกอบของหน้า หากไม่ได้ตั้งค่า ระบบจะคงค่าที่มีอยู่ไว้ โปรแกรมอ่านหน้าจอและอินเทอร์เฟซการช่วยเหลือพิเศษอื่นๆ จะแสดงชื่อ ใช้เฉพาะค่าที่มนุษย์อ่านได้ซึ่งเกี่ยวข้องกับเนื้อหาขององค์ประกอบของหน้า

description

string

คำอธิบายข้อความแสดงแทนที่อัปเดตแล้วขององค์ประกอบของหน้า หากไม่ได้ตั้งค่า ระบบจะคงค่าที่มีอยู่ไว้ คำอธิบายจะแสดงต่อโปรแกรมอ่านหน้าจอและอินเทอร์เฟซการช่วยเหลือพิเศษอื่นๆ ใช้เฉพาะค่าที่มนุษย์อ่านได้ซึ่งเกี่ยวข้องกับเนื้อหาขององค์ประกอบของหน้า

ReplaceImageRequest

แทนที่รูปภาพที่มีอยู่ด้วยรูปภาพใหม่

การแทนที่รูปภาพจะนำบางส่วน image effects ออกจากรูปภาพที่มีอยู่

การแสดง JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  "url": string
}
ช่อง
imageObjectId

string

รหัสของรูปภาพที่มีอยู่ซึ่งจะถูกแทนที่ คุณสามารถดึงข้อมูลรหัสได้จากการตอบกลับของคำขอ GET

imageReplaceMethod

enum (ImageReplaceMethod)

วิธีการแทนที่

ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
url

string

URL ของรูปภาพ

ระบบจะดึงข้อมูลรูปภาพ 1 ครั้งในเวลาที่แทรก และจัดเก็บสำเนาไว้เพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดไม่เกิน 50 MB, มีขนาดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

URL ที่ระบุต้องมีความยาวไม่เกิน 2 KB ระบบจะบันทึก URL พร้อมกับรูปภาพและแสดงผ่านฟิลด์ Image.source_url

สิ้นสุดฟิลด์ที่แยกกัน

UpdateSlidePropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของสไลด์

การแสดง JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของสไลด์ที่ใช้การอัปเดต

slideProperties

object (SlideProperties)

คุณสมบัติของสไลด์ที่จะอัปเดต

fields

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต

ต้องระบุอย่างน้อย 1 ฟิลด์ ระบบจะถือว่ามีรูท "slideProperties" อยู่แล้ว จึงไม่ควรระบุ ใช้ "*" รายการเดียวเป็นตัวย่อในการแสดงฟิลด์ทั้งหมดได้

เช่น หากต้องการอัปเดตว่าสไลด์ถูกข้ามหรือไม่ ให้ตั้งค่า fields เป็น "isSkipped"

หากต้องการรีเซ็ตพร็อพเพอร์ตี้เป็นค่าเริ่มต้น ให้ใส่ชื่อช่องใน FieldMask แต่ปล่อยให้ช่องนั้นว่างไว้

UpdatePageElementsZOrderRequest

อัปเดตลำดับ Z ขององค์ประกอบหน้าเว็บ ลำดับ Z คือการจัดลำดับองค์ประกอบในหน้าเว็บจากด้านหลังไปด้านหน้า องค์ประกอบของหน้าในหน้าเว็บอาจซ้อนทับองค์ประกอบที่อยู่ด้านหลัง

การแสดง JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
ช่อง
pageElementObjectIds[]

string

รหัสออบเจ็กต์ขององค์ประกอบหน้าเว็บที่จะอัปเดต

องค์ประกอบทั้งหมดของหน้าเว็บต้องอยู่ในหน้าเดียวกันและต้องไม่อยู่ในกลุ่ม

operation

enum (ZOrderOperation)

การดำเนินการ Z-order ที่จะใช้กับองค์ประกอบหน้าเว็บ

เมื่อใช้การดำเนินการกับองค์ประกอบหลายหน้า ระบบจะรักษาลำดับ Z ที่สัมพันธ์กันภายในองค์ประกอบหน้าเหล่านี้ก่อนการดำเนินการ

ZOrderOperation

การดำเนินการเพื่ออัปเดตลำดับ Z ขององค์ประกอบหน้าเว็บ

Enum
Z_ORDER_OPERATION_UNSPECIFIED การดำเนินการที่ไม่ได้ระบุ
BRING_TO_FRONT นำองค์ประกอบของหน้าเว็บมาไว้ด้านหน้าของหน้าเว็บ
BRING_FORWARD เลื่อนองค์ประกอบของหน้าไปข้างหน้า 1 องค์ประกอบเทียบกับองค์ประกอบที่อยู่หน้าสุดในองค์ประกอบของหน้าที่ระบุ
SEND_BACKWARD ส่งองค์ประกอบของหน้าเว็บไปข้างหลัง 1 องค์ประกอบเทียบกับองค์ประกอบที่อยู่ด้านหลังสุดในองค์ประกอบของหน้าที่ระบุ
SEND_TO_BACK ส่งองค์ประกอบของหน้าเว็บไปด้านหลังของหน้า

UpdateLineCategoryRequest

อัปเดตหมวดหมู่ของ line

การแสดง JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของบรรทัดที่ใช้การอัปเดต

อัปเดตได้เฉพาะบรรทัดที่มี category ซึ่งระบุว่าเป็น "ตัวเชื่อมต่อ"

ระบบอาจเปลี่ยนเส้นทางของสายหลังจากอัปเดตหมวดหมู่

lineCategory

enum (LineCategory)

หมวดหมู่บรรทัดที่จะอัปเดต

line type ที่แน่นอน จะกำหนดตามหมวดหมู่ที่จะอัปเดตและวิธีกำหนดเส้นทางเพื่อเชื่อมต่อกับองค์ประกอบอื่นๆ ของหน้า

RerouteLineRequest

เปลี่ยนเส้นทาง line เพื่อให้เชื่อมต่อที่จุดเชื่อมต่อ 2 จุดที่ใกล้ที่สุดในองค์ประกอบของหน้าที่เชื่อมต่อ

การแสดง JSON 
{
  "objectId": string
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของบรรทัดที่จะเปลี่ยนเส้นทาง

เฉพาะบรรทัดที่มี category ซึ่งระบุว่าเป็น "ตัวเชื่อมต่อ" เท่านั้นที่เปลี่ยนเส้นทางได้ การเชื่อมต่อเริ่มต้นและสิ้นสุดของเส้นต้องอยู่บนองค์ประกอบหน้าเว็บที่แตกต่างกัน

InsertCommentRequest

แทรก CommentThread ลงในงานนำเสนอ

การแสดง JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
}
ช่อง
content

string

ข้อความของความคิดเห็นในรูปแบบข้อความธรรมดา

ระบบจะจัดการเนื้อหาข้อความนี้ในลักษณะเดียวกับความคิดเห็นที่สร้างในโปรแกรมแก้ไขสไลด์ โดยจะมีลักษณะการทำงานที่คล้ายกันสำหรับการจัดรูปแบบ การแจ้งเตือน ฯลฯ

ต้องระบุข้อมูลในช่องนี้ และต้องไม่เกิน 2048 หน่วยรหัส UTF-8

assigneeEmailAddress

string

ไม่บังคับ อีเมลของผู้รับมอบหมายความคิดเห็น

เว้นว่างไว้สำหรับความคิดเห็นที่ไม่ได้กำหนด

ต้องยาวไม่เกิน 2048 หน่วยรหัส UTF-8

ตำแหน่งในงานนำเสนอที่ความคิดเห็นเชื่อมโยงอยู่ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
objectId

string

รหัสออบเจ็กต์ของ Page หรือ PageElement ที่เชื่อมโยงกับความคิดเห็นนี้ หาก objectId ที่ระบุเป็น Group ระบบจะยึดความคิดเห็นกับลูกหลานที่ไม่ใช่กลุ่มของกลุ่มได้สูงสุด 100 รายการ

shapeTextAnchor

object (ShapeTextAnchor)

ยึดความคิดเห็นกับข้อความช่วงใดช่วงหนึ่งภายใน Shape

tableCellTextAnchor

object (TableCellTextAnchor)

ยึดความคิดเห็นกับช่วงข้อความที่เฉพาะเจาะจงภายในเซลล์เดียวใน Table

tableAnchor

object (TableAnchor)

ยึดความคิดเห็นกับช่วงเซลล์ที่เฉพาะเจาะจงภายใน Table แสดงข้อผิดพลาด 400 Bad Request หากไม่มีเซลล์ใดในช่วงที่มีข้อความ

สิ้นสุดฟิลด์ที่แยกกัน

ShapeTextAnchor

Anchor Text ไปยังช่วงข้อความที่เฉพาะเจาะจงภายใน Shape's text หากต้องการแทรกความคิดเห็นในบันทึกของผู้บรรยาย ให้ใช้ ShapeTextAnchor กับ speaker notes รหัสออบเจ็กต์

การแสดง JSON 
{
  "objectId": string,
  "textRange": {
    object (Range)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ขององค์ประกอบของหน้าเว็บที่มีข้อความ

textRange

object (Range)

ช่วงข้อความสำหรับลิงก์ยึด

TableCellTextAnchor

Anchor ไปยังช่วงข้อความที่เฉพาะเจาะจงภายใน TableCell ของ TextElement

การแสดง JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตารางที่มีเซลล์

cellLocation

object (TableCellLocation)

ตำแหน่งของเซลล์ในตาราง

textRange

object (Range)

ช่วงข้อความสำหรับลิงก์ยึด

TableAnchor

Anchor ไปยังช่วงเซลล์ที่เฉพาะเจาะจงภายใน Table ใช้เพื่อยึดความคิดเห็นกับข้อความทั้งหมดในแต่ละเซลล์ในช่วงภายในตาราง

การแสดง JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
ช่อง
objectId

string

รหัสออบเจ็กต์ของตาราง

tableRange

object (TableRange)

ช่วงของเซลล์ในตารางที่จะใช้จุดยึด หากไม่ระบุ ระบบจะใช้เซลล์ทั้งหมดในตารางเป็นจุดยึด

AddCommentReplyRequest

แทรกคำตอบ Post ลงใน CommentThread

การแสดง JSON 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
ช่อง
commentId

string

รหัสของ CommentThread ที่จะเพิ่มการตอบกลับ

post

object (Post)

The Post แสดงถึงคำตอบ

UpdateCommentPostRequest

อัปเดต Post ใน CommentThread

แสดงข้อผิดพลาด 400 คำขอไม่ถูกต้องในกรณีต่อไปนี้

  • ผู้ใช้ที่ขอไม่ใช่ผู้เขียนโพสต์
การแสดง JSON 
{
  "commentId": string,
  "postId": string,
  "content": string
}
ช่อง
commentId

string

รหัสของ CommentThread ที่โพสต์เป็นของ

postId

string

รหัสของโพสต์ที่กำลังอัปเดต

content

string

ข้อความใหม่ของความคิดเห็นในรูปแบบข้อความธรรมดา

ระบบจะจัดการเนื้อหาข้อความนี้ในลักษณะเดียวกับความคิดเห็นที่สร้างในโปรแกรมแก้ไขสไลด์ โดยจะมีลักษณะการทำงานที่คล้ายกันสำหรับการจัดรูปแบบ การแจ้งเตือน ฯลฯ

ต้องระบุข้อมูลในช่องนี้ และต้องไม่เกิน 2048 หน่วยรหัส UTF-8

DeleteCommentRequest

ลบ CommentThread

แสดงข้อผิดพลาด 400 Bad Request หากผู้ใช้ที่ส่งคำขอไม่ใช่ผู้เขียน headPost

การแสดง JSON 
{
  "commentId": string
}
ช่อง
commentId

string

รหัสของ CommentThread ที่กำลังจะถูกลบ

DeleteCommentReplyRequest

ลบการตอบกลับ Post จาก CommentThread

แสดงข้อผิดพลาด 400 คำขอไม่ถูกต้องในกรณีต่อไปนี้

  • ผู้ใช้ที่ขอไม่ใช่ผู้เขียนโพสต์

  • โพสต์ตอบกลับมี comment action

  • โพสต์ตอบกลับมี assignee

การแสดง JSON 
{
  "commentId": string,
  "postId": string
}
ช่อง
commentId

string

รหัสของ CommentThread ที่โพสต์เป็นของ

postId

string

รหัสของการตอบกลับ Post ที่จะลบ