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 diberikan, akan diabaikan. Menampilkan presentasi yang dibuat.

Permintaan HTTP

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

URL ini 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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Kolom
presentationId

string

ID presentasi.

pageSize

object (Size)

Ukuran halaman dalam presentasi.

slides[]

object (Page)

Slide dalam presentasi. Slide mewarisi properti dari tata letak slide.

title

string

Judul presentasi.

masters[]

object (Page)

Slide master dalam presentasi. Slide master berisi semua elemen halaman umum dan properti umum untuk kumpulan tata letak. Tujuannya ada tiga:

  • 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 cara konten diatur dan diberi gaya pada slide yang mewarisi dari tata letak tersebut.

locale

string

Bahasa lokal presentasi, sebagai tag bahasa IETF BCP 47.

revisionId

string

Hanya output. ID revisi presentasi. Dapat digunakan dalam permintaan pembaruan untuk memastikan revisi presentasi tidak berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan nomor berurutan, melainkan string yang tidak jelas. Format ID revisi dapat berubah dari waktu ke waktu, sehingga harus diperlakukan secara buram. ID revisi yang ditampilkan hanya dijamin valid selama 24 jam setelah ditampilkan dan tidak dapat dibagikan antar-pengguna. Jika ID revisi tidak berubah di antara panggilan, presentasi tidak akan berubah. Sebaliknya, ID yang berubah (untuk presentasi dan pengguna yang sama) biasanya berarti presentasi telah diperbarui. Namun, ID yang berubah juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

notesMaster

object (Page)

Master catatan dalam presentasi. Tujuannya ada tiga:

  • Bentuk placeholder pada 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 pada master catatan akan muncul di semua notes pages.

Master catatan bersifat hanya baca.

comments[]

object (CommentThread)

Hanya output. Thread komentar yang terkait dengan presentasi.

commentsViewMode

enum (CommentsViewMode)

Hanya output. Mode tampilan komentar yang diterapkan ke presentasi.

Isi respons

Jika berhasil, isi respons akan 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 mengetahui informasi selengkapnya, lihat panduan Otorisasi.