การทํางานของสไลด์

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

ตัวอย่างเหล่านี้ใช้ตัวแปรต่อไปนี้

• PRESENTATION_ID—ระบุตำแหน่งที่คุณระบุ รหัสงานนำเสนอ คุณดูค่าสำหรับรหัสนี้ได้จาก URL ของงานนำเสนอ
• PAGE_ID และ PAGE_ID2 - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์หน้าเว็บ คุณสามารถดึงค่าสำหรับพารามิเตอร์นี้จาก URL หรือโดยใช้คำขออ่าน API

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

คัดลอกสไลด์

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด DuplicateObjectRequest เพื่อคัดลอกสไลด์และแทรกไว้หลังสไลด์ต้นฉบับในงานนำเสนอ PAGE_ID จะระบุสไลด์ต้นฉบับ

คำขอช่วยให้คุณระบุได้ว่าควรมีรหัสองค์ประกอบของหน้าเว็บบางส่วนหรือทั้งหมดใน สำเนา (โดยมีข้อจำกัด บางอย่าง) ในตัวอย่างนี้ สไลด์ต้นฉบับมีองค์ประกอบตาราง (ระบุโดย TABLE_ELEMENT_ID) ซึ่งแมปกับตารางใหม่ (ระบุโดย COPY_TABLE_ELEMENT_ID) ในสำเนาสไลด์ (ระบุโดย COPY_PAGE_ID) องค์ประกอบอื่นๆ ทั้งหมดในสำเนาจะได้รับรหัสแบบสุ่ม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการคัดลอก PageElement รวมถึงกล่องข้อความ รูปภาพ ตาราง รูปร่างพื้นฐาน เส้น และวิดีโอที่ฝัง ได้ที่ตัวอย่างคัดลอกและแก้ไของค์ประกอบ

โปรโตคอลคำขอในการคัดลอกสไลด์มีดังนี้

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

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

สร้างสไลด์

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด CreateSlideRequest เพื่อสร้างสไลด์และแทรกลงในงานนำเสนอเป็นสไลด์ที่ 4 (ใช้insertionIndex แบบอิงตามศูนย์)

สไลด์ใหม่ได้รับการตั้งค่าให้ใช้ PredefinedLayout ของ TITLE_AND_TWO_COLUMNS คุณสามารถระบุสตริงที่จะใช้เป็น PAGE_ID สำหรับสไลด์ (โดยมีข้อจำกัดบางอย่าง) หรืออนุญาตให้ API สร้าง PAGE_ID โดยละเว้นฟิลด์ในคำขอได้

ต่อไปนี้คือโปรโตคอลคำขอในการสร้างสไลด์

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

สร้างสไลด์และแก้ไขตัวยึดตำแหน่ง

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด CreateSlideRequest เพื่อสร้างสไลด์โดยใช้ PredefinedLayout ของ TITLE_AND_TWO_COLUMNS

คุณระบุสตริงที่จะใช้เป็น PAGE_ID สำหรับสไลด์ได้ (โดยมีข้อจำกัดบางอย่าง) placeholderIdMappings ใช้ Type ของ TITLE TITLE_ID อ้างอิงรูปร่างตัวยึดตำแหน่งของสไลด์ เพื่อให้แก้ไขได้

ต่อไปนี้คือโปรโตคอลคำขอในการสร้างสไลด์และแก้ไขตัวยึดตำแหน่ง

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

ย้ายสไลด์ไปยังตำแหน่งใหม่

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด UpdateSlidesPositionRequest เพื่อนำสไลด์ 2 รายการที่ระบุและย้ายไปไว้ที่จุดเริ่มต้นของ งานนำเสนอ โดยยังคงลำดับที่สัมพันธ์กันไว้

ต้องระบุรหัสสไลด์ที่ระบุ (PAGE_ID และ PAGE_ID2) ตามลำดับการนำเสนอที่มีอยู่โดยไม่มีรายการที่ซ้ำกัน insertionIndex ที่มีค่าเป็น 0 จะระบุตำแหน่งที่ควรแทรกสไลด์ โดยอิงตามลำดับก่อนที่จะย้าย ค่าต้องอยู่ระหว่าง 0 ถึง จำนวนสไลด์ในงานนำเสนอ

ต่อไปนี้คือโปรโตคอลคำขอในการย้ายสไลด์ไปยังตำแหน่งใหม่

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

{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

ตั้งค่ารูปภาพพื้นหลังของสไลด์

โค้ดตัวอย่างต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด UpdatePagePropertiesRequest เพื่อตั้งค่ารูปภาพพื้นหลังของสไลด์ที่ระบุโดย PAGE_ID API จะดึงข้อมูลรูปภาพโดยใช้ IMAGE_URL

ระบบจะใช้ฟิลด์มาสก์เพื่อระบุว่าควรเปลี่ยนเฉพาะ พื้นหลังของสไลด์เพื่อรักษาพร็อพเพอร์ตี้อื่นๆ การใช้ฟิลด์ มาสก์ยังช่วยปรับปรุงประสิทธิภาพด้วย

หรือจะใช้UpdatePagePropertiesRequestเพื่อตั้งค่า พื้นหลังของสไลด์เป็นสีทึบก็ได้

ต่อไปนี้คือโปรโตคอลคำขอในการตั้งค่ารูปภาพพื้นหลังของสไลด์

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

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

สร้างภาพปก

คุณสร้างภาพขนาดย่อของหน้าเว็บเวอร์ชันล่าสุดใน งานนำเสนอได้โดยเรียกใช้เมธอด presentations.pages.getThumbnail ซึ่งจะแสดงผลรูปภาพขนาดย่อของหน้าเว็บเป็น URL เนื้อหา รูปภาพ URL มีอายุการใช้งานเริ่มต้น 30 นาที

นอกจากนี้ คุณยังระบุ mimeType และ thumbnailSize ที่แสดงผลได้โดยใช้ฟิลด์ ThumbnailProperties เป็นพารามิเตอร์การค้นหา

ต่อไปนี้คือโปรโตคอลคำขอในการสร้างภาพขนาดย่อของหน้าเว็บด้วยThumbnailProperties set

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM

{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}