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

API ของ Google สไลด์ช่วยให้คุณสร้างไฟล์งานนำเสนอและจัดการไฟล์ที่มีอยู่ได้ ตัวอย่างในหน้านี้แสดงการดำเนินการนำเสนอหน้าเว็บทั่วไปโดยใช้เมธอด 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"
}

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

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