Slides API'yi etkili bir şekilde kullanmak için sunuların ve bileşenlerinin mimarisini ve 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:
- Sunu bileşenlerinin kavramsal modeli
- API'nin bu bileşenleri temsil etme şekli
- Bileşenlerin stil özellikleri
Bu ve diğer kavramlara genel bakış bölümlerini okumak, "Nasıl Yapılır?" kılavuzlarını, referans belgelerini ve kod örneklerini anlamayı ve kullanmayı kolaylaştırır.
Sunular, sayfalar ve sayfa öğeleri
Google Slaytlar'daki en dış kapsayıcı öğe bir sunudur. Google Drive'a kaydedilebilen, diğer kullanıcılarla paylaşılabilen ve benzeri işlemler yapılabilen birim budur.
Her sunuda çeşitli sayfa türleri bulunur. Sayfa türlerinden biri slayttır. Slaytlar, sunu ekranda gösterilirken kullanıcıların gördüğü ve aralarında geçiş yaptığı sayfalardır.
Her sayfada, aşağıdaki diyagramda gösterildiği gibi sayfanın içeriğini oluşturan bir dizi sayfa öğesi bulunur:
Slaytların yanı sıra, tasarımı birçok farklı slayta uygulayarak tutarlı bir görünüm oluşturmanıza olanak tanıyan başka sayfa türleri de vardır. Bu diğer sayfa türleri ana slaytlar ve düzenlerdir. Özellikleri, slaytların aşağıdaki şemada gösterildiği şekilde oluşturulmasını belirler:
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 slaytı temel alan tüm slaytların varsayılan arka planını oluşturur. Sununuzdaki her slaytta görünmesini istediğiniz bir şirket logonuz varsa bunu ana slayta yerleştirin.
Düzenler: Düzen şablonları, içeriğin her slayt türünde nasıl düzenleneceğini belirler. Örneğin, tüm başlık slaytlarınızın belirli bir şekilde görünmesini istiyorsanız başlık düzeni şablonunu düzenleyebilirsiniz.
Konuşmacı notlarıyla çalışırken çoğunlukla kullanılan iki sayfa türü daha vardır: not sayfaları ve not asılları.
API temsil 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 şemada, Slides API'deki 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 temsil edildiği gösterilmektedir.
Sunular
Sunu, bir dizi özellik ve içerdiği 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
Sayfa, bir dizi özellik ve içerdiği sayfa öğelerini 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 element_kind birleşim alanı tarafından tanımlanan çeşitli sayfa öğesi türleri 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 değerlendirilen sayfa öğeleri grubu. Birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilirler. |
| Şekil | Dikdörtgenler, elipsler ve metin kutuları gibi düz bir görsel nesne. Şekiller metin içerebildiğinden slayt oluşturmak için en yaygın kullanılan sayfa öğeleridir. |
| Resim | Slaytlar'a aktarılan bir grafik. |
| Video | Slaytlar'a aktarılan bir video. |
| Çizgi | Görsel bir çizgi, eğri veya bağlayıcı. |
| Tablo | İçeriklerin yer aldığı bir tablo. |
| WordArt | Şekil gibi davranan görsel 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 özellikler öğesi ve özellikler güncelleme mesajı vardır. Örneğin:
- Şekil türünde bir sayfa öğesi var.
- Özellik alanı shapeProperties'dir.
- Bu özellikleri güncelleme isteği UpdateShapePropertiesRequest şeklindedir.
Her sayfa öğesi türü için aynı öğe/özellikler/güncelleme isteği grubu mevcuttur: Image/imageProperties/UpdateImageProperties vb.
Bir öğeyi okurken karşılaştığınız her yerde properties özelliğini okuyabilirsiniz. Bu özellikteki değerleri değiştirmek için, özelliği batchUpdate yönteminin yükü olarak eşleşen istek türüyle birlikte kullanın. Böylece sunudaki bu değerleri değiştirebilirsiniz.
Özellik türleri
Slides API'deki ç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 (ör. "DARK1") belirtilir ve sayfanın renk şeması kullanılarak RGB değerleriyle eşlenebilir. Bu renk şeması genellikle Slaytlar düzenleyicisinde sununun teması değiştirilirken güncellenir. |
| Doldurma | Dolgu, bir nesnenin içindeki boş alanın oluşturulmasını temsil eder. Slaytlar'da en yaygın olarak desteklenen dolgu, bir nesnenin içinin 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 grubunu temsil eder. Çizgilerin rengi, dolgu ile kontrol edilir. Görüşme katılımcıları, ana hatların genişliğini ve çizgi stilini de ayarlayabilir. |
| Gölge | Gölge, nesnenin oluşturduğu fiziksel gölgeyi taklit eden görsel bir efekttir. Şu anda Slides API'deki gölgeler salt okunurdur. |
Özellikler güncelleniyor
Bir özelliği güncellemek için batchUpdate çağrısında uygun Update...Properties isteğini kullanın (ör. Şekiller için UpdateShapeProperties). Bu istekler tam bir özellik mesajı kabul eder ve özellik mesajındaki hangi alanların güncellenmesi gerektiğini belirlemek için alan maskelerini kullanabilir.
Mülkü devralma
Bir sayfa veya sayfa öğesi, üst nesnelerinden özellikleri devralabilir. Bir nesnenin tanımladığı ve devraldığı özellikler de dahil olmak üzere özellikleri, nihai görsel görünümünü belirler.
- Sayfa özellikleri: Sayfa, tanımlamadığı ancak temel aldığı düzende veya ana sayfada tanımlanan tüm özellikleri devralır.
- Şekil özellikleri: Bir şekil, yer tutucu olarak işaretlenebilir. Bu sayede, özellikleri devralmak için başka bir yer tutucu şekle (sayfanın üst yerleşiminde veya ana sayfasında) 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ır. Slaytın üst yerleşimi ve ana slaytı, slaytın slideProperties alanında belirtilir.
Bir sayfa, üst sayfadan arka plan ve renk şeması gibi özellikleri devralabilir. Alt sayfa, bir özelliği devralmak için PageProperties mesajında bu özellik için bir değer ayarlamaz. Sayfa, üst öğe tarafından tanımlanan değeri "geçersiz kılmayarak" devralınan değeri kabul eder.
Aşağıdaki diyagramda, bir ana slayttan devralınan düzenden özellikleri devralan bir slayt gösterilmektedir:
Bir slaytı oluşturmak için kullanılan özellikler, slaytın tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, 1. slaytı oluşturmak için kullanılan çözümlenmiş değerler aşağıdaki gibidir:
- PropertyA "Kırmızı"dır.
- PropertyB "Orange"dır.
Şekil özelliklerini devralma
Şekiller; dolgu, ana hat veya gölge gibi özellikleri diğer şekillerden devralabilir. Shape.placeholder alanı ayarlanmışsa şekil bir yer tutucudur. 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ılmayan alt şekil, devralınan değeri kabul eder.
Aşağıdaki diyagramda, bir slayt, düzen ve ana slaytta 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 şekiller için çözümlenen değerler aşağıdaki gibidir:
- Placeholder1: propertyA "Sarı", propertyB "Yeşil" olarak oluşturulur.
- Placeholder2: propertyA "Sarı", propertyB "Mor" olarak oluşturulur.
- Placeholder3: propertyA "Sarı", propertyB "Mor" olarak oluşturulur.
Şekiller, üst öğesi olabilen tek sayfa öğesi türüdür. Resimler, tablolar ve grafikler 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 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. Özellik durumu NOT_RENDERED olan bir özellik, sayfasında şekil oluşturulurken kullanılmaz ancak karşılık gelen özellik durumu RENDERED olan alt öğeler bu özelliği devralabilir.
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:
- Placeholder1: propertyA, "Kırmızı" olarak oluşturulur.
- Placeholder2: propertyA is not rendered. Bu özellik outline olsaydı Placeholder2'nin dış çizgisi olmazdı.
- Placeholder3: propertyA is not rendered.
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 özellik durumu INHERIT olamaz.