Method: presentations.create

İstekle 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. İstekle ilgili diğer alanlar (sağlanan içerikler dahil) 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 metni

İstek içeriği aşağıdaki yapıyla birlikte 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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
Alanlar
presentationId

string

Sununun kimliği.
pageSize

object (Size)

Sunudaki sayfaların boyutu.
slides[]

object (Page)

Sunudaki slaytlar. Slaytlar, özellikleri slayt düzeninden devralır.
title

string

Sunumun başlığı.
masters[]

object (Page)

Sunumdaki asıl slaytlar. Ana slayt, tüm ortak sayfa öğelerini ve bir dizi düzenin ortak özelliklerini içerir. Üç amaca hizmet ederler:

  • Bir ana öğedeki yer tutucu şekiller, bu ana öğeyi 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 ortak sayfa özelliklerini tanımlar.
  • Ana slayttaki diğer tüm şekiller, düzenlerinden 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 stillendirileceğini belirleyen bir şablondur.
locale

string

Sunumun yerel ayarı (IETF BCP 47 dil etiketi olarak).
revisionId

string

Yalnızca çıkış. Sununun düzeltme kimliği. Sunum 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 sunuyu 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 zamanla değişebilir. Bu nedenle, opak olarak değerlendirilmelidir. Döndürülen düzeltme kimliğinin yalnızca döndürüldükten sonraki 24 saat içinde geçerli olduğu garanti edilir ve kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmediyse sunum değişmemiştir. Aynı şekilde, aynı sunum ve kullanıcı için kimliğin değişmesi genellikle sunumun güncellendiği anlamına gelir. Ancak değişen kimlik, kimlik biçimindeki değişiklikler gibi dahili faktörlerden de kaynaklanabilir.
notesMaster

object (Page)

Sunumdaki not ana sayfası. Üç amaca hizmet eder:

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

Notlar ana sayfası salt okunurdur.
comments[]

object (CommentThread)

Yalnızca çıkış. Sunuyla ilişkili yorum ileti dizileri.
commentsViewMode

enum (CommentsViewMode)

Yalnızca çıkış. Sunuya uygulanan yorum görüntüleme modu.

Yanıt metni

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