Method: presentations.create

Membuat presentasi kosong menggunakan judul yang diberikan dalam permintaan. Jika disediakan, presentationId akan digunakan sebagai ID presentasi baru. Jika tidak, ID baru akan dibuat. Kolom lain dalam permintaan, termasuk konten yang diberikan, akan diabaikan. Menampilkan presentasi yang dibuat.

Permintaan HTTP

POST https://slides.googleapis.com/v1/presentations

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Kolom
presentationId

string

ID presentasi.

pageSize

object (Size)

Ukuran halaman dalam presentasi.

slides[]

object (Page)

{i>Slide<i} dalam presentasi. Slide mewarisi properti dari tata letak slide.

title

string

Judul presentasi.

masters[]

object (Page)

Master slide dalam presentasi. Slide master berisi semua elemen halaman umum dan properti umum untuk satu set tata letak. Keduanya memiliki tiga tujuan:

  • Bentuk placeholder pada master berisi gaya teks default dan properti bentuk dari semua bentuk placeholder di halaman yang menggunakan master tersebut.
  • Properti halaman master menentukan properti halaman umum yang diwarisi oleh tata letaknya.
  • Bentuk lain pada slide master akan muncul di semua slide yang menggunakan master tersebut, terlepas dari tata letaknya.
layouts[]

object (Page)

Tata letak dalam presentasi. Tata letak adalah template yang menentukan bagaimana konten disusun dan ditata pada slide yang mewarisi tata letak tersebut.

locale

string

Lokalitas presentasi, sebagai tag bahasa IETF BCP 47.

revisionId

string

Hanya output. ID revisi presentasi. Dapat digunakan dalam permintaan update untuk menyatakan bahwa revisi presentasi belum berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan nomor urut, melainkan string yang samar-samar. Format ID revisi dapat berubah dari waktu ke waktu, sehingga harus ditangani secara tidak transparan. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah ID tersebut dikembalikan dan tidak dapat dibagikan ke pengguna lain. Jika ID revisi tidak berubah di antara panggilan, presentasi tidak berubah. Sebaliknya, ID yang berubah (untuk presentasi dan pengguna yang sama) biasanya berarti presentasi telah diperbarui. Namun, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

notesMaster

object (Page)

Master catatan dalam presentasi. Ada tiga tujuan:

  • Bentuk placeholder di master catatan berisi gaya teks dan properti bentuk default dari semua bentuk placeholder di notes pages. Secara khusus, bentuk placeholder SLIDE_IMAGE berisi thumbnail slide, dan bentuk placeholder BODY berisi catatan pembicara.
  • Properti halaman master catatan menentukan properti halaman umum yang diwarisi oleh semua notes pages.
  • Bentuk lain di master catatan akan muncul di semua notes pages.

Master catatan bersifat hanya baca.

Isi respons

Jika berhasil, isi respons memuat instance Presentation yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Untuk informasi selengkapnya, lihat Panduan otorisasi.