Google Slaytlar API'si, Google Slaytlar sunularını oluşturmanıza ve değiştirmenize olanak tanır.
Uygulamalar Google Slaytlar API ile entegre olarak kullanıcı ve sistem tarafından sağlanan verilerden otomatik olarak etkileyici slaytlar oluşturabilir. Örneğin, bir veritabanındaki müşteri ayrıntılarını kullanabilir ve bunları önceden tasarlanmış şablonlarla ve belirlenen yapılandırma seçenekleriyle birleştirerek, manuel olarak çok kısa sürede tamamlanmış sunular oluşturabilirsiniz.
API'ye genel bakış
sunular koleksiyonu, sunudaki öğeleri alıp güncellemenize olanak tanıyan yöntemler sunar.
Slaytlar API'si ile yaptığınız işlerin çoğu büyük olasılıkla sunu oluşturur ve günceller. Bu işlemi batchUpdate yöntemini kullanarak yapabilirsiniz. Bu yöntem, aşağıdakiler gibi işlemler yapmanıza olanak tanıyan Request nesnelerinin bir listesini alır:
- Slayt oluştur
- Slaytlara şekil veya tablo gibi öğeler ekleme
- Metin ekleme, değiştirme ve kaldırma
- Dönüşümleri öğelere uygulama
- Slaytların sırasını değiştirme
Daha fazla ayrıntı için Toplu güncellemeler başlıklı makaleye bakın. API'nin nasıl kullanılacağıyla ilgili basit bir uçtan uca örnek için Başlangıç kılavuzlarına göz atın.
Sunumun yapısı
Slaytlar API'sindeki sunular sayfa öğeleri içeren sayfalardan oluşur.
Sununun kimliği URL'den elde edilebilir:
https://docs.google.com/presentation/d/presentationId/edit
Sunu kimliği harfler, sayılar ve bazı özel karakterler içeren bir dizedir. Aşağıdaki normal ifade, bir Google E-Tablolar URL'sinden sunu kimliğini ayıklamak için kullanılabilir:
/presentation/d/([a-zA-Z0-9-_]+)
Drive API hakkında bilgi sahibiyseniz presentationId
, Dosya kaynağının kimliğine karşılık gelir.
Sayfalar ve sayfa öğeleri, nesne kimlikleriyle tanımlanır.
Pages
Google Slaytlar'da aşağıdaki türden sayfalar bulunur:
Yüksek lisans | Ana slayt reklamları, bu ana slaytı kullanan tüm slaytlarda görünen varsayılan metin stillerini, arka planı ve sayfa öğelerini tanımlar. Tüm slaytlarda görünmesi gereken sayfa öğeleri ana slayta eklenmelidir. Çoğu sununun bir ana ustası vardır, ancak bazılarında birkaç ana örnek bulunabilir veya hiç olmayabilir. |
Düzenler | Düzenler, sayfa öğelerinin bir düzen kullanılarak slaytlarda varsayılan olarak nasıl düzenleneceğine dair bir şablon görevi görür. Her düzen, bir ana kopyayla ilişkilendirilir. |
Slaytlar | Bu sayfalar, kitlenize sunduğunuz içeriği barındırır. Çoğu slayt bir ana slayta ve bir düzene dayalıdır. Oluşturulduğunda her bir slayt için hangi düzenin kullanılacağını belirtebilirsiniz. |
Notlar | Bu sayfalarda, slayttaki konuşmacı notlarını içeren bir şekil de dahil olmak üzere sunu notları için içerikler yer alıyor. Her slayta karşılık gelen bir notlar sayfası vardır. Slaytlar API'siyle yalnızca konuşmacı notları şeklindeki metin değiştirilebilir. |
Notlar ana metinleri | Notlar ana dosyaları, tüm not sayfaları için varsayılan metin stillerini ve sayfa öğelerini tanımlar. Notlar ana slaytları, Slaytlar API'sinde salt okunurdur. |
Sayfa öğeleri
Sayfa öğeleri, sayfalara yerleştirilen görsel bileşenlerdir. API çeşitli türlerde sayfa öğeleri sunar:
Grup | Ayrı bir birim olarak kabul edilen bir sayfa öğeleri grubu. Bunlar birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilir. |
Şekil | Dikdörtgen, üç nokta ve metin kutusu gibi düz bir görsel nesne. Şekiller metin içerebilir. Bu nedenle şekiller slayt oluşturmak için en çok kullanılan sayfa öğeleridir. |
Resim | Bir grafik Slaytlar'a aktarıldı. |
Video | Video Slaytlar'a aktarıldı. |
Çizgi | Görsel bir çizgi, eğri veya bağlayıcı. |
Tablo | İçerik ızgarası. |
WordArt | Daha çok bir şekle benzer davranış gösteren bir görsel metin öğesi. |
SheetsChart | Google E-Tablolar'dan Slaytlar'a aktarılan bir grafik. |
Toplu güncellemeler
batchUpdate yöntemi, bir sununun birçok özelliğini güncellemenizi sağlar. Değişiklikler bir toplu halde gruplandırılır. Böylece, bir istek başarısız olursa diğer (potansiyel olarak bağımlı) değişikliklerin hiçbiri yazılmaz.
batchUpdate
yöntemi, her biri gerçekleştirilecek tek bir istek türünü belirten bir veya daha fazla Request nesnesi alarak çalışır. Birçok farklı
istek türü vardır. Talep türlerinin farklı kategorilere göre
gruplandırılmış bir dökümü aşağıda verilmiştir.
batchUpdate
yöntemi, her istek için bir Yanıt içeren yanıt gövdesi döndürür. Her yanıt, karşılık gelen istekle aynı dizini işler. Geçerli yanıtı olmayan istekler için o dizindeki yanıt boş olur. Çeşitli Create
istekleri normalde yanıt içerir, böylece yeni eklenen nesnenin kimliğini bilirsiniz.
Nesne kimlikleriyle çalışma
Slaytlar API'sindeki sunular sayfalardan ve sayfa öğelerinden oluşur. Bu nesneler, bir sunuda benzersiz olan bir object ID dizesi içerir.
Oluşturma sırasında nesne kimliklerini belirtme
batchUpdate yöntemini kullanarak sayfaları veya sayfa öğeleri oluştururken isteğe bağlı olarak yeni nesne için bir nesne kimliği belirtebilirsiniz. Bu, bir nesne oluşturup aynı toplu güncelleme isteği içinde değiştirmenize olanak tanır. Böylece Slaytlar API'ye yapılan çağrı sayısını en aza indirir ve kota kullanımını azaltabilirsiniz.
Çoğu durumda rastgele bir nesne kimliği oluşturmanızı öneririz. Örneğin, Java kullanıyorsanız java.util.UUID.randomUUID().toString()
düzgün çalışacaktır.
Uygulamanız nesneleri daha uzun bir süre boyunca takip etmek istediğinde nesne kimliğine güvenmeyin, çünkü değişebilir. Daha fazla bilgi için aşağıdaki bölüme bakın.
Nesne kimliğini kullanmadan nesneleri takip etme
Bir Slaytlar API'si isteğinde bulunduğunuzda nesne kimliği normalde korunur. (İstisnalar, yöntemin referans belgelerinde belirtilmiştir.) Drive API ile tüm sununun kopyasını oluşturduğunuzda nesne kimlikleri de korunur.
Bununla birlikte, Slaytlar kullanıcı arayüzünde bir sunu değiştirildikten sonra nesne kimliğinin değiştirilmesini zorunlu kılamazsınız. Örneğin, kullanıcı bir sayfa öğesini kopyalayıp yapıştırmak için Slaytlar kullanıcı arayüzünü kullanır ve ardından orijinali silerse sayfa öğesi artık yeni bir benzersiz kimliğe sahip olur ve API aracılığıyla daha önce sağladığınız kimlik kaybolur. Bu nedenle, nesne kimliklerini uygulamanızın depolama alanında depolamanızı önermeyiz. Bunun yerine, sunudaki nesneleri metin içeriğine veya alternatif metinlerine göre bulmalısınız.
Yeni oluşturulan sunularda normalde varsayılan slaytlar, ana slaytlar ve metin kutuları için tutarlı bir kimlik grubu kullanılır. Bu kimlikler zaman içinde değişebileceği için bu özelliği kullanmanız önerilmez. Bunun yerine, create() veya get() çağrılarının döndürdüğü sunu nesnesini kullanarak değiştirmek istediğiniz öğeleri bulun.