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 {i>database<i} dan menggabungkannya dengan template dan opsi konfigurasi yang dipilih untuk membuat presentasi yang telah selesai dalam waktu singkat yang dibutuhkan untuk membuatnya secara manual.
Ringkasan API
Kumpulan presentasi memberikan yang memungkinkan Anda mendapatkan dan memperbarui elemen dalam presentasi.
Sebagian besar pekerjaan Anda dengan Slides API mungkin akan membuat dan mengupdate presentasi. Anda akan melakukan ini dengan menggunakan batchUpdate; metode ini mengambil daftar Minta yang memungkinkan Anda melakukan hal-hal seperti:
- Buat Slide
- Menambahkan elemen ke slide, seperti bentuk atau tabel
- Menyisipkan, mengubah, dan menghapus teks
- Menerapkan transformasi pada elemen
- Mengubah urutan slide
Lihat Update massal untuk mengetahui detail selengkapnya. Lihat panduan Memulai untuk contoh menyeluruh yang sederhana tentang cara menggunakan API.
Struktur presentasi
Presentasi di Slides API terdiri dari halaman, yang berisi halaman yang kurang penting.
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. Ekspresi reguler berikut dapat digunakan untuk mengekstrak ID presentasi dari URL Google Spreadsheet:
/presentation/d/([a-zA-Z0-9-_]+)
Jika Anda sudah terbiasa dengan Drive API, presentationId sesuai dengan
ID File
resource Anda
Halaman dan elemen halaman diidentifikasi berdasarkan ID objek.
Jumlah halaman
Google Slide memiliki jenis halaman berikut:
| Magister | Master slide menentukan gaya teks, latar belakang, dan halaman default elemen yang muncul di semua {i>slide<i} yang menggunakan master ini. Halaman elemen yang harus muncul pada semua {i>slide<i} harus ditambahkan ke master. Paling sering presentasi memiliki satu {i>master<i}, tetapi beberapa mungkin memiliki lebih dari satu atau tidak sama sekali. |
| Tata letak | {i>Layout<i} berfungsi sebagai {i>template<i} tentang bagaimana elemen laman akan disusun oleh {i>default<i} pada {i>slide<i} menggunakan tata letak. Setiap tata letak dikaitkan dengan satu induk. |
| 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 {i>slide<i} saat dibuat. |
| Catatan | Halaman-halaman ini berisi konten untuk materi presentasi, termasuk bentuk yang berisi catatan pembicara {i>slide<i}. Setiap {i>slide<i} memiliki satu halaman catatan terkait. Hanya teks dalam bentuk catatan pembicara yang dapat dimodifikasi dengan Slides API. |
| Master catatan | Master catatan mendefinisikan 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 pada halaman. API mengekspos beberapa jenis elemen halaman:
| Grup | Kumpulan elemen halaman yang diperlakukan sebagai unit individual. Mereka dapat dipindahkan, diskalakan, dan diputar bersama. |
| Bentuk | Objek visual biasa, seperti persegi panjang, elips, dan kotak teks. Bentuk bisa berisi teks, jadi ini adalah elemen halaman yang paling umum untuk dibuat {i>slide<i}. |
| Gambar | Grafik yang diimpor ke Slide. |
| Video | Video yang diimpor ke Slide. |
| Garis | Garis visual, kurva, atau konektor. |
| Tabel | Petak konten. |
| WordArt | Elemen teks visual yang berperilaku lebih mirip dengan bentuk. |
| SheetsChart | Diagram yang diimpor ke Slide dari Google Spreadsheet. |
Kumpulan update
Metode batchUpdate memungkinkan Anda untuk memperbarui banyak aspek presentasi. Perubahan dikelompokkan bersama dalam batch sehingga jika satu permintaan gagal, tidak ada permintaan lainnya (kemungkinan dependen) perubahan tersebut ditulis.
Metode batchUpdate berfungsi dengan mengambil satu atau beberapa
Minta
objek, masing-masing menetapkan satu jenis permintaan untuk dilakukan. Ada
berbagai jenis permintaan. Berikut ini perincian jenis permintaan,
yang dikelompokkan ke dalam
kategori yang berbeda.
Metode batchUpdate menampilkan isi respons,
yang berisi
Respons
untuk setiap permintaan. Setiap respons menempati indeks yang sama dengan respons
meminta; untuk permintaan tanpa respons yang berlaku, respons pada indeks tersebut
akan kosong. Berbagai permintaan Create biasanya memiliki respons, jadi
Anda tahu 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 di dalam presentasi.
Menentukan ID objek saat pembuatan
Saat membuat halaman atau elemen halaman menggunakan batchUpdate, Anda dapat bisa saja menentukan ID objek untuk objek baru. Hal ini memungkinkan Anda membuat dan memodifikasinya dalam permintaan privatenet yang sama, sehingga meminimalkan angka tersebut 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.
Kapan aplikasi Anda ingin melacak objek dalam waktu yang lebih lama waktu, jangan mengandalkan ID objek, karena dapat berubah. Lihat yang berikut ini untuk detail selengkapnya.
Melacak objek tanpa menggunakan ID objek
Saat Anda membuat permintaan Slides API, ID objek biasanya dipertahankan. (Apa pun pengecualian yang disebutkan dalam dokumentasi referensi metode.) Membuat salinan seluruh presentasi dengan Drive API juga akan mempertahankan ID objek.
Namun, Anda tidak dapat bergantung pada apakah ID objek tidak berubah setelah presentasi diubah di UI Slide. Misalnya, jika seseorang menggunakan Slide UI untuk menyalin-menempel elemen halaman dan kemudian menghapus yang asli, elemen halaman sekarang akan memiliki ID unik baru, dan ID yang sebelumnya Anda berikan melalui API akan hilang. Karena itu, kami tidak menyarankan Anda menyimpan ID objek pada dari penyimpanan aplikasi. Sebagai gantinya, Anda harus menemukan objek dalam presentasi dengan konten teks atau teks alternatifnya.
Presentasi yang baru dibuat biasanya menggunakan kumpulan ID yang konsisten sebagai default {i>slide<i}, master, dan kotak teks. ID ini dapat berubah dari waktu ke waktu, jadi kami tidak menyarankan Anda mengandalkan fitur ini. Sebaliknya, temukan elemen-elemen yang ingin Anda modifikasi menggunakan objek presentasi yang ditampilkan oleh panggilan create() atau get().