Slaytlar API'sini etkili bir şekilde kullanmak için sunumların ve bileşenlerinin mimarisini, ayrıca bu bileşenler arasındaki etkileşimleri anlamanız gerekir. Bu sayfada aşağıdaki konulara 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ı okumak, nasıl yapılır kılavuzlarını, referans dokümanlarını ve resep örneklerini anlamanızı ve kullanmanızı kolaylaştırır.
Sunumlar, sayfalar ve sayfa öğeleri
Google Slaytlar'daki en dış kapsayıcı öğe sunu'dur. Bu, Google Drive'a kaydedilebilen, diğer kullanıcılarla paylaşılabilen bir birimdir.
Her sunu, çeşitli sayfalar içerir. Bir sayfa türü de slayt'tır. Bu sayfalar, kullanıcıların sunum ekranda oluşturulduğunda gördüğü ve aralarında geçiş yaptığı sayfalardır.
Her sayfa, aşağıdaki şemada gösterildiği gibi sayfa içeriğini oluşturan bir dizi sayfa öğesi içerir:
Slaytların yanı sıra, birçok farklı slayta tasarım uygulayarak tutarlı bir görünüm oluşturmanıza olanak tanıyan başka sayfa türleri de vardır. Diğer sayfa türleri ana sayfalar ve düzenlemelerdir. Bu sayfa türlerinin özellikleri, aşağıdaki şemada gösterildiği gibi slaytların oluşturulma şeklini belirler:
Ana sayfalar: Ana sayfa iki amaca hizmet eder. Ana şablondaki yer tutucular, sunumunuzda 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 ana slayta yerleştirin.
Düzenler: Düzen şablonları, her slayt türünde içeriğin nasıl düzenleneceğini belirler. 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.
Notlar sayfaları ve not ana sayfaları olmak üzere iki tür daha sayfa vardır. Bunlar çoğunlukla konuşmacı notlarıyla çalışmak için kullanılır.
API temsili türleri ve yapısı
Bu bölümde, yukarıda açıklanan Google Slaytlar kavramsal modelinin Slides API'de nasıl temsil edildiği açıklanmaktadır.
Aşağıdaki şemada, Slaytlar API'sindeki sunucular, 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 mülkü ve bu mülklerdeki sayfaları içerir:
{
"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 bu özelliklerdeki sayfa öğelerini içerir:
{
"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ştirme alanı element_kind tarafından tanımlandığı gibi, birkaç tür sayfa öğesi vardır. Bu tür sayfa öğeleri aşağıdaki tabloda açıklanmıştır:
| Öğe türü | Açıklama |
|---|---|
| Grup | Bağımsız bir birim olarak ele alınan bir sayfa öğesi grubu. Bunlar birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilir. |
| Şekil | Dikdörtgen, elips ve metin kutusu gibi düz bir görsel nesne. Şekiller metin içerebildiğinden slayt oluşturmak için en yaygın 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 | İçerik ızgarasıdır. |
| WordArt | Daha çok bir şekle benzeyen 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 properties öğesi ve bir properties güncelleme mesajı vardır. Örneğin:
- Şekil adlı bir sayfa öğesi türü vardır.
- Özellik alanı shapeProperties'dir.
- Bu özellikleri güncelleme isteği UpdateShapePropertiesRequest'tır.
Her sayfa öğesi türü için aynı öğe/özellikler/güncelleme isteği grubu vardır: Resim/imageProperties/UpdateImageProperties vb.
Bir öğeyi okurken karşılaştığınız her yerde properties özelliğini okuyabilirsiniz. İçindeki değerleri değiştirmek için batchUpdate yönteminin yükü olarak eşleşen istek türüyle kullanın. Bu sayede, bu değerleri sunumda değiştirebilirsiniz.
Tesis türleri
Slaytlar API'sindeki çeşitli nesne türleri arasında ortak olan bazı özellikler vardır:
| Mülk | Açıklama |
|---|---|
| Renk | Slaytlar API'sindeki renkler RGB değeri veya tema rengine referans olabilir. Tema renklerine adlarıyla (ör. "DARK1") değinilir 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ç kısmının tek bir düz renkle doldurulduğu düz dolgudur. Dolgular, sayfaların arka planları için de kullanılabilir. |
| Dış çizgi | Dış çizgi, sayfa öğesini çevreleyen çizgi grubunu temsil eder. Çizgilerin rengi, dolgu ile 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 tasarlanmış bir görsel efekti temsil eder. Şu anda Slaytlar API'sindeki gölgeler salt okunur durumdadır. |
Mülkleri güncelleme
Bir mülkü 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 mülk mesajını kabul eder ve mülk mesajındaki hangi alanların güncellenmesi gerektiğini belirlemek için alan maskelerini kullanabilir.
Mülkü devralma
Sayfalar veya sayfa öğeleri, üst nesnelerinden özellik alabilir. Bir nesnenin, tanımladığı ve devraldığı özellikler de dahil olmak üzere özellikleri, nihai görsel görünümünü belirler.
- Sayfa özellikleri: Bir 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 sayfanın üst düzeninde veya ana sayfasında bulunan başka bir yer tutucu şekle açıkça referans verebilirsiniz.
Bu fikirler aşağıdaki paragraflarda daha ayrıntılı olarak açıklanmıştır.
Sayfa özelliklerinin devralınması
Slaytlar, düzenler ve ana şablonların yapısı, sunu içindeki bir devralma hiyerarşisini tanımlar: Slaytlar düzenleri, düzenler de ana şablonları devralır. Bir slaytın ebeveyn düzeni ve ana slaytı, slaytın slideProperties alanında belirtilir.
Bir sayfa, arka plan ve renk şeması gibi özellikleri üst sayfadan devralabilir. Alt sayfa, bir mülkü devralmak için PageProperties mesajında o mülk için bir değer belirlemez. "Geçersiz kılmayarak"; ebeveyn tarafından tanımlanan değer, sayfa tarafından kabul edilir devralınan değer.
Aşağıdaki şemada, bir ana öğeden devralınan bir düzenden ö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ın oluşturulması için kullanılan çözülmüş değerler şunlardır:
- Mülk A "Kırmızı".
- Mülk B "Orange".
Şekil özelliklerinin devralınması
Şekiller, diğer şekillerden dolgu, dış çizgi veya gölge gibi özellikleri devralabilir. Shape.placeholder alanı ayarlanmışsa şekil bir yer tutucusudur. Alt yer tutucunun Shape.placeholder.parentObjectId alanı, üst yer tutucusunu tanımlar. Bir düzene dayalı yeni bir slayt oluşturduğunuzda, söz konusu düzendeki yer tutucular yeni slaytta alt şekil olarak görünür.
Benzer şekilde, ana sayfalardaki yer tutucular, düzenlerin yer tutucularının ebeveyni olarak hareket edebilir.
Bu devralma hiyerarşisi tanımlandığında alt sayfa, ShapeProperties mesajında bu değeri ayarlayarak bir mülkü devralmaz. Alt şekil, ü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 slaytta, düzende ve ana öğede bulunan üç yer tutucu arasındaki özelliklerin devralınması gösterilmektedir:
Bir yer tutucu şeklini oluşturmak için kullanılan özellikler, tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, bu şekiller için çözülen değerler aşağıdaki gibidir:
- Yer tutucu1: propertyA "Sarı", propertyB "Yeşil" olarak oluşturulur.
- Placeholder2: propertyA "Sarı", propertyB "Mor" olarak oluşturulur.
- Yer tutucu3: propertyA "Sarı", propertyB "Mor" olarak oluşturulur.
Üst öğe sahibi olabilecek tek sayfa öğesi türü şekillerdir. Resim, tablo ve grafik gibi diğer türler yer tutucu olamaz ve üst öğeleri bulunamaz.
PropertyState kullanarak mülkleri "gizleme"
PropertyState enumeration, bir şeklin özelliğinin gerçekten oluşturma için mi yoksa değerin yalnızca alt şekiller tarafından devralınmak için mi kullanıldığını kontrol eder. NOT_RENDERED mülk durumuna sahip bir mülk, şekli kendi sayfasında oluştururken kullanılmaz. Ancak RENDERED mülk durumuna sahip alt öğeler bu özelliği miras alabilir.
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ülen değerler aşağıdaki gibidir:
- Yer tutucu1: propertyA "Kırmızı" olarak oluşturulur.
- Yer tutucu2: mülkA işlenmez. Bu, ana hat özelliği olsaydı Yer Tutucu2'nin ana hattı olmazdı.
- Yer tutucu3: mülkA işlenmez.
PropertyState enumeration değerinin olası bir değeri daha vardır: INHERIT mülk durumu, mülk durumunun kendisinin devralındığı ve üst öğenin değerinin kullanılması gerektiği anlamına gelir. Üst öğesi olmayan şekillerin INHERIT mülkü olamaz.