Pengantar

Google Slides API memungkinkan Anda membuat dan memodifikasi presentasi Google Slide.

Aplikasi dapat berintegrasi dengan Google Slides API untuk membuat dek slide yang indah secara otomatis dari data yang disediakan pengguna dan sistem. Misalnya, Anda dapat menggunakan detail pelanggan dari database dan menggabungkannya dengan template yang telah didesain sebelumnya dan opsi konfigurasi yang dipilih untuk membuat presentasi jadi dalam waktu yang sangat singkat dibandingkan dengan membuatnya secara manual.

Ringkasan API

Koleksi presentasi menyediakan metode yang memungkinkan Anda mendapatkan dan mengupdate elemen dalam presentasi.

Sebagian besar pekerjaan Anda dengan Slides API mungkin akan 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 {i>slide<i} seperti bentuk atau tabel
  • Menyisipkan, mengubah, dan menghapus teks
  • Menerapkan transformasi ke elemen
  • Mengubah urutan slide

Lihat Update batch untuk mengetahui detail selengkapnya. Lihat Panduan memulai untuk mengetahui contoh menyeluruh yang sederhana tentang 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 terbiasa menggunakan Drive API, presentationId akan sesuai dengan ID resource File.

Halaman dan elemen halaman diidentifikasi melalui ID objek.

Pages

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 mungkin memiliki beberapa master atau tidak sama sekali.
Tata letak Tata letak berfungsi sebagai template cara elemen halaman akan disusun secara default pada slide 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 {i>slide<i} memiliki satu halaman catatan yang sesuai. Hanya teks dalam bentuk catatan pembicara yang dapat dimodifikasi 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 Kumpulan elemen halaman yang diperlakukan sebagai unit individual. Elemen tersebut dapat dipindahkan, diskalakan, dan diputar bersama.
Bentuk Objek visual biasa, seperti persegi panjang, elips, dan kotak teks. Bentuk dapat berisi teks, sehingga merupakan elemen halaman paling umum untuk membangun slide.
Gambar Grafik yang diimpor ke Slide.
Video Video yang diimpor ke Slide.
Garis Garis, kurva, atau konektor visual.
Tabel Petak konten.
WordArt Elemen teks visual yang berperilaku seperti sebuah bentuk.
SheetsChart Diagram yang diimpor ke Slide dari Google Spreadsheet.

Update massal

Metode batchUpdate memungkinkan Anda mengupdate banyak aspek presentasi. Perubahan dikelompokkan bersama dalam batch sehingga jika satu permintaan gagal, tidak ada perubahan lainnya (yang mungkin bergantung pada) yang akan ditulis.

Metode batchUpdate bekerja dengan mengambil satu atau beberapa objek Request, yang masing-masing menentukan satu jenis permintaan untuk dilakukan. Ada berbagai jenis permintaan. Berikut adalah perincian jenis permintaan, yang dikelompokkan ke dalam beberapa kategori.

Bekerja dengan Slide: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Bekerja dengan Elemen Halaman: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Bekerja dengan Tabel: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Bekerja dengan Diagram: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Menangani Gambar dan Video: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Menangani Teks: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

Metode batchUpdate menampilkan isi respons, yang berisi Respons untuk setiap permintaan. Setiap respons menempati indeks yang sama dengan permintaan terkait; untuk permintaan tanpa respons yang berlaku, respons pada indeks tersebut akan kosong. Berbagai 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 bisa menetapkan ID objek untuk objek baru secara opsional. Hal ini memungkinkan Anda membuat sebuah objek dan memodifikasinya dalam permintaan Parcelable 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 mengandalkan ID objek karena dapat berubah. Lihat bagian berikut untuk detail selengkapnya.

Melacak objek tanpa menggunakan ID objek

Saat Anda membuat permintaan Slides API, ID objek biasanya dipertahankan. (Pengecualian apa pun akan dijelaskan dalam dokumentasi referensi metode.) Membuat salinan seluruh presentasi dengan Drive API juga akan mempertahankan ID objek.

Namun, Anda tidak dapat bergantung pada ID objek yang tidak berubah setelah presentasi diubah di UI Slide. Misalnya, jika seseorang menggunakan UI Slide untuk menyalin dan menempel elemen halaman, lalu menghapus elemen halaman asli, elemen halaman sekarang akan memiliki ID unik baru, dan ID yang sebelumnya Anda berikan melalui API akan hilang. Oleh karena itu, Anda sebaiknya tidak menyimpan ID objek di penyimpanan aplikasi. Sebagai gantinya, Anda harus menemukan objek dalam presentasi berdasarkan konten teks atau teks alternatifnya.

Presentasi yang baru dibuat biasanya menggunakan kumpulan ID yang konsisten untuk slide, master, dan kotak teks default. ID ini dapat berubah dari waktu ke waktu, jadi sebaiknya Anda tidak mengandalkan fitur ini. Sebagai gantinya, temukan elemen yang ingin Anda modifikasi menggunakan objek presentasi yang ditampilkan oleh panggilan ke create() atau get().