Slaytlar API'yi etkili bir şekilde kullanmak için sunuların mimarisini, bileşenleri ve bu bileşenler arasındaki etkileşimleri anlamanız gerekir. Bu sayfada, bu konular hakkında 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
Bunu ve diğer kavramlara genel bakışları okumak, "Nasıl yapılır?" kılavuzlarını, referans belgelerini ve yemek tarifi örneklerini anlamayı ve kullanmayı kolaylaştırır.
Sunular, sayfalar ve sayfa öğeleri
Google Slaytlar'da en dıştaki kapsayıcı öğe bir sunudur. Bu, Google Drive'a kaydedilebilecek, diğer kullanıcılarla paylaşılabilecek vb. birimdir.
Her sunuda çeşitli türde sayfalar bulunur. Sayfa türlerinden biri slayttır. Bunlar, kullanıcıların sunu bir ekranda oluşturulurken gördüğü ve çevirdiği sayfalardır.
Her sayfada bir dizi sayfa öğesi bulunur. Bu öğeler aşağıdaki şemada gösterildiği gibi birlikte sayfanın içeriğini oluşturur:
Slaytların yanı sıra, tasarımı birçok farklı slayda uygulayarak tutarlı bir görünüm sağlamanızı sağlayan başka sayfa türleri de vardır. Bu diğer sayfa türleri ana sayfalar ve düzenlerdir ve özellikleri, aşağıdaki şemada gösterildiği gibi slaytların oluşturulma şeklini belirler:
Ana sayfalar: Ana sayfa iki amaca hizmet eder. Ana slayttaki yer tutucular, sununuzda kullanılan metin stilleri için varsayılan değerleri içerir. Ana slayttaki arka plan ve diğer şekiller, söz konusu ana slayta göre tüm slaytlar için varsayılan arka planı oluşturur. Sununuzdaki her slaytta görünmesini istediğiniz bir şirket logonuz varsa bunu ana slayda 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.
Çoğunlukla konuşmacı notlarıyla çalışmaya uygun olan iki tür sayfa daha vardır (not sayfaları ve not ana sayfaları).
API temsil türleri ve yapısı
Bu bölümde, yukarıda açıklandığı gibi Google Slaytlar kavramsal modelinin Slaytlar API'de nasıl temsil edildiği açıklanmaktadır.
Aşağıdaki şemada, Slaytlar API'sinde 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 gösterilmektedir.
Sunular
Sunu bir dizi özellik içerir ve içerdiği 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 özellik grubu içerir ve içinde bulunan 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 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şimi alanında 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 | Ayrı bir birim olarak değerlendirilen sayfa öğeleri kümesi. Bunlar birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilir. |
| Şekil | Dikdörtgenler, üç nokta ve metin kutuları gibi düz bir görsel nesne. Şekiller metin içerebileceğinden, slayt oluşturmak için en yaygın sayfa öğeleri kullanılır. |
| 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ı. |
| WordArt | Şekil gibi davranan bir görsel metin öğesi. |
| SheetsChart | Google E-Tablolar'dan Slaytlar'a aktarılan bir grafik. |
Sayfa ve sayfa öğesi özellikleri
Slaytlar API, sununuzdaki sayfaların ve sayfa öğelerinin görünümünü okuyup güncellemenizi sağlar. Farklı sayfa öğeleri, sayfa öğesinin nasıl oluşturulduğunu kontrol eden farklı özellikleri destekler.
Her sayfa öğesi türüne karşılık gelen bir özellik öğesi ve bir özellik güncelleme mesajı vardır. Örneğin:
- Bir sayfa öğesi türü (Şekil) vardır
- Özellik alanı shapeProperties'dir.
- Bu özellikleri güncelleme isteği UpdateShapePropertiesRequest'tir
Her bir sayfa öğesi türü için aynı öğe/özellikler/güncelleme isteği grubu bulunur: Image/imageProperties/UpdateImageProperties vb.
Bir öğeyi okurken özellik özelliğiyle karşılaştığınız her yerde bu özelliği okuyabilirsiniz. İçindeki değerleri değiştirmek amacıyla özelliği, batchUpdate yönteminin yükü olarak eşleştirme istek türüyle birlikte kullanın. Böylece, bu değerleri sunumda değiştirebilirsiniz.
Mülk türleri
Slaytlar API'sindeki çeşitli nesne türleri arasında ortak bazı özellikler vardır:
| Özellik | Açıklama |
|---|---|
| Renk | Slaytlar API'sindeki renkler, bir RGB değeri veya bir tema rengine referans olabilir. Tema renklerine adlarıyla atıfta bulunulur (örneğin "DARK1") ve sayfanın renk şeması kullanılarak RGB değerleriyle eşlenebilir. Bu renk şeması, Slaytlar düzenleyicisinde sununun teması değiştirilirken genellikle güncellenir. |
| Doldurma | Dolgu, bir nesne içindeki boş alanları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 kümesini temsil eder. Çizgilerin rengi Dolgu ile kontrol edilir. Arayanlar, dış çizgilerin genişliğini ve kısa çizgi stilini de ayarlayabilir. |
| Gölge | Gölge, nesnenin fiziksel bir gölgesini taklit etmesi için görsel bir efekti temsil eder. Şu anda Slaytlar API'deki gölgeler salt okunurdur. |
Mülkler güncelleniyor
Bir özelliği güncellemek için batchUpdate çağrısında uygun Update...Properties isteğini kullanın (örneğin, Şekiller için UpdateShapeProperties). Bu istekler, tam özellikler mesajını kabul eder ve özellikler mesajındaki hangi alanların güncellenmesi gerektiğini belirlemek için alan maskelerini kullanabilir.
Mülkten devralınan izinler
Bir sayfa veya sayfa öğesi, özellikleri üst nesnelerinden devralabilir. Bir nesnenin tanımladığı ve devraldığı özellikler dahil olmak üzere özellikleri, nesnenin son görsel görünümünü belirler.
- Sayfa özellikleri: Bir sayfa, tanımlamadığı ancak temel aldığı düzende veya ana sayfada tanımlanan özellikleri devralır.
- Şekil özellikleri: Bir şekil, yer tutucu olarak işaretlenebilir. Bu sayede, özellikleri devralacağınız başka bir yer tutucu şekline (sayfanın üst düzeninde 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şisini tanımlar: Slaytlar düzenlerden, düzenler ise ana slaytlardan devralır. Bir slaytın üst düzeni ve ana düzeni, slaytın slideProperties alanında belirtilir.
Bir sayfa, arka plan ve renk şeması gibi özellikleri bir üst sayfadan devralabilir. Bir mülkü devralmak için alt sayfa, PageProperties mesajında söz konusu özellik için bir değer ayarlamaz. Sayfa, üst öğe tarafından tanımlanan değeri "geçersiz kılmazsanız" devralınan değeri kabul eder.
Aşağıdaki şemada, özellikleri bir ana slayttan devralan ve düzeni ana slayttan devralan bir slayt gösterilmektedir:
Bir slaytı oluşturmak için kullanılan özellikler, tanımladığı özellikler ile devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, 1. Slaytı oluşturmak için kullanılan çözümlenmiş değerler aşağıdaki gibidir:
- MülkA "Kırmızı"dır.
- MülkB "Orange"dır.
Şekil özelliklerinin devri
Şekiller, diğer şekillerden dolgu, dış çizgi veya gölge gibi özellikleri devralabilir. Shape.placeholder alanı ayarlanmışsa bir şekil yer tutucu olur. Alt yer tutucunun Shape.placeholder.parentObjectId alanı, üst yer tutucusunu tanımlar. Bir düzene dayalı olarak yeni bir slayt oluşturduğunuzda, bu düzendeki yer tutucular yeni slaytta alt şekiller olarak görünür.
Benzer şekilde, ana sayfalardaki yer tutucular da düzenlerin yer tutucularının üst öğeleri olarak davranabilir.
Bu devralma hiyerarşisi tanımlanmışsa alt sayfa, ShapeProperties mesajında bu değeri ayarlamayarak bir özelliği devralır. Alt şekil, üst öğe tarafından tanımlanan değeri geçersiz kılmayarak devralınan değeri kabul eder.
Aşağıdaki şemada, bir slaytta, düzende ve ana slaytta 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 şekillerin çözümlenen değerleri aşağıdaki gibidir:
- Yer tutucu1: A özelliği "Sarı", B özelliği ise "Yeşil" olarak oluşturulur.
- Yer tutucu2: özellikA "Sarı", özellik B ise "Mor" olarak oluşturulur.
- Yer tutucu 3: A özelliği "Sarı", B özelliği ise "Mor" olarak oluşturulur.
Şekiller üst öğeleri olabilecek tek sayfa öğesi türüdür. Resimler, tablolar ve grafikler gibi diğer türler, yer tutucu olamaz ve üst öğeleri içeremez.
PropertyState kullanarak mülkleri "gizleme"
PropertyState sıralaması, bir şeklin özelliğinin gerçekten oluşturma için mi yoksa değerin yalnızca alt şekiller tarafından devralma için mi kullanılacağını kontrol eder. Sayfasındaki şekil oluşturulurken NOT_RENDERED mülk durumuna sahip bir mülk kullanılmaz ancak buna 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 şekillerin çözümlenen değerleri aşağıdaki gibidir:
- Yer tutucu1: özellikA "Kırmızı" olarak oluşturulur.
- Yer tutucu2: mülkA oluşturulmaz. Bu, dış çizgi özelliği olsaydı, Placeholder2'nin dış çizgisi olmazdı.
- Yer tutucu3: mülkA oluşturulmaz.
PropertyState sıralamasının bir başka olası değeri daha vardır: INHERIT özellik durumu, özellik durumunun devralındığı ve üst öğenin değerinin kullanılması gerektiği anlamına gelir. Üst öğesi olmayan şekillerin özellik durumu INHERIT olamaz.