Google Slides API memungkinkan Anda membuat dan memodifikasi presentasi Google Slide.
Aplikasi dapat diintegrasikan dengan Google Slides API untuk membuat slide presentasi yang menarik secara otomatis dari data yang disediakan oleh pengguna dan sistem. Misalnya, Anda dapat menggunakan detail pelanggan dari database dan menggabungkannya dengan template yang telah didesain sebelumnya dan opsi konfigurasi pilihan untuk membuat presentasi akhir dalam waktu yang relatif cepat dibandingkan dengan membuatnya secara manual.
Ringkasan API
Koleksi presentasi menyediakan metode yang memungkinkan Anda mendapatkan dan memperbarui elemen dalam presentasi.
Sebagian besar pekerjaan Anda dengan Slides API mungkin membuat dan mengupdate presentasi. Anda akan melakukannya dengan menggunakan metode batchUpdate; metode ini mengambil daftar objek Request yang memungkinkan Anda melakukan hal-hal seperti:
- Buat Slide
- Menambahkan elemen ke slide seperti bentuk atau tabel
- Menyisipkan, mengubah, dan menghapus teks
- Menerapkan transformasi ke elemen
- Mengubah urutan slide
Lihat Update secara batch untuk mengetahui detail selengkapnya. Lihat panduan Memulai untuk melihat contoh menyeluruh yang sederhana mengenai cara menggunakan API.
Struktur presentasi
Presentasi di Slides API terdiri dari halaman, yang berisi elemen halaman.
ID presentasi dapat diambil dari URL:
https://docs.google.com/presentation/d/presentationId/edit
ID presentasi adalah string yang berisi huruf, angka, dan beberapa karakter khusus. Ekspresi reguler berikut dapat digunakan untuk mengekstrak ID presentasi dari URL Google Spreadsheet:
/presentation/d/([a-zA-Z0-9-_]+)
Jika Anda sudah familier dengan Drive API, presentationId sesuai dengan
ID resource File.
Halaman dan elemen halaman diidentifikasi melalui ID objek.
Jumlah halaman
Google Slide memiliki beberapa jenis halaman berikut:
| Magister | Master slide menentukan gaya teks, latar belakang, dan elemen halaman default yang muncul di semua slide yang menggunakan master ini. Elemen halaman yang harus muncul di semua slide harus ditambahkan ke master. Sebagian besar presentasi memiliki satu master, tetapi beberapa di antaranya memiliki lebih dari satu atau tidak satu pun. |
| Tata letak | Tata letak berfungsi sebagai template untuk menyusun elemen halaman secara default pada slide dengan menggunakan tata letak. Setiap tata letak dikaitkan dengan satu master. |
| Slide | Halaman ini berisi konten yang Anda presentasikan kepada audiens. Sebagian besar slide didasarkan pada master dan tata letak. Anda dapat menentukan tata letak yang akan digunakan untuk setiap slide saat dibuat. |
| Catatan | Halaman ini berisi konten untuk handout presentasi, termasuk bentuk yang berisi catatan pembicara slide. Setiap slide memiliki satu halaman catatan yang sesuai. Hanya teks dalam bentuk catatan pembicara yang dapat diubah dengan Slides API. |
| Master catatan | Master catatan menentukan gaya teks default dan elemen halaman untuk semua halaman catatan. Master catatan bersifat hanya-baca di Slides API. |
Elemen halaman
Elemen halaman adalah komponen visual yang ditempatkan di halaman. API ini mengekspos beberapa jenis elemen halaman:
| Grup | Serangkaian elemen halaman yang diperlakukan sebagai unit individu. Grup ini dapat dipindahkan, diskalakan, dan diputar bersama. |
| Bentuk | Objek visual biasa, seperti persegi panjang, elips, dan kotak teks. Bentuk bisa berisi teks, sehingga merupakan elemen halaman paling umum untuk membuat slide. |
| Gambar | Grafik yang diimpor ke dalam Slide. |
| Video | Video yang diimpor ke dalam Slide. |
| Garis | Garis, kurva, atau konektor visual. |
| Tabel | Petak yang berisi konten. |
| WordArt | Elemen teks visual yang berperilaku mirip bentuk. |
| SheetsChart | Diagram yang diimpor ke dalam Slide dari Google Spreadsheet. |
Update secara batch
Metode batchUpdate memungkinkan Anda memperbarui banyak aspek presentasi. Perubahan dikelompokkan bersama dalam batch sehingga jika satu permintaan gagal, tidak satu pun perubahan lainnya (yang mungkin bergantung) yang akan ditulis.
Metode batchUpdate berfungsi dengan mengambil satu atau beberapa objek
Request, masing-masing menentukan satu jenis permintaan yang akan dilakukan. Ada
berbagai jenis permintaan. Berikut adalah perincian jenis permintaan,
yang dikelompokkan ke dalam beberapa kategori.
Metode batchUpdate menampilkan isi respons,
yang berisi
Response
untuk setiap permintaan. Setiap respons menempati indeks yang sama dengan permintaan
yang sesuai; untuk permintaan tanpa respons yang berlaku, respons pada indeks
tersebut akan kosong. Beragam permintaan Create biasanya memiliki respons, sehingga
Anda mengetahui ID objek yang baru ditambahkan.
Menangani ID objek
Presentasi di Slides API terdiri dari halaman dan elemen halaman. Objek ini menyertakan string ID objek yang unik dalam presentasi.
Menentukan ID objek saat pembuatan
Saat membuat halaman atau elemen halaman menggunakan metode batchUpdate, Anda dapat menentukan ID objek untuk objek baru secara opsional. Tindakan ini memungkinkan Anda membuat objek dan memodifikasinya dalam permintaan batchUpdate yang sama, sehingga meminimalkan jumlah panggilan ke Slides API dan mengurangi penggunaan kuota.
Sebaiknya buat ID objek acak dalam sebagian besar kasus. Misalnya, jika Anda
menggunakan Java, java.util.UUID.randomUUID().toString() akan berfungsi dengan baik.
Jika aplikasi Anda ingin melacak objek dalam jangka waktu yang lebih lama, jangan bergantung pada ID objek karena dapat berubah. Lihat bagian berikut untuk mengetahui detail selengkapnya.
Melacak objek tanpa menggunakan ID objek
Saat Anda membuat permintaan Slides API, ID objek biasanya dipertahankan. (Pengecualian apa pun akan dijelaskan di dokumentasi referensi metode.) Membuat salinan seluruh presentasi dengan Drive API juga akan mempertahankan ID objek.
Namun, Anda tidak dapat mengandalkan ID objek yang tidak berubah setelah presentasi diubah di UI Slide. Misalnya, jika seseorang menggunakan UI Slides untuk menyalin dan menempelkan elemen halaman, lalu menghapus aslinya, elemen halaman kini akan memiliki ID unik baru, dan ID yang sebelumnya Anda berikan melalui API akan hilang. Oleh karena itu, sebaiknya jangan simpan ID objek di penyimpanan aplikasi Anda. Sebagai gantinya, Anda harus menemukan objek dalam presentasi berdasarkan konten teks atau teks alternatifnya.
Presentasi yang baru dibuat biasanya menggunakan serangkaian ID yang konsisten untuk slide, master, dan kotak teks default. ID ini dapat berubah dari waktu ke waktu, sehingga sebaiknya Anda tidak mengandalkan fitur ini. Sebagai gantinya, temukan elemen yang ingin Anda ubah menggunakan objek presentasi yang ditampilkan oleh panggilan ke create() atau get().