Google Slides API memungkinkan Anda membuat, memindahkan, dan menghapus slide. Contoh di halaman ini menunjukkan beberapa operasi slide umum menggunakan metode presentations.batchUpdate.
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 parameter ini dari URL atau menggunakan permintaan baca API.
Contoh ini ditampilkan sebagai permintaan HTTP agar netral terhadap 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) dalam salinan slide (ditentukan oleh 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 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
TITLE_AND_TWO_COLUMNS. Anda dapat menentukan string untuk digunakan sebagai
PAGE_ID untuk slide (dengan beberapa
pembatasan),
atau mengizinkan API 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 slide dan mengubah placeholder
Contoh kode
presentations.batchUpdate
berikut menunjukkan cara menggunakan metode
CreateSlideRequest
untuk membuat slide menggunakan
PredefinedLayout
TITLE_AND_TWO_COLUMNS.
Anda dapat menentukan string untuk 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 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 slide
Contoh kode
presentations.batchUpdate
berikut menunjukkan cara menggunakan metode
UpdatePagePropertiesRequest
untuk menyetel gambar latar belakang slide yang ditentukan oleh
PAGE_ID. API mengambil gambar menggunakan
IMAGE_URL.
Masker kolom digunakan untuk menentukan bahwa hanya latar belakang slide yang harus diubah untuk mempertahankan properti lainnya. Penggunaan mask kolom juga meningkatkan performa.
Atau, metode UpdatePagePropertiesRequest dapat digunakan untuk menyetel
latar belakang slide ke warna solid.
Berikut adalah protokol permintaan untuk menyetel 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"
}
}
]
}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 membuat thumbnail halaman dengan set 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"
}