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 presentasi template yang 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 terkenal dengan banyak manfaat.
Resep dasar
Berikut contoh cara menggunakan Slides API untuk menggabungkan data ke dalam presentasi:
Buat presentasi sesuai keinginan menggunakan konten {i>placeholder<i} untuk membantu Anda mendesain.
Untuk setiap elemen konten yang akan Anda masukkan, ganti konten placeholder dengan tag. Tag adalah kotak teks atau bentuk dengan {i>string<i} yang unik. Pastikan untuk menggunakan string yang cenderung tidak muncul secara normal. Misalnya,
{{account-holder-name}}
mungkin merupakan tag yang baik.Dalam kode Anda, gunakan Google Drive API untuk membuat salinan presentasi.
Dalam kode Anda, gunakan metode
batchUpdate
Slide API, dengan serangkaian permintaanreplaceAllText
, untuk melakukan semua penggantian teks di seluruh presentasi. Gunakan permintaanreplaceAllShapesWithImage
untuk melakukan penggantian gambar di seluruh presentasi.
Setelah Anda membuat presentasi dengan tag di dalamnya, pastikan untuk membuat salinannya dan gunakan Slides API untuk memanipulasi salinan tersebut. Jangan gunakan Slides API untuk memanipulasi salinan "template" utama.
Bagian berikut menyertakan cuplikan kode yang mengilustrasikan beberapa proses ini. Anda juga dapat melihat video di atas untuk melihat contoh lengkap (Python) yang menggabungkan beberapa konsep dari masing-masing 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, hal ini lebih mudah daripada
menemukan dan mengganti setiap instance teks satu per satu. Salah satu alasan
pendekatan ini adalah karena ID elemen halaman sulit diprediksi,
terutama saat kolaborator meningkatkan dan mempertahankan presentasi
template.
Contoh
Contoh ini menggunakan Drive API untuk menyalin presentasi template, dan membuat instance presentasi baru. Kemudian, Google Sheets API akan digunakan untuk membaca data dari spreadsheet Spreadsheet, dan terakhir menggunakan Slides API untuk mengupdate presentasi baru.
Contoh ini mengambil data dari 3 sel dalam satu baris rentang bernama di
spreadsheet. Kemudian, data tersebut akan 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 diberikan dengan gambar yang diberikan. 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, dan membuat
instance presentasi baru. Kemudian, SDK ini menggunakan Slides API untuk menemukan
bentuk apa pun dengan teks {{company-logo}}
dan menggantinya dengan gambar logo perusahaan. Permintaan tersebut juga mengganti segala
bentuk dengan teks {{customer-graphic}}
dengan gambar berbeda.
Apps Script
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Mengganti instance kotak teks atau gambar tertentu
Permintaan replaceAllText
dan replaceAllShapesWithImage
berguna untuk mengganti tag di seluruh presentasi, tetapi
terkadang Anda hanya perlu mengganti elemen sesuai dengan kriteria lain, seperti
ditempatkan 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 sisipkan teks baru (lihat contoh Mengedit teks dalam bentuk yang ditentukan).
Penggantian gambar lebih kompleks. Untuk menggabungkan gambar, Anda perlu:
- Dapatkan ID bentuk tag.
- Salin informasi ukuran dan transformasi dari tag.
- Tambahkan gambar Anda ke halaman, menggunakan informasi ukuran dan transformasi.
- Hapus bentuk tag.
Mempertahankan rasio aspek gambar saat menskalakannya ke ukuran yang diinginkan mungkin memerlukan perhatian khusus, 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 ukuran dan data 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 sebagai berikut:
- width: disetel ke produk
width
danscaleX
tag - height: ditetapkan ke produk
height
danscaleY
tag - scale_x: ditetapkan ke
1
- scale_y: ditetapkan ke
1
Hal ini menyebabkan Slides API menyesuaikan aspek gambar menurut
ukuran visual tag, bukan ukuran yang tidak diskalakan (lihat
Mengganti tag bentuk dengan gambar).
Menyetel parameter penskalaan ke 1
akan mencegah gambar diskalakan dua kali.
Pengaturan ini memastikan rasio aspek gambar dipertahankan, dan mencegah gambar melebihi ukuran bentuk tag. Gambar ini memiliki titik tengah yang sama dengan bentuk tag.
Kelola template
Untuk presentasi template yang ditentukan dan dimiliki aplikasi, buat template menggunakan akun khusus yang mewakili aplikasi. Akun layanan adalah pilihan yang bagus dan dapat menghindari masalah pada kebijakan Google Workspace yang membatasi berbagi.
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.
- Update izin untuk mengizinkan penerima presentasi membacanya menggunakan permissions.create di Drive API.
- Perbarui izin untuk mengizinkan pembuat template menulis ke library 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.