Operasi slide

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

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 untuk ID ini dari URL atau menggunakan permintaan baca API.

Contoh ini ditampilkan sebagai permintaan HTTP agar netral terhadap bahasa. Untuk mempelajari cara menerapkan kumpulan update 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 the COPY_TABLE_ELEMENT_ID) dalam salinan slide (ditentukan oleh the COPY_PAGE_ID). Semua elemen lain pada salinan diberi ID acak.

Untuk mengetahui informasi selengkapnya tentang cara menyalin PageElement, termasuk kotak teks, gambar, tabel, bentuk dasar, garis, dan video sematan, 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"
        }
      }
    }
  ]
}

Membuat slide

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

Slide baru ditetapkan untuk menggunakan PredefinedLayout dari TITLE_AND_TWO_COLUMNS. Anda dapat menentukan string untuk digunakan sebagai the PAGE_ID untuk slide (dengan some restrictions), atau mengizinkan API membuat PAGE_ID dengan menghapus field 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 slide dan mengubah placeholder

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

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

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 berikut presentations.batchUpdate 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 dilakukan. Nilai harus antara nol dan jumlah slide 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
      }
    }
  ]
}

Menetapkan gambar latar belakang slide

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

Mask kolom digunakan untuk menentukan bahwa hanya latar belakang slide yang boleh diubah untuk mempertahankan properti lainnya. Penggunaan mask kolom juga meningkatkan performa.

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

Berikut adalah protokol permintaan untuk menetapkan gambar latar belakang slide:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Membuat thumbnail

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

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

Berikut adalah protokol permintaan untuk membuat thumbnail halaman dengan ThumbnailProperties yang ditetapkan:

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