หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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