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

Google สไลด์ API ช่วยให้คุณสร้าง ย้าย และลบสไลด์ได้ ตัวอย่าง หน้านี้จะแสดงการทำงานของสไลด์ทั่วไปโดยใช้ presentations.batchUpdate

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

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

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

คัดลอกสไลด์

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

คำขอช่วยให้คุณระบุได้ว่าควรใส่รหัสองค์ประกอบของหน้าบางส่วนหรือทั้งหมด สำเนา (ที่มีบางส่วน ข้อจำกัด [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:

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