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

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) ซึ่งแมปกับตารางใหม่ (ระบุโดย the COPY_TABLE_ELEMENT_ID) ในสำเนาสไลด์ (ระบุโดย the 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 ถึงจำนวนสไลด์ในงานนำเสนอ ซึ่งรวมถึง 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"
}