Method: presentations.create

İstekte verilen başlığı kullanarak boş bir sunu oluşturur. Bir presentationId sağlanırsa yeni sununun kimliği olarak kullanılır. Aksi takdirde yeni bir kimlik oluşturulur. Sağlanan içerikler de dahil olmak üzere istekteki diğer alanlar yoksayılır. Oluşturulan sunuyu döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Alanlar
presentationId

string

Sununun kimliği.

pageSize

object (Size)

Sunudaki sayfaların boyutu.

slides[]

object (Page)

Sunudaki slaytlar. Bir slayt, özellikleri bir slayt düzeninden devralır.

title

string

Sunumun başlığı.

masters[]

object (Page)

Slayt, sunuda ana slayt haline gelir. Ana slayt, tüm ortak sayfa öğelerini ve bir düzen kümesi için ortak özellikleri içerir. Üç amaca hizmet ederler:

  • Bir ana slayttaki yer tutucu şekilleri, bu ana slaydı kullanan sayfalardaki tüm yer tutucu şekillerin varsayılan metin stillerini ve şekil özelliklerini içerir.
  • Ana sayfa özellikleri, düzenleri tarafından devralınan genel sayfa özelliklerini tanımlar.
  • Ana slayttaki diğer şekiller, düzeninden bağımsız olarak bu ana slaytı kullanan tüm slaytlarda görünür.
layouts[]

object (Page)

Sunudaki düzenler. Düzen, içeriğin bu düzenden devralınan slaytlarda nasıl düzenleneceğini ve biçimlendirileceğini belirleyen bir şablondur.

locale

string

IETF BCP 47 dil etiketi olarak sununun yerel ayarı.

revisionId

string

Yalnızca çıkış. Sununun düzeltme kimliği. Son okuma işleminden bu yana sunu düzeltmesinin değişmediğini iddia etmek için güncelleme isteklerinde kullanılabilir. Yalnızca kullanıcının sunu için düzenleme erişimi varsa doldurulur.

Düzeltme kimliği sıralı bir sayı değil, belirsiz bir dizedir. Düzeltme kimliğinin biçimi zaman içinde değişebileceğinden opak şekilde ele alınmalıdır. Döndürülen düzeltme kimliğinin, yalnızca iade edildikten sonra 24 saat boyunca geçerli olacağı garanti edilir ve bu kimlik kullanıcılar arasında paylaşılamaz. Görüşmeler arasında düzeltme kimliği değişmiyorsa sunu da değişmemiştir. Buna karşılık, kimliğin değiştirilmesi (aynı sunu ve kullanıcı için) genellikle sununun güncellendiği anlamına gelir. Ancak kimliğin değiştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanıyor olabilir.

notesMaster

object (Page)

Sunudaki notlar. Üç amaca hizmet eder:

  • Not ana kopyasındaki yer tutucu şekilleri, notes pages ürünündeki tüm yer tutucu şekillerin varsayılan metin stillerini ve şekil özelliklerini içerir. Özellikle, bir SLIDE_IMAGE yer tutucu şekli slayt küçük resmini içerir ve bir BODY yer tutucu şekli konuşmacı notlarını içerir.
  • Notlar ana sayfası özellikleri, tüm notes pages tarafından devralınan ortak sayfa özelliklerini tanımlar.
  • Notlar ana kopyasındaki diğer şekiller tüm notes pages üzerinde görünür.

Notlar ana kopyası salt okunurdur.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulmuş bir Presentation örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.