Google Slaytlar API'si, Google Slaytlar sunularını oluşturmanıza ve değiştirmenize olanak tanır.
Uygulamalar göz alıcı slaytlar oluşturmak için Google Slaytlar API'sı ile entegre edilebilir. kullanıcı ve sistem tarafından sağlanan verilerden otomatik olarak oluşturulur. Örneğin herkesin bir veritabanındaki müşteri ayrıntılarını kullanmak ve bunları önceden tasarlanmış tamamlanmış sunular oluşturmak için şablonlar ve belirlenen yapılandırma seçenekleri çok daha kısa sürede oluşturulur.
API'ye genel bakış
sunular koleksiyonu, Bu yöntemleri kullanarak sunudaki öğeleri alabilir ve güncelleyebilirsiniz.
Slaytlar API'si ile yaptığınız çoğu çalışma büyük olasılıkla "yeni" kullanıcılar için en iyi uygulamaları paylaşacağız. Bunu yapmak için batchUpdate yöntemi; bu yöntemde projenin İstek gönder yapmanızı sağlayan nesneler:
- 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. Başlangıç kılavuzlarına göz atın .
Sunumun yapısı
Slaytlar API'sinde bir sunu, içinde sayfa içeren sayfalardan oluşur. öğeler.
Sununun kimliği URL'den elde edilebilir:
https://docs.google.com/presentation/d/presentationId/edit
Sunu kimliği harfler, sayılar ve bazı özel karakteri ekleyin. Aşağıdaki normal ifade, Google E-Tablolar URL'sinden sunu kimliği:
/presentation/d/([a-zA-Z0-9-_]+)
Drive API hakkında bilginiz varsa presentationId,
Dosyanın Kimliği
gösterir.
Sayfalar ve sayfa öğeleri, nesne kimlikleriyle tanımlanır.
Pages
Google Slaytlar'da aşağıdaki türden sayfalar bulunur:
| Yüksek lisans | Ana slaytlar varsayılan metin stillerini, arka planı ve sayfayı tanımlar tüm slaytlarda görünen öğeleri içine alır. Sayfa tüm slaytlarda görünmesi gereken öğeler ana slayta eklenmelidir. En sık sunuların tek bir ana ustası vardır, ancak bazılarında birden çok ana örnek bulunabilir veya hiç olmayabilir. |
| Düzenler | Düzenler, sayfa öğelerinin slaytlarda varsayılan olarak bir düzen kullanır. Her düzen bir ana. |
| 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. Her bir feed'de her slayt için kullanılacak düzenek belirleyin. |
| Notlar | Bu sayfalarda, aşağıda belirtilenler de dahil olmak üzere sunu notları için içerikler yer almaktadır: slayttaki konuşmacı notlarını içeren bir şekil olarak gösterilir. Her slaytta bir tane var ilgili notlar sayfasını ziyaret edin. Yalnızca konuşmacı notları şeklindeki metin Slaytlar API ile değiştirilmiş. |
| Notlar ana metinleri | Notlar ana dosyaları, tümü için varsayılan metin stillerini ve sayfa öğelerini tanımlar not sayfalarıdır. Notlar ana slaytları, Slaytlar API'sinde salt okunurdur. |
Sayfa öğeleri
Sayfa öğeleri, sayfalara yerleştirilen görsel bileşenlerdir. API çeşitli sayfa öğesi türlerini gösterir:
| Grup | Ayrı bir birim olarak kabul edilen bir sayfa öğeleri grubu. Şunları yapabilirler: hareket edebilir, ö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 oluşturmak için en yaygın sayfa öğeleridir slaytlarda yer alır. |
| 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üncellemenize olanak tanır. Değişiklikler şurada gruplandırılır: bir istek grubu oluşturur; böylece bir istek başarısız olursa diğerinin hiçbiri (potansiyel olarak bağımlıdır) nasıl yazıldığını öğrendiniz.
batchUpdate yöntemi, bir veya daha fazla maddeyi dikkate alarak çalışır.
İstek
nesnelerinden her biri, gerçekleştirilecek tek bir istek türünü belirtir. Her biri 100'den az gösterim alan
talep edebilirsiniz. İstek türlerinin dökümü,
grup halinde gruplandırılır.
batchUpdate yöntemi bir yanıt gövdesi döndürür.
içeren bir
Yanıt
tıklayın. Her yanıt, karşılık gelen
talep; geçerli olmayan istekler için söz konusu dizindeki yanıt
boş görünür. Çeşitli Create isteklerinin normalde yanıtlanması gerekir. Bu nedenle
yeni eklenen nesnenin kimliğini bildiğinizden emin olun.
Nesne kimlikleriyle çalışma
Slaytlar API'sindeki sunular sayfalardan ve sayfa öğelerinden oluşur. Bu nesneler, en iyi uygulamaları paylaşacağız.
Oluşturma sırasında nesne kimliklerini belirtme
Sayfa veya sayfa öğeleri oluştururken batchUpdate yöntemini kullanıyorsanız, isteğe bağlı olarak yeni nesne için bir nesne kimliği belirtebilirsiniz. Bu özellik, feed'de nesne sayısını en aza indirecek şekilde aynıBatchUpdate isteği içinde çağrılarının sayısını ve kota kullanımını azaltmayı amaçlamaktadır.
Ç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ışır.)
Uygulamanız, nesneleri uzun bir süre boyunca takip etmek istediğinde değişebileceği için nesne kimliğine güvenmeyin. Aşağıdakilere göz atın bölümüne bakın.
Nesne kimliğini kullanmadan nesneleri takip etme
Bir Slaytlar API'si isteğinde bulunduğunuzda nesne kimliği normalde korunur. (Tümü yöntemin referans belgelerinde istisnalara yer verilmiştir.) Bu videoda Drive API ile tüm sununun kopyası da nesne kimliklerini korur.
Bununla birlikte, nesne kimliğinin sunumdan sonra değişmeden kalmasını sağlayamazsınız. Slaytlar kullanıcı arayüzünde değiştiriliyor. Örneğin, bir kullanıcı Slaytlar'ı Bir sayfa öğesini kopyalayıp yapıştırdıktan sonra orijinal öğeyi, sayfa öğesini silen kullanıcı arayüzü artık yeni bir benzersiz kimliğe ve API aracılığıyla daha önce sağladığınız kimliğe sahip olacak kaybolacak. Sonuç olarak, nesne kimliklerini depolama alanıdır. Bunun yerine sunumdaki nesneleri metin içeriğini veya alternatif metnini.
Yeni oluşturulan sunularda varsayılan olarak normalde tutarlı bir kimlik grubu kullanılır slaytlar, ana metinler ve metin kutuları yer alır. Bu kimlikler zaman içinde değişebilir. bu nedenle bu özelliği kullanmanız önerilmez. Bunun yerine çağrılarının döndürdüğü sunu nesnesini kullanarak değiştirmek istediğiniz create() veya get().