Giriş

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 veri tabanındaki müşteri ayrıntılarını kullanarak 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 ile değiştirilmiştir.
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.

Slaytlar ile çalışma: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Sayfa öğeleriyle çalışma: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Tablolarla Çalışma: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Grafiklerle Çalışma: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Resimler ve Videolarla Çalışma: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Metinle çalışma: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

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().