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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
ช่อง
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 ทั้งหมด

สไลด์ต้นแบบของหมายเหตุเป็นแบบอ่านอย่างเดียว
comments[]

object (CommentThread)

เอาต์พุตเท่านั้น เธรดความคิดเห็นที่เชื่อมโยงกับงานนำเสนอ

commentsViewMode

enum (CommentsViewMode)

เอาต์พุตเท่านั้น โหมดมุมมองความคิดเห็นที่ใช้กับงานนำเสนอ

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

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

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

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