หน้าเว็บ องค์ประกอบของหน้า และคุณสมบัติ

ในการใช้ Slides API อย่างมีประสิทธิภาพ คุณจะต้องเข้าใจ สถาปัตยกรรมของงานนำเสนอและองค์ประกอบต่างๆ รวมถึงการโต้ตอบ ระหว่างองค์ประกอบเหล่านี้ หน้านี้จะให้ภาพรวมโดยละเอียดของรายการเหล่านี้ หัวข้อ:

• รูปแบบแนวคิดขององค์ประกอบต่างๆ ในงานนำเสนอ
• วิธีที่ API แสดงคอมโพเนนต์เหล่านี้
• คุณสมบัติการจัดรูปแบบของคอมโพเนนต์

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

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

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

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

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

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

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

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

หน้าจะมีอีก 2 ประเภท ได้แก่ หน้าโน้ตและมาสเตอร์โน้ต ซึ่ง มีความเกี่ยวข้องกับการทำงานกับบันทึกของผู้บรรยายเป็นส่วนใหญ่

ประเภทและโครงสร้างการแทน API

ส่วนนี้จะอธิบายวิธีโมเดลแนวคิดของ Google สไลด์ ดังที่อธิบายไว้ ข้างต้นแสดงอยู่ใน Slides API

แผนภาพต่อไปนี้แสดงความสัมพันธ์ระหว่างงานนำเสนอ หน้าต่างๆ และองค์ประกอบของหน้าเป็นประเภทใน Slides API

ส่วนต่อไปนี้จะแสดงให้เห็นว่าประเภทเหล่านี้แสดงในรูปแบบ JSON อย่างไร

งานนำเสนอ

งานนำเสนอจะมี จำนวนพร็อพเพอร์ตี้ และมีหน้าที่อยู่ในนั้น:

{
  "presentationId": string,
  "pageSize": { object(Size) },
  "slides": [ { object(Page) } ],
  "title": string,
  "masters": [ { object(Page) } ],
  "layouts": [ { object(Page) } ],
  "notesMaster": object(Page),
  "locale": string,
}

Pages

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

{
  "objectId": string,
  "pageType": enum(PageType),
  "pageElements": [ { object(PageElement) } ],
  "pageProperties": { object(PageProperties) },

  // Union field properties can be only one of the following:
  "slideProperties": { object(SlideProperties) },
  "layoutProperties": { object(LayoutProperties) },
  "notesProperties": { object(NotesProperties) },
  // End of list of possible types for union field properties.
}

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

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

{
  "objectId": string,
  "size": { object(Size) },
  "transform": { object(AffineTransform) },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": { object(Group) },
  "shape": { object(Shape) },
  "image": { object(Image) },
  "video": { object(Video) },
  "line": { object(Line) },
  "table": { object(Table) },
  "wordArt": { object(WordArt) },
  "sheetsChart": { object(SheetsChart) },
  // End of list of possible types for union field element_kind.
}

องค์ประกอบของหน้ามีอยู่หลายประเภท ตามที่กำหนดโดยฟิลด์ยูเนียน element_kind ในคำจำกัดความด้านบน องค์ประกอบของหน้าเว็บประเภทนี้ ดังที่อธิบายในตารางต่อไปนี้

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

พร็อพเพอร์ตี้ขององค์ประกอบของหน้าและองค์ประกอบหน้า

Slides API ช่วยให้คุณอ่านและอัปเดตลักษณะของหน้าและหน้า องค์ประกอบในงานนำเสนอของคุณ การสนับสนุนองค์ประกอบของหน้าที่แตกต่างกัน พร็อพเพอร์ตี้ต่างๆ ที่ควบคุมวิธีแสดงผลองค์ประกอบของหน้า

องค์ประกอบหน้าเว็บแต่ละประเภทมีองค์ประกอบของพร็อพเพอร์ตี้และพร็อพเพอร์ตี้ที่เกี่ยวข้อง อัปเดตข้อความ เช่น

• มีองค์ประกอบของหน้าเว็บประเภทรูปร่าง
• ช่องคุณสมบัติคือ shapeProperties
• คำขออัปเดตพร็อพเพอร์ตี้เหล่านี้คือ UpdateShapePropertiesRequest

มีชุดองค์ประกอบ/พร็อพเพอร์ตี้/คำขออัปเดตชุดเดียวกันสำหรับองค์ประกอบของหน้าแต่ละรายการ type: Image/imageProperties/UpdateImageProperties, เป็นต้น

คุณสามารถอ่านแอตทริบิวต์พร็อพเพอร์ตี้ได้จากทุกที่ที่พบเมื่ออ่านแอตทริบิวต์ element; เพื่อเปลี่ยนค่าในนั้น ให้ใช้ประเภทคำขอที่ตรงกันเป็น เพย์โหลดสำหรับ batchUpdate โดยจะเปลี่ยนค่าเหล่านี้ในงานนำเสนอได้

