Method: presentations.create

สร้างงานนำเสนอเปล่าโดยใช้ชื่อที่ระบุไว้ในคำขอ หากมีการระบุ 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

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