Method: presentations.create

สร้างงานนำเสนอเปล่าโดยใช้ชื่อที่ระบุในคำขอ หากระบุ presentationId ระบบจะใช้ presentationId เป็นรหัสของงานนำเสนอใหม่ มิฉะนั้น ระบบจะสร้างรหัสใหม่ ระบบจะไม่สนใจช่องอื่นๆ ในคําขอ รวมถึงเนื้อหาที่ระบุ แสดงผลงานนำเสนอที่สร้างขึ้น

คำขอ HTTP

POST https://slides.googleapis.com/v1/presentations

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
ช่อง
presentationId

string

รหัสของงานนำเสนอ
pageSize

object (Size)

ขนาดของหน้าในงานนำเสนอ
slides[]

object (Page)

สไลด์ในงานนำเสนอ สไลด์จะรับค่าพร็อพเพอร์ตี้มาจากเลย์เอาต์สไลด์
title

string

ชื่อของงานนำเสนอ
masters[]

object (Page)

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

  • รูปร่างตัวยึดตําแหน่งในต้นฉบับมีสไตล์ข้อความเริ่มต้นและพร็อพเพอร์ตี้รูปร่างของรูปร่างตัวยึดตําแหน่งทั้งหมดในหน้าเว็บที่ใช้ต้นฉบับนั้น
  • พร็อพเพอร์ตี้ของหน้าหลักจะกำหนดพร็อพเพอร์ตี้หน้าทั่วไปที่รูปแบบของหน้ารับค่ามา
  • รูปร่างอื่นๆ ในสไลด์ต้นแบบจะปรากฏในสไลด์ทั้งหมดที่ใช้ต้นแบบนั้น ไม่ว่าจะมีเลย์เอาต์แบบใดก็ตาม
layouts[]

object (Page)

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

string

ภาษาของงานนำเสนอในรูปแบบแท็กภาษา IETF BCP 47
revisionId

string

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

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

object (Page)

ต้นฉบับของบันทึกในงานนำเสนอ โดยมีวัตถุประสงค์ 3 ข้อดังนี้

  • รูปร่างตัวยึดตําแหน่งในต้นฉบับโน้ตมีรูปแบบข้อความเริ่มต้นและพร็อพเพอร์ตี้รูปร่างของรูปร่างตัวยึดตําแหน่งทั้งหมดใน notes pages กล่าวโดยละเอียดคือ รูปร่างตัวยึดตําแหน่ง SLIDE_IMAGE มีภาพปกสไลด์ และรูปร่างตัวยึดตําแหน่ง BODY มีโน้ตผู้บรรยาย
  • พร็อพเพอร์ตี้หน้าหลักของโน้ตจะกำหนดพร็อพเพอร์ตี้หน้าทั่วไปที่ notes pages ทั้งหมดรับค่ามา
  • รูปร่างอื่นๆ ในต้นฉบับของโน้ตจะปรากฏใน notes pages ทั้งหมด

ต้นฉบับโน้ตเป็นแบบอ่านอย่างเดียว

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Presentation ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์