ประเภทที่พัก

มีสมบัติบางอย่างที่ใช้กันทั่วไประหว่างออบเจ็กต์หลายชนิดใน Slides API มีดังนี้

พร็อพเพอร์ตี้	คำอธิบาย
สี	สีใน Slides API สามารถเป็นค่า RGB หรือการอ้างอิงสีของธีม สีธีมจะมีการอ้างอิงตามชื่อ (เช่น "DARK1") และสามารถจับคู่กับค่า RGB โดยใช้รูปแบบสีของหน้าเว็บ รูปแบบสีนี้ได้รับการอัปเดตเป็นประจำเมื่อเปลี่ยนธีมของงานนำเสนอในเครื่องมือแก้ไขสไลด์
เติมพื้น	การเติมพื้นที่จะแสดงการแสดงผลของพื้นที่ว่างภายในออบเจ็กต์ การเติมสีที่ใช้บ่อยที่สุดในสไลด์คือการเติมสีทึบ ซึ่งภายในของวัตถุจะมีสีทึบเพียงสีเดียว นอกจากนี้ยังสามารถใช้การเติมเป็นพื้นหลังของหน้าเว็บได้ด้วย
โครงร่าง	โครงร่างจะแสดงชุดของเส้นที่อยู่รอบองค์ประกอบของหน้า สีของเส้นจะควบคุมด้วยการเติมสี ผู้โทรยังปรับความกว้างและรูปแบบเส้นประของเส้นขอบได้ด้วย
เงา	เงาจะแสดงเอฟเฟกต์ภาพซึ่งทำขึ้นเพื่อเลียนแบบเงาทางกายภาพที่ลอยโดยวัตถุ ปัจจุบันเงาใน API สไลด์เป็นแบบอ่านอย่างเดียว

กำลังอัปเดตที่พัก

หากต้องการอัปเดตพร็อพเพอร์ตี้ ให้ใช้พร็อพเพอร์ตี้ คำขอ Update...Properties รายการใน batchUpdate ตัวอย่างเช่น UpdateShapeProperties สำหรับรูปร่าง คำขอเหล่านี้ ยอมรับข้อความคุณสมบัติแบบเต็มและสามารถใช้ ฟิลด์มาสก์เพื่อกำหนดว่าฟิลด์ใดใน ควรอัปเดตข้อความพร็อพเพอร์ตี้

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

การสืบทอดพร็อพเพอร์ตี้

หน้าเว็บหรือองค์ประกอบของหน้าสามารถรับคุณสมบัติจากออบเจ็กต์ระดับบนสุดได้ CANNOT TRANSLATE คุณสมบัติของออบเจ็กต์ รวมถึงคุณสมบัติที่กำหนดและคุณสมบัติของออบเจ็กต์ รับช่วงมา กำหนดลักษณะการมองเห็นขั้นสุดท้าย

• พร็อพเพอร์ตี้ของหน้าเว็บ — หน้าเว็บจะรับค่าพร็อพเพอร์ตี้ที่มาจากพร็อพเพอร์ตี้ แต่มีการกำหนดไว้ในการจัดวางหรือโฆษณาหลักที่อ้างอิงตามต้นฉบับ
• คุณสมบัติของรูปร่าง — คุณสามารถทำเครื่องหมายรูปร่างเป็นตัวยึดตำแหน่ง เพื่อให้ คุณอ้างอิงรูปร่างตัวยึดตำแหน่งอื่นอย่างชัดแจ้ง (ในเค้าโครงระดับบนสุดของหน้าเว็บ หรือต้นฉบับ) ที่จะรับค่าพร็อพเพอร์ตี้

แนวคิดเหล่านี้จะอธิบายเพิ่มเติมในย่อหน้าต่อไปนี้

การสืบทอดพร็อพเพอร์ตี้ของหน้า

โครงสร้างของสไลด์ เลย์เอาต์ และโฆษณาหลักจะเป็นตัวกำหนดลำดับชั้นการรับค่า ภายในงานนำเสนอ: สไลด์รับค่าจากเลย์เอาต์ และเลย์เอาต์จะรับค่าจาก ต้นฉบับ มีการระบุการออกแบบระดับบนสุดและต้นฉบับของสไลด์ไว้ใน slideProperties ด้วย

หน้าเว็บจะรับค่าพร็อพเพอร์ตี้ เช่น background ได้ และรูปแบบสี จากหน้าหลัก หากต้องการรับพร็อพเพอร์ตี้ หน้าเว็บย่อยจะไม่ตั้งค่าพร็อพเพอร์ตี้ สำหรับพร็อพเพอร์ตี้นั้น PageProperties การไม่ "ลบล้าง" ค่าที่ผู้เผยแพร่โฆษณาหลักกำหนด หน้าเว็บจะยอมรับ ค่าที่รับช่วงมา

