Halaman ini diterjemahkan oleh Cloud Translation API.

Operasi slide

Google Slides API memungkinkan Anda membuat, memindahkan, dan menghapus slide. Contoh di halaman ini menunjukkan beberapa operasi {i>slide<i} umum menggunakan presentations.batchUpdate .

Contoh ini menggunakan variabel berikut:

PRESENTATION_ID—Menunjukkan tempat Anda menyediakan presentasi ID. Anda dapat temukan nilai untuk ID ini dari URL presentasi.
PAGE_ID dan PAGE_ID2—Menunjukkan lokasi Anda berikan objek halaman ID. Anda dapat mengambil nilai untuk ini dari URL atau dengan menggunakan permintaan baca API.

Contoh ini disajikan sebagai permintaan HTTP agar tidak menggunakan bahasa yang netral. Untuk mempelajari cara mengimplementasikan update secara batch dalam berbagai bahasa menggunakan Google API library klien, lihat panduan berikut: Membuat slide dan Tambahkan bentuk dan teks.

Salin slide

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan DuplicateObjectRequest untuk menyalin {i>slide<i} dan menyisipkannya setelah yang asli dalam presentasi. Slide asli ditentukan oleh PAGE_ID.

Permintaan memungkinkan Anda menentukan apakah beberapa atau semua ID elemen halaman harus berada salinan (dengan beberapa pembatasan). Dalam contoh ini, {i>slide<i} 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 diberikan secara acak pelanggan.

Untuk informasi selengkapnya tentang menyalin PageElement, termasuk kotak teks, gambar, tabel, bentuk dasar, garis, dan video yang disematkan, lihat contoh Salin dan edit .

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

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

Slide baru ini disetel untuk menggunakan PredefinedLayout dari TITLE_AND_TWO_COLUMNS. Anda dapat menentukan string untuk digunakan sebagai PAGE_ID untuk slide (dengan beberapa pembatasan), atau mengizinkan API menghasilkan 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 slide dan mengubah placeholder

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan 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). Tujuan placeholderIdMappings menggunakan Type dari TITLE. TITLE_ID merujuk ke bentuk placeholder slide agar 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",
      }
    },
  ]
}

Pindahkan slide ke posisi baru

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan UpdateSlidesPositionRequest untuk mengambil dua {i>slide<i} tertentu dan memindahkannya ke awal presentasi, mempertahankan urutan relatifnya.

ID slide yang ditentukan (PAGE_ID dan PAGE_ID2) harus diberikan dalam urutan presentasi yang ada, tanpa duplikat. Tujuan insertionIndex berbasis nol menunjukkan tempat slide harus disisipkan, berdasarkan sesuai pesanan sebelum pemindahan dilakukan. Nilai harus antara nol dan jumlah {i>slide<i} dalam presentasi, secara 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

Hal berikut presentations.batchUpdate contoh kode menunjukkan cara menggunakan UpdatePagePropertiesRequest untuk menyetel gambar latar slide yang ditentukan oleh PAGE_ID. API mengambil image menggunakan IMAGE_URL.

Field mask digunakan untuk menentukan bahwa hanya latar belakang slide harus diubah untuk mempertahankan properti lainnya. Menggunakan kolom {i>mask <i}juga meningkatkan kinerja.

Atau, metode UpdatePagePropertiesRequest dapat digunakan untuk menyetel 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 dari halaman tertentu di presentasi dengan memanggil presentations.pages.getThumbnail , yang menampilkan gambar thumbnail halaman sebagai URL konten. Gambar URL memiliki masa aktif default 30 menit.

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

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