Method: presentations.create

İstekte verilen başlığı kullanarak boş bir sunu oluşturur. presentationId sağlanırsa yeni sununun kimliği olarak kullanılır. Aksi takdirde yeni bir kimlik oluşturulur. İstekteki diğer alanlar ve sağlanan içerikler yok sayı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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 slayt düzeninden devralır.
title

string

Sununun başlığı.
masters[]

object (Page)

Sunudaki slayt ana slaytları. Ana slayt , tüm ortak sayfa öğelerini ve bir dizi düzen için ortak özellikleri içerir. Üç amaca hizmet ederler:

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

object (Page)

Sunudaki düzenler. Düzen, ilgili düzenden devralan slaytlarda içeriğin nasıl düzenleneceğini ve stil yapılacağını belirleyen bir şablondur.
locale

string

IETF BCP 47 dil etiketi olarak sununun yerel ayarı.
revisionId

string

Yalnızca çıkış. Sununun düzeltme kimliği. Sunu düzeltmesinin son okuma işleminden bu yana değişmediğini onaylamak 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 bir şekilde ele alınmalıdır. Döndürülen düzeltme kimliği, iade edildikten sonraki 24 saat boyunca geçerli olur ve kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmezse sunu değişmemiştir. Öte yandan, kimlik 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 kaynaklanabilir.
notesMaster

object (Page)

Sunudaki not ustası. Üç amaca hizmet eder:

  • Ana not üzerindeki yer tutucu şekilleri, notes pages üzerindeki tüm yer tutucu şekillerin varsayılan metin stillerini ve şekil özelliklerini içerir. Ayrıntılı olarak belirtmek gerekirse, SLIDE_IMAGE yer tutucu şekli slayt küçük resmini içerir ve BODY yer tutucu şekli konuşmacı notlarını içerir.
  • Notlar ana sayfa özellikleri, tüm notes pages tarafından devralınan ortak sayfa özelliklerini tanımlar.
  • Not ana slaytındaki diğer şekiller tüm notes pages öğelerinde görünür.

Not ana sayfası salt okunurdur.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulan 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ılavuzu'na bakın.