แผนภาพต่อไปนี้แสดงสไลด์ที่รับช่วงคุณสมบัติจากเลย์เอาต์ รับค่ามาจากต้นแบบ:

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

• คุณสมบัติ A คือ "สีแดง"
• คุณสมบัติ B คือ "Orange"

หน้าที่ไม่มีระดับบนสุดจะรับค่าค่าเริ่มต้นจาก Google สไลด์สำหรับพร็อพเพอร์ตี้ที่ไม่ได้ให้คำจำกัดความไว้

การสืบทอดคุณสมบัติรูปร่าง

รูปร่างสามารถสืบทอดคุณสมบัติ เช่น สีเติม ขอบ หรือเงา จากองค์ประกอบอื่นๆ รูปร่าง รูปร่างเป็นตัวยึดตำแหน่งหาก Shape.placeholder มีการตั้งค่า ช่อง Shape.placeholder.parentObjectId ของตัวยึดตำแหน่งย่อย ระบุตัวยึดตำแหน่งระดับบนสุด เมื่อคุณสร้างสไลด์ใหม่โดยอิงตาม ตัวยึดตำแหน่งในเลย์เอาต์นั้นจะปรากฏเป็นรูปร่างย่อยในสไลด์ใหม่ ในทำนองเดียวกัน ตัวยึดตำแหน่งบนหน้าหลักสามารถทำหน้าที่เป็นระดับบนสุดของเลย์เอาต์ ตัวยึดตําแหน่ง

คุณสามารถสร้างตัวยึดตำแหน่งโดยใช้เครื่องมือแก้ไขสไลด์ แต่ โดยใช้ Slides API

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

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

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

• ตัวยึดตำแหน่ง 1: พร็อพเพอร์ตี้ A จะแสดงผลเป็น "สีเหลือง" ส่วนพร็อพเพอร์ตี้ B เป็น "เขียว"
• ตัวยึดตำแหน่ง 2: พร็อพเพอร์ตี้ A แสดงผลเป็น "สีเหลือง" ส่วนพร็อพเพอร์ตี้ B เป็น "สีม่วง"
• ตัวยึดตำแหน่ง 3: พร็อพเพอร์ตี้ A แสดงผลเป็น "สีเหลือง" ส่วนพร็อพเพอร์ตี้ B เป็น "สีม่วง"

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

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

"ซ่อน" พร็อพเพอร์ตี้ที่ใช้ PropertyState

PropertyState การแจงนับจะควบคุมว่าจะใช้คุณสมบัติของรูปร่างเพื่อการแสดงผลจริงหรือไม่ หรือหากค่าใช้เพื่อการรับช่วงค่าโดยรูปร่างย่อยเท่านั้น ที่พักที่มี จะไม่มีการใช้สถานะของคุณสมบัติ NOT_RENDERED เมื่อแสดงผลรูปร่างบน อย่างไรก็ตาม รายการย่อยที่มีสถานะพร็อพเพอร์ตี้ที่เกี่ยวข้องเป็น RENDERED จะยังคงรับค่าคุณสมบัตินี้ได้

การอัปเดตพร็อพเพอร์ตี้กำหนดสถานะพร็อพเพอร์ตี้โดยปริยายเป็น "RENDERED" เว้นแต่คุณจะกำหนดสถานะเป็นค่าอื่นในคำขอเดียวกัน

แผนภาพต่อไปนี้แสดงการสืบทอดคุณสมบัติระหว่างคุณสมบัติ ตัวยึดตำแหน่งที่จัดการฟิลด์ PropertyState

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

• ตัวยึดตำแหน่ง 1: พร็อพเพอร์ตี้ A จะแสดงผลเป็น "แดง"
• ตัวยึดตำแหน่ง 2: พร็อพเพอร์ตี้ A ไม่แสดงผล หากนี่คือพร็อพเพอร์ตี้ Outline ตัวยึดตำแหน่ง2 จะไม่มีโครงร่าง
• ตัวยึดตำแหน่ง 3: พร็อพเพอร์ตี้ A ไม่แสดงผล

มีค่าที่เป็นไปได้อีก 1 ค่าคือ PropertyState enumeration: สถานะพร็อพเพอร์ตี้ INHERIT หมายความว่าสถานะพร็อพเพอร์ตี้ รับค่าเดิมและควรใช้ค่าของระดับบน รูปร่างที่ไม่มี ผู้ปกครองไม่สามารถมีสถานะพร็อพเพอร์ตี้เป็น INHERIT