Salah satu penerapan Google Slides API yang berguna adalah menggabungkan informasi dari satu atau beberapa sumber data ke dalam template slide presentasi.
Halaman ini menjelaskan cara mengambil data dari sumber eksternal dan menyisipkannya ke dalam presentasi template yang sudah ada. Konsep ini mirip dengan pembuatan email massal menggunakan pengolah kata dan spreadsheet.
Ada beberapa alasan mengapa pendekatan ini berguna:
Sangat mudah bagi desainer untuk menyesuaikan desain presentasi menggunakan editor Google Slide. Ini jauh lebih mudah daripada menyesuaikan parameter di aplikasi Anda untuk menyetel desain slide yang dirender.
Memisahkan konten dari presentasi adalah prinsip desain yang sudah dikenal dengan banyak manfaat.
Resep dasar
Berikut adalah contoh bagaimana Anda dapat menggunakan Slides API untuk menggabungkan data ke dalam presentasi:
Buat presentasi sesuai keinginan Anda untuk ditampilkan menggunakan konten {i>placeholder<i} untuk membantu desain Anda.
Untuk setiap elemen konten yang akan Anda sisipkan, ganti konten placeholder dengan tag. Tag adalah kotak teks atau bentuk dengan string unik. Pastikan untuk menggunakan string yang jarang terjadi secara normal. Misalnya,
{{account-holder-name}}
mungkin tag yang baik.Di kode Anda, gunakan Google Drive API untuk membuat salinan presentasi.
Dalam kode Anda, gunakan metode
batchUpdate
Slides API, dengan serangkaian permintaanreplaceAllText
, untuk melakukan semua penggantian teks selama presentasi. Gunakan permintaanreplaceAllShapesWithImage
untuk melakukan penggantian gambar selama presentasi.
Setelah Anda membuat presentasi dengan tag di dalamnya, pastikan untuk membuat salinan dan menggunakan Slides API untuk memanipulasi salinan. Jangan gunakan Slides API untuk memanipulasi salinan "template" utama Anda!
Bagian berikut menyertakan cuplikan kode yang menggambarkan beberapa proses ini. Anda juga dapat menonton video di atas untuk melihat contoh lengkap (Python) yang menggabungkan beberapa konsep dari setiap bagian di bawah ini.
Gabungkan teks
Anda dapat menggunakan permintaan replaceAllText
untuk mengganti semua instance string teks tertentu dalam
presentasi dengan teks baru. Untuk penggabungan, ini lebih mudah daripada
menemukan dan mengganti setiap instance teks satu per satu. Salah satu alasan mengapa hal ini adalah pendekatan yang paling canggih adalah ID elemen halaman sulit diprediksi, terutama saat kolaborator meningkatkan kualitas dan mengelola presentasi template.
Contoh
Contoh ini menggunakan Drive API untuk menyalin presentasi template, sehingga membuat instance presentasi baru. Kemudian, API tersebut menggunakan Google Sheets API untuk membaca data dari spreadsheet Spreadsheet, dan akhirnya menggunakan Slides API untuk memperbarui presentasi baru.
Contoh ini mengambil data dari 3 sel dalam satu baris rentang bernama di
spreadsheet. Kemudian, data tersebut diganti ke dalam presentasi di mana pun
string {{customer-name}}
,
{{case-description}}
, atau
{{total-portfolio}}
muncul.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Gabungkan gambar
Anda juga dapat menggabungkan gambar ke dalam presentasi menggunakan permintaan replaceAllShapesWithImage
. Permintaan ini mengganti semua instance bentuk yang berisi string teks yang disediakan dengan gambar yang disediakan. Permintaan tersebut secara otomatis
memosisikan dan menskalakan gambar agar sesuai dengan batas bentuk tag sekaligus
mempertahankan rasio aspek gambar.
Contoh
Contoh ini menggunakan Google Drive API untuk menyalin presentasi template, sehingga membuat instance presentasi baru. Kemudian, API tersebut menggunakan Slides API untuk menemukan
bentuk apa pun yang berisi teks {{company-logo}}
dan menggantinya dengan gambar logo perusahaan. Permintaan tersebut juga mengganti bentuk
apa pun dengan teks {{customer-graphic}}
dengan gambar yang berbeda.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Mengganti instance gambar atau kotak teks tertentu
Permintaan replaceAllText
dan replaceAllShapesWithImage
berguna untuk mengganti tag di seluruh presentasi, tetapi
terkadang Anda hanya perlu mengganti elemen sesuai dengan kriteria lain, seperti
berada di slide tertentu.
Dalam hal ini, Anda harus mengambil ID bentuk tag yang ingin diganti. Untuk penggantian teks, hapus teks yang ada dalam bentuk tersebut, lalu masukkan teks baru (lihat contoh Mengedit teks dalam bentuk yang ditentukan).
Penggantian gambar lebih kompleks. Untuk menggabungkan gambar, Anda harus:
- Dapatkan ID bentuk tag.
- Salin informasi ukuran dan transformasi dari tag.
- Tambahkan gambar ke halaman, menggunakan informasi ukuran dan transformasi.
- Hapus bentuk tag.
Mempertahankan rasio aspek gambar saat menskalakannya ke ukuran yang diinginkan mungkin memerlukan kehati-hatian, seperti yang dijelaskan di bagian berikut. Lihat juga contoh ini: Mengganti tag bentuk dengan gambar.
Pertahankan rasio aspek
Saat Anda membuat gambar menggunakan Slides API, kesesuaian aspek hanya didasarkan pada
ukuran gambar, bukan pada data ukuran dan transformasi. Data ukuran yang Anda berikan
dalam permintaan createImage
dianggap sebagai ukuran gambar yang diinginkan. API akan menyesuaikan
rasio aspek gambar ke ukuran yang diinginkan ini, lalu menerapkan transformasi yang disediakan.
Saat mengganti tag dengan gambar, Anda mempertahankan rasio aspek gambar dengan menetapkan ukuran dan penskalaan gambar seperti berikut:
- width: ditetapkan ke hasil kali
width
danscaleX
tag - height: disetel ke hasil kali
height
danscaleY
tag - scale_x: ditetapkan ke
1
- scale_y: ditetapkan ke
1
Hal ini menyebabkan Slides API menyesuaikan aspek gambar sesuai dengan
ukuran visual tag, bukan ukuran yang tidak diskalakan (lihat
Mengganti tag bentuk dengan gambar).
Menetapkan parameter penskalaan ke 1
akan mencegah gambar diskalakan dua kali
dua kali.
Pengaturan ini memastikan rasio aspek gambar dipertahankan, dan mencegah gambar melebihi ukuran bentuk tag. Gambar memiliki titik tengah yang sama dengan bentuk tag.
Kelola template
Untuk presentasi template yang ditetapkan dan dimiliki aplikasi, buat template menggunakan akun khusus yang mewakili aplikasi tersebut. Akun layanan adalah pilihan yang baik dan menghindari kerumitan dengan kebijakan Google Workspace yang membatasi pembagian.
Saat Anda membuat instance presentasi dari template, selalu gunakan kredensial pengguna akhir. Tindakan ini memberi pengguna kontrol penuh atas presentasi yang dihasilkan dan mencegah masalah penskalaan yang terkait dengan batas per pengguna di Google Drive.
Untuk membuat template menggunakan akun layanan, lakukan langkah-langkah berikut dengan kredensial aplikasi:
- Buat presentasi menggunakan presentations.create di Slides API.
- Perbarui izin untuk mengizinkan penerima presentasi membacanya menggunakan permissions.create di Drive API.
- Perbarui izin untuk mengizinkan penulis template menulis ke skrip tersebut menggunakan permissions.create di Drive API.
- Edit template sesuai kebutuhan.
Untuk membuat instance presentasi, lakukan langkah-langkah berikut dengan kredensial pengguna:
- Buat salinan template menggunakan files.copy di Drive API.
- Ganti nilai menggunakan presentation.batchUpdate di Slides API.