Google Slides API memungkinkan Anda membuat, memindahkan, dan menghapus slide. Contoh di halaman ini menampilkan 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 ini dari URL atau dengan menggunakan permintaan baca API.
Contoh-contoh ini disajikan sebagai permintaan HTTP yang netral bahasa. Untuk mempelajari cara menerapkan update batch dalam bahasa yang berbeda 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 ditetapkan oleh PAGE_ID.
Permintaan ini memungkinkan Anda menentukan apakah beberapa atau semua ID elemen halaman harus ada dalam salinan (dengan beberapa pembatasan). 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 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"
}
}
}
]
}
Membuat 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
pembatasan),
atau mengizinkan API membuat PAGE_ID dengan mengabaikan 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
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 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
presentations.batchUpdate
berikut menunjukkan cara menggunakan metode
UpdateSlidesPositionRequest
untuk mengambil dua slide yang ditentukan dan memindahkannya ke awal
presentasi, sekaligus 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 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 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 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
metode
presentations.pages.getThumbnail, yang menampilkan gambar thumbnail halaman sebagai URL konten. URL gambar memiliki masa berlaku 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
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"
}