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

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 แบบนับจาก 0) ในงานนำเสนอ

สไลด์ใหม่ได้รับการตั้งค่าให้ใช้ 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

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