Operasi slide

Google Slides API memungkinkan Anda membuat, memindahkan, dan menghapus slide. Contoh di halaman ini menunjukkan beberapa operasi slide umum menggunakan metode presentations.batchUpdate.

Contoh-contoh ini menggunakan variabel berikut:

  • PRESENTATION_ID—Menunjukkan tempat Anda memberikan ID presentasi. Anda dapat menemukan nilai untuk ID ini dari URL presentasi.
  • PAGE_ID dan PAGE_ID2—Menunjukkan tempat Anda memberikan ID objek halaman. Anda dapat mengambil nilai ini dari URL atau dengan menggunakan permintaan baca API.

Contoh ini ditampilkan sebagai permintaan HTTP agar tidak menggunakan bahasa. Untuk mempelajari cara menerapkan update batch dalam berbagai bahasa menggunakan library klien Google API, lihat panduan berikut: Membuat slide dan Menambahkan bentuk dan teks.

Menyalin slide

Contoh kode presentations.batchUpdate berikut menunjukkan cara menggunakan metode DuplicateObjectRequest untuk menyalin slide dan menyisipkannya setelah slide asli dalam presentasi. Slide asli ditentukan oleh PAGE_ID.

Permintaan ini memungkinkan Anda menentukan apakah beberapa atau semua ID elemen halaman harus ada dalam salinan (dengan beberapa batasan). Dalam contoh ini, slide asli berisi elemen tabel (ditentukan oleh TABLE_ELEMENT_ID), yang dipetakan ke tabel baru (ditentukan oleh COPY_TABLE_ELEMENT_ID) di salinan slide (ditentukan oleh COPY_PAGE_ID). Semua elemen lain pada salinan akan diberi ID acak.

Untuk mengetahui informasi selengkapnya tentang cara menyalin PageElement, termasuk kotak teks, gambar, tabel, bentuk dasar, garis, dan video tersemat, lihat contoh Menyalin dan mengedit elemen.

Berikut adalah protokol permintaan untuk menyalin slide:

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

Buat slide

Contoh kode presentations.batchUpdate berikut menunjukkan cara menggunakan metode CreateSlideRequest untuk membuat slide dan menyisipkannya sebagai slide keempat (menggunakan insertionIndex berbasis nol) dalam presentasi.

Slide baru disetel untuk menggunakan PredefinedLayout dari TITLE_AND_TWO_COLUMNS. Anda dapat menentukan string yang akan digunakan sebagai PAGE_ID untuk slide (dengan beberapa batasan), atau mengizinkan API untuk membuat PAGE_ID dengan menghilangkan kolom dalam permintaan.

Berikut adalah protokol permintaan untuk membuat slide:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

Membuat {i>slide<i} dan memodifikasi placeholder

Contoh kode presentations.batchUpdate berikut menunjukkan cara menggunakan metode CreateSlideRequest untuk membuat slide menggunakan PredefinedLayout dari TITLE_AND_TWO_COLUMNS.

Anda dapat menentukan string yang akan digunakan sebagai PAGE_ID untuk slide (dengan beberapa batasan). placeholderIdMappings menggunakan Type dari TITLE. TITLE_ID mereferensikan bentuk placeholder slide sehingga dapat dimodifikasi.

Berikut adalah protokol permintaan untuk membuat slide dan mengubah placeholder:

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

Memindahkan slide ke posisi baru

Contoh kode presentations.batchUpdate berikut menunjukkan cara menggunakan metode UpdateSlidesPositionRequest untuk mengambil dua slide yang ditentukan dan memindahkannya ke awal presentasi, dengan mempertahankan urutan relatifnya.

ID slide yang ditentukan (PAGE_ID dan PAGE_ID2) harus diberikan dalam urutan presentasi yang ada, tanpa duplikat. insertionIndex berbasis nol menunjukkan tempat slide harus disisipkan, berdasarkan urutan sebelum pemindahan terjadi. Nilainya harus antara nol dan jumlah {i>slide<i} dalam presentasi, inklusif.

Berikut adalah protokol permintaan untuk memindahkan slide ke posisi baru:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

Setel gambar latar slide

Contoh kode presentations.batchUpdate berikut menunjukkan cara menggunakan metode UpdatePagePropertiesRequest untuk menetapkan gambar latar slide yang ditentukan oleh PAGE_ID. API mengambil gambar menggunakan IMAGE_URL.

Mask kolom digunakan untuk menentukan bahwa hanya latar belakang slide yang harus diubah guna mempertahankan properti lainnya. Menggunakan mask kolom juga akan meningkatkan performa.

Atau, metode UpdatePagePropertiesRequest dapat digunakan untuk menetapkan latar belakang slide ke warna solid.

Berikut adalah protokol permintaan untuk menyetel gambar latar slide:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Buat thumbnail

Anda dapat membuat thumbnail versi terbaru halaman tertentu dalam presentasi dengan memanggil metode presentations.pages.getThumbnail, yang menampilkan gambar thumbnail halaman sebagai URL konten. URL gambar memiliki masa aktif default 30 menit.

Anda juga dapat menentukan mimeType dan thumbnailSize yang ditampilkan menggunakan kolom ThumbnailProperties sebagai parameter kueri.

Berikut adalah protokol permintaan untuk menghasilkan thumbnail halaman dengan kumpulan 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"
}