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

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."
      }
    }
  ]
}