Slaytlar API'sini etkili bir şekilde kullanmak için sunuların ve bileşenlerinin mimarisini, ayrıca bu bileşenler arasındaki etkileşimleri anlamanız gerekir. Bu sayfada aşağıdaki konularla ilgili ayrıntılı bir genel bakış sunulmaktadır:
- Sunum bileşenlerinin kavramsal modeli
- API bu bileşenleri nasıl temsil eder?
- Bileşenlerin stil özellikleri
Bu ve diğer kavramlara genel bakışları okuyarak nasıl yapılır kılavuzlarını, referans belgelerini ve reçete örneklerini daha kolay anlayıp kullanabilirsiniz.
Sunular, sayfalar ve sayfa öğeleri
Google Slaytlar'daki en dıştaki kapsayıcı öğe bir sunudur. Bu, Google Drive'a kaydedilebilen, diğer kullanıcılarla paylaşılabilen vb. birimdir.
Her sunumda çeşitli türlerde sayfalar bulunur. Bir sayfa türü de slayt olarak adlandırılır. Slaytlar, sunu bir ekranda oluşturulduğunda kullanıcıların gördüğü ve aralarında geçiş yaptığı sayfalardır.
Her sayfada, aşağıdaki şemada gösterildiği gibi, sayfanın içeriğini oluşturan bir dizi sayfa öğesi bulunur:
Slaytların yanı sıra, birçok farklı slayta tasarım uygulamanıza olanak tanıyan ve tutarlı bir görünüm oluşturan başka sayfa türleri de vardır. Bu diğer sayfa türleri ana slaytlar ve düzenlerdir. Özellikleri, slaytların nasıl oluşturulacağını belirler. Bu durum aşağıdaki şemada gösterilmiştir:
Ana sayfalar: Ana sayfa iki amaca hizmet eder. Ana slayttaki yer tutucular, sununuzda kullanılan metin stillerinin varsayılanlarını içerir. Ana slayttaki arka plan ve diğer şekiller, bu ana slayta dayalı tüm slaytların varsayılan arka planını oluşturur. Sununuzdaki her slaytta görünmesini istediğiniz bir şirket logonuz varsa bunu asıl slayta yerleştirin.
Düzenler: Düzen şablonları, içeriğin her slayt türünde nasıl düzenleneceğini belirler. Tüm başlık slaytlarınızın belirli bir şekilde görünmesini istiyorsanız örneğin başlık düzeni şablonunu düzenleyebilirsiniz.
Çoğunlukla konuşmacı notlarıyla çalışırken kullanılan iki sayfa türü daha vardır: not sayfaları ve not ana sayfaları.
API gösterim türleri ve yapısı
Bu bölümde, yukarıda açıklanan Google Slaytlar kavramsal modelinin Slaytlar API'sinde nasıl temsil edildiği açıklanmaktadır.
Aşağıdaki diyagramda, Slaytlar API'sindeki türler olarak sunular, sayfalar ve sayfa öğeleri arasındaki ilişki gösterilmektedir:
Aşağıdaki bölümlerde bu türlerin JSON'da nasıl gösterildiği açıklanmaktadır.
Sunular
Sunu, bir dizi özellik içerir ve içindeki sayfaları barındırır:
{
"presentationId": string,
"pageSize": { object(Size) },
"slides": [ { object(Page) } ],
"title": string,
"masters": [ { object(Page) } ],
"layouts": [ { object(Page) } ],
"notesMaster": object(Page),
"locale": string,
}
Pages
Bir sayfa, bir dizi özellik içerir ve sayfadaki öğeleri barındırır:
{
"objectId": string,
"pageType": enum(PageType),
"pageElements": [ { object(PageElement) } ],
"pageProperties": { object(PageProperties) },
// Union field properties can be only one of the following:
"slideProperties": { object(SlideProperties) },
"layoutProperties": { object(LayoutProperties) },
"notesProperties": { object(NotesProperties) },
// End of list of possible types for union field properties.
}
Sayfa öğeleri
Sayfa öğeleri, sayfalara yerleştirilen görsel bileşenlerdir. API'deki bir sayfa öğesi, sayfa öğesinin türüne göre değişen bir alan da dahil olmak üzere çeşitli özellikler içerir:
{
"objectId": string,
"size": { object(Size) },
"transform": { object(AffineTransform) },
"title": string,
"description": string,
// Union field element_kind can be only one of the following:
"elementGroup": { object(Group) },
"shape": { object(Shape) },
"image": { object(Image) },
"video": { object(Video) },
"line": { object(Line) },
"table": { object(Table) },
"wordArt": { object(WordArt) },
"sheetsChart": { object(SheetsChart) },
// End of list of possible types for union field element_kind.
}
Yukarıdaki tanımda birleşim alanı element_kind ile tanımlandığı üzere, çeşitli sayfa öğeleri vardır. Bu tür sayfa öğeleri aşağıdaki tabloda açıklanmıştır:
| Öğe türü | Açıklama |
|---|---|
| Grup | Tek bir birim olarak ele alınan bir grup sayfa öğesi. Bunlar birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilir. |
| Şekil | Dikdörtgenler, elipsler ve metin kutuları gibi düz görsel nesneler. Şekiller metin içerebildiğinden slayt oluşturmak için en sık kullanılan sayfa öğeleridir. |
| Resim | Slaytlar'a aktarılmış bir grafik. |
| Video | Slaytlar'a aktarılan bir video. |
| Çizgi | Görsel bir çizgi, eğri veya bağlayıcı. |
| Tablo | İçerik ızgarası. |
| WordArt | Şekle daha çok benzeyen görsel bir metin öğesi. |
| SheetsChart | Google E-Tablolar'dan Slaytlar'a aktarılan bir grafik. |
Sayfa ve sayfa öğesi özellikleri
Slides API, sununuzdaki sayfaların ve sayfa öğelerinin görünümünü okumanıza ve güncellemenize olanak tanır. Farklı sayfa öğeleri, sayfa öğesinin nasıl oluşturulacağını kontrol eden farklı özellikleri destekler.
Her sayfa öğesi türünün karşılık gelen bir özellik öğesi ve bir özellik güncelleme mesajı vardır. Örneğin:
- Şekil adlı bir sayfa öğesi türü vardır.
- Özellik alanı shapeProperties'tir.
- Bu özellikleri güncelleme isteği UpdateShapePropertiesRequest'tir.
Her sayfa öğesi türü için aynı öğe/özellik/güncelleme isteği grubu vardır: Image/imageProperties/UpdateImageProperties vb.
Özellikler özelliğini, bir öğeyi okurken karşılaştığınız her yerde okuyabilirsiniz. Özellikteki değerleri değiştirmek için, batchUpdate yöntemi için yük olarak eşleşen istek türüyle birlikte kullanın. Böylece, bu değerleri sunuda değiştirebilirsiniz.
Mülk türleri
Slaytlar API'sindeki çeşitli nesne türleri arasında ortak olan bazı özellikler vardır:
| Mülk | Açıklama |
|---|---|
| Renk | Slides API'deki renkler RGB değeri veya tema rengine referans olabilir. Tema renkleri adlarıyla (örneğin, "DARK1") anılır ve sayfanın renk şeması kullanılarak RGB değerleriyle eşlenebilir. Bu renk şeması, Slaytlar düzenleyicisinde sununun teması değiştirildiğinde genellikle güncellenir. |
| Doldurma | Dolgu, bir nesnenin içindeki boş alanın oluşturulmasını ifade eder. Slaytlarda en yaygın olarak desteklenen dolgu, nesnenin iç kısmının tek bir düz renkle doldurulduğu düz dolgudur. Dolgu, sayfaların arka planları için de kullanılabilir. |
| Dış çizgi | Ana hat, sayfa öğesini çevreleyen çizgiler kümesini temsil eder. Çizgilerin rengi dolguyla kontrol edilir. Arayanlar, ana hatların genişliğini ve çizgi stilini de ayarlayabilir. |
| Gölge | Gölge, nesnenin oluşturduğu fiziksel gölgeyi taklit etmek için kullanılan bir görsel efekti temsil eder. Şu anda, Slaytlar API'sindeki gölgeler salt okunur durumdadır. |
Özellikleri güncelleme
Bir mülkü güncellemek için uygun Update...Properties isteğini batchUpdate çağrısında kullanın. Örneğin, Şekiller için UpdateShapeProperties. Bu istekler, tam özellikler mesajını kabul eder ve özellikler mesajındaki hangi alanların güncelleneceğini belirlemek için alan maskelerini kullanabilir.
Mülkü devralma
Bir sayfa veya sayfa öğesi, özellikleri üst öğelerinden devralabilir. Bir nesnenin tanımladığı ve devraldığı özellikler de dahil olmak üzere tüm özellikleri, son görsel görünümünü belirler.
- Sayfa özellikleri: Bir sayfa, tanımlamadığı ancak dayandığı düzende veya ana sayfada tanımlanan tüm özellikleri devralır.
- Şekil özellikleri: Bir şekil yer tutucu olarak işaretlenebilir. Bu sayede, özellikleri devralacağınız başka bir yer tutucu şekle (sayfanın üst yerleşiminde veya ana düzeninde) açıkça referans verebilirsiniz.
Bu fikirler aşağıdaki paragraflarda daha ayrıntılı olarak açıklanmaktadır.
Sayfa özelliklerinin devralınması
Slaytların, düzenlerin ve ana slaytların yapısı, sunu içinde bir devralma hiyerarşisi tanımlar: Slaytlar düzenlerden, düzenler ise ana slaytlardan devralınır. Bir slaytın üst düzeni ve ana slaytı, slaytın slideProperties alanında belirtilir.
Bir sayfa, üst sayfadan arka plan ve renk şeması gibi özellikleri devralabilir. Bir özelliği devralmak için alt sayfa, PageProperties mesajında bu özelliğe ait bir değer ayarlamaz. Sayfa, üst öğe tarafından tanımlanan değeri "geçersiz kılmadığı" için devralınan değeri kabul eder.
Aşağıdaki şemada, bir düzenden özellik devralan ve düzende de bir ana öğeden özellik devralan bir slayt gösterilmektedir:
Bir slaytı oluşturmak için kullanılan özellikler, tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, 1. slaytı oluşturmak için kullanılan çözümlenmiş değerler şunlardır:
- PropertyA, "Kırmızı"dır.
- PropertyB, "Orange" değerine sahip.
Şekil özelliklerinin devralınması
Şekiller, diğer şekillerden dolgu, ana hat veya gölge gibi özellikleri devralabilir. Bir şeklin Shape.placeholder alanı ayarlanmışsa bu şekil Shape.placeholder. Alt yer tutucunun Shape.placeholder.parentObjectId alanı, üst yer tutucusunu tanımlar. Bir düzene dayalı yeni bir slayt oluşturduğunuzda, bu düzendeki tüm yer tutucular yeni slaytta alt şekiller olarak görünür.
Benzer şekilde, ana sayfalardaki yer tutucular, düzenlerin yer tutucularının üst öğeleri olarak işlev görebilir.
Bu devralma hiyerarşisi tanımlandığında, alt sayfa, ShapeProperties mesajında bu değeri ayarlamayarak bir özelliği devralır. Üst öğe tarafından tanımlanan değeri geçersiz kılmadığınızda alt şekil, devralınan değeri kabul eder.
Aşağıdaki diyagramda, bir slayt, düzen ve ana öğede bulunan üç yer tutucu arasındaki özelliklerin devralınması gösterilmektedir:
Yer tutucu şekli oluşturmak için kullanılan özellikler, tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, bu şekillerin çözümlenmiş değerleri aşağıdaki gibidir:
- Yer tutucu 1: propertyA, "Sarı" olarak, propertyB ise "Yeşil" olarak oluşturulur.
- Yer tutucu2: propertyA, "Sarı", propertyB ise "Mor" olarak oluşturulur.
- Yer tutucu3: propertyA, "Sarı" olarak, propertyB ise "Mor" olarak oluşturulur.
Şekiller, üst öğelere sahip olabilen tek sayfa öğesi türüdür. Resim, tablo ve grafik gibi diğer türler yer tutucu olamaz ve üst öğeleri olamaz.
PropertyState kullanarak özellikleri "gizleme"
PropertyState numaralandırması, bir şeklin özelliğinin oluşturma için gerçekten kullanılıp kullanılmadığını veya değerin yalnızca alt şekiller tarafından devralma için kullanılıp kullanılmadığını kontrol eder. Mülk durumu NOT_RENDERED olan bir mülk, şekli sayfasında oluştururken kullanılmaz. Ancak karşılık gelen mülk durumu RENDERED olan alt öğeler bu mülkü devralmaya devam edebilir.
Aşağıdaki şemada, PropertyState alanını değiştiren üç yer tutucu arasındaki özelliklerin devralınması gösterilmektedir:
Şekil özelliklerinin oluşturulması, PropertyState alanından etkilenebilir. Bu örnekte, bu şekiller için çözümlenen değerler aşağıdaki gibidir:
- Yer tutucu 1: propertyA, "Kırmızı" olarak oluşturulur.
- Yer tutucu2: propertyA işlenmiyor. Bu, anahat özelliği olsaydı Placeholder2'nin anahattı olmazdı.
- Yer tutucu3: propertyA işlenmiyor.
PropertyState
numaralandırmasının bir olası değeri daha vardır: INHERIT özellik durumu, özellik durumunun kendisinin devralındığı ve üst öğenin değerinin kullanılması gerektiği anlamına gelir. Üst öğesi olmayan şekillerin INHERIT özellik durumu olamaz.