Method: presentations.create

Membuat presentasi kosong menggunakan judul yang diberikan dalam permintaan. Jika presentationId diberikan, 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)

Master slide dalam presentasi. Master slide berisi semua elemen halaman umum dan properti umum untuk serangkaian tata letak. Iklan ini memiliki tiga tujuan:

  • Bentuk placeholder pada master berisi gaya teks dan properti bentuk default dari semua bentuk placeholder pada 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 disusun dan diberi gaya 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 menegaskan bahwa revisi presentasi tidak berubah sejak operasi baca terakhir. Hanya diisi jika pengguna memiliki akses edit ke presentasi.

ID revisi bukan berupa angka 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 kepada 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. API ini memiliki tiga tujuan:

  • Bentuk placeholder pada master catatan berisi gaya teks default dan properti bentuk semua bentuk placeholder pada 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 muncul di semua notes pages.

Master catatan bersifat hanya baca.
comments[]

object (CommentThread)

Hanya output. Rangkaian komentar yang terkait dengan presentasi.
commentsViewMode

enum (CommentsViewMode)

Hanya output. Mode tampilan komentar yang diterapkan pada 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.