Method: presentations.create

Membuat presentasi kosong menggunakan judul yang diberikan dalam permintaan. Jika presentationId diberikan, ID tersebut akan digunakan sebagai ID presentasi baru. Jika tidak, ID baru akan dibuat. Kolom lain dalam permintaan, termasuk konten yang disediakan, 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)

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

title

string

Judul presentasi.

masters[]

object (Page)

Slide master dalam presentasi. {i>Slide master<i} berisi semua elemen halaman umum dan properti umum untuk serangkaian tata letak. Keduanya memiliki tiga tujuan:

  • Bentuk placeholder pada master berisi gaya teks dan properti bentuk default 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 diatur dan digayakan pada {i>slide<i} 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 angka urut, melainkan string yang kabur. Format ID revisi dapat berubah dari waktu ke waktu, sehingga harus diperlakukan buram. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah dikembalikan dan tidak dapat dibagikan kepada seluruh pengguna. Jika ID revisi tidak berubah di antara panggilan, presentasi tidak akan berubah. Sebaliknya, ID yang diubah (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 lainnya 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.