Requests

ส่งคำขอ

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

การแสดง JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  }
  // End of mutually exclusive fields.
}
ช่อง
ประเภทของการอัปเดต ต้องระบุฟิลด์เดียวเท่านั้น ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of mutually exclusive fields.
}
ช่อง
ประเภทของ LayoutReference ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 รายการและเนื้อหา 1 รายการ จัดเรียงในคอลัมน์เดียว
MAIN_POINT เลย์เอาต์ที่มีประเด็นหลัก
BIG_NUMBER เลย์เอาต์ที่มีส่วนหัวเป็นตัวเลขขนาดใหญ่

LayoutPlaceholderIdMapping

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of mutually exclusive fields.
}
ช่อง
objectId

string

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

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

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

ประเภทเพื่อระบุตัวยึดตำแหน่งในเลย์เอาต์ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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 Basic Multilingual Plane (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
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.
}
ช่อง
replaceText

string

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

pageObjectIds[]

string

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

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

เกณฑ์ที่ใช้ในการจับคู่ข้อความที่จะแทนที่ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
ช่อง
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

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

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

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

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

ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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"

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

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"

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

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"

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

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"

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

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"

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

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"

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

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 : ลูกศรที่สอดคล้องกับจุดโค้ด Unicode U+2794
  • ARROW3D : ลูกศรที่มีการแรเงาแบบ 3 มิติ ซึ่งสอดคล้องกับจุดรหัส Unicode U+27a2
  • CHECKBOX : สี่เหลี่ยมจัตุรัสกลวง ซึ่งสอดคล้องกับจุดโค้ด Unicode U+274f
  • CIRCLE : วงกลมกลวง ซึ่งสอดคล้องกับจุดโค้ด 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 : สี่เหลี่ยมทึบที่สอดคล้องกับ Code Point ของ Unicode U+25a0
  • STAR : ดาว ซึ่งสอดคล้องกับโค้ดพอยต์ Unicode U+2605
  • ALPHA : ตัวอักษรพิมพ์เล็ก เช่น "a", "b" หรือ "c"
  • 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
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "imageUrl": string
  // End of mutually exclusive fields.
}
ช่อง
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 หรือหากไม่มีหน้าที่มีรหัสออบเจ็กต์ดังกล่าวในงานนำเสนอ

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

object (SubstringMatchCriteria)

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

สิ้นสุดฟิลด์ที่แยกกัน
ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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"

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

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"

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

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"

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

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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
ช่อง
imageObjectId

string

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

imageReplaceMethod

enum (ImageReplaceMethod)

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

ประเภทแหล่งที่มาของรูปภาพ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องใดช่องหนึ่งต่อไปนี้ในการตอบกลับ
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"

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

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 ส่งองค์ประกอบของหน้าไปข้างหลังในหน้าทีละองค์ประกอบโดยสัมพันธ์กับองค์ประกอบที่อยู่ด้านหลังสุดในองค์ประกอบของหน้าที่ระบุ
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
  // End of mutually exclusive fields.
}
ช่อง
content

string

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

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

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

assigneeEmailAddress

string

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

เว้นว่างไว้หากไม่ต้องการกำหนดความคิดเห็น

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

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

string

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

shapeTextAnchor

object (ShapeTextAnchor)

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

tableCellTextAnchor

object (TableCellTextAnchor)

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

tableAnchor

object (TableAnchor)

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

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

ShapeTextAnchor

Anchor ไปยังช่วงข้อความที่เฉพาะเจาะจงภายใน 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)

โดย Post แสดงถึงการตอบกลับ

UpdateCommentPostRequest

อัปเดต Post ใน CommentThread

แสดงข้อผิดพลาด 400 Bad Request ในกรณีต่อไปนี้

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

  • มี UpdateCommentPostRequests หลายรายการใน BatchUpdatePresentationRequest เดียวกัน สำหรับ postId เดียวกัน

การแสดง 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 Bad Request ในกรณีต่อไปนี้

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

string

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

postId

string

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