การดําเนินการงานนําเสนอ

Google สไลด์ API ช่วยให้คุณสร้างไฟล์งานนำเสนอและจัดการไฟล์ที่มีอยู่ได้ ตัวอย่างในหน้านี้แสดงการดำเนินการทั่วไปบางอย่างของการแสดงหน้าเว็บโดยใช้วิธี presentations.batchUpdate

ตัวอย่างเหล่านี้แสดงเป็นคำขอ HTTP เพื่อไม่ระบุภาษา หากต้องการดูวิธีใช้การอัปเดตแบบเป็นกลุ่มในภาษาต่างๆ โดยใช้ไลบรารีไคลเอ็นต์ Google API โปรดดูคำแนะนำต่อไปนี้

• สร้างและจัดการงานนำเสนอ
• ค้นหาไฟล์และโฟลเดอร์
• ผสานข้อมูลลงในงานนำเสนอ

สร้างงานนำเสนอ

ตัวอย่างโค้ดต่อไปนี้ presentations.create แสดงวิธีสร้างไฟล์งานนำเสนอเปล่าชื่อ "งานนำเสนอใหม่ของฉัน"

คุณยังสร้างไฟล์งานนำเสนอเปล่าได้โดยใช้เมธอด Google Drive API files.create โดยระบุ application/vnd.google-apps.presentation เป็นประเภท MIME

ต่อไปนี้คือโปรโตคอลคำขอเพื่อสร้างงานนำเสนอ

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

{
  "title": "My New Presentation"
}

แสดงรายการไฟล์งานนำเสนอที่มีอยู่

Slides API ไม่มีเมธอดสำหรับการดึงข้อมูลรายการงานนำเสนอ แต่ Drive API มี เมธอด files.list (แสดงอยู่ด้านล่าง) ใช้มาสก์ช่องเพื่อแสดงรายการไฟล์งานนำเสนอจากไดรฟ์พร้อมรหัสไฟล์ ชื่อไฟล์ และลิงก์สำหรับเปิดไฟล์ นอกจากนี้ คำขอยังระบุapplication/vnd.google-apps.presentationเป็นประเภท MIME ด้วย

ต่อไปนี้คือโปรโตคอลคำขอแสดงรายการไฟล์งานนำเสนอที่มีอยู่

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

การตอบกลับคําขอนี้มีโครงสร้างดังนี้

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

แทนที่ข้อความในทั้งงานนำเสนอ

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด ReplaceAllTextRequest เพื่อแทนที่ข้อความในทั้งงานนำเสนอที่ระบุโดย PRESENTATION_ID คุณดูค่าของรหัสงานนำเสนอได้จาก URL ของงานนำเสนอ

ระบบจะแทนที่สตริง "Gizmo Corp." ทุกอินสแตนซ์ด้วยข้อความ "Gadget Inc." ซึ่งรวมถึงข้อความในกล่องข้อความและรูปร่างอื่นๆ ในสไลด์ และภายในแม่แบบ ในตัวอย่างนี้ การเปลี่ยนข้อความจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่โดยการตั้งค่า matchCase เป็น true

ต่อไปนี้คือโปรโตคอลคำขอเพื่อแทนที่ข้อความตลอดทั้งงานนำเสนอ

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

{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}