Bu sayfada, Google E-Tablolar'daki mevcut grafikleri alıp Google Slaytlar sunularına ekleme işlemi açıklanmaktadır.
Sunuya grafik eklemek, daha fazla etki yaratmanıza ve verileri kitleniz için anlamlı hale getirmenize yardımcı olabilir. Grafikler, bir veri kümesindeki kalıpları veya trendleri göstermek için benzersiz derecede güçlü araçlardır ve nicel veriler hakkında net bir şekilde iletişim kurmanıza yardımcı olabilir.
Yukarıdaki videoda, e-tablo verilerinden nasıl slayt oluşturulacağı açıklanmaktadır. Bu örnekte, slayda grafik ekleyen ve e-tablo hücre verilerini tabloya aktaran eksiksiz bir örnek (Python) yer almaktadır.
Grafik ekleme hakkında
Nicel bilgiler sunarken veri grafikleri sununuzu zenginleştirebilir. Slaytlar API'si, Google E-Tablolar'da oluşturabileceğiniz tüm grafikleri (çubuk grafikler, çizgi grafikler, pasta grafikler ve daha fazlası) eklemenize olanak tanır.
Yukarıdaki şemada gösterildiği gibi, önce Google E-Tablolar'da grafiği oluşturmanız gerekir. Grafik oluşturulduktan sonra sununuza yerleştirebilirsiniz.
Sununuzdaki grafikleri yönetmeyle ilgili genel süreç şöyledir:
- Google E-Tablolar'da bir grafik oluşturun.
- Sonuçtaki EmbeddedChart'ın grafik kimliğini okumak için Sheets API'yi kullanın.
- Slayda eklemek için CreateSheetsChartRequest'i bir kez kullanın.
- Kaynak verilerle senkronize etmek için gerektiğinde RefreshSheetsChartRequest'i kullanın.
Statik ve bağlı grafikler
Sununuza grafik eklemek için API'yi kullandığınızda belirttiğiniz parametrelerden biri LinkingMode olur. Bu ayar, grafiğin statik bir resim olarak mı yoksa gelecekte yenilenebilecek bir nesne olarak mı ekleneceğini belirler.
Aşağıdaki durumlarda LINKED
modunu kullanın:
- İleride grafiği yenileyerek temel verilerdeki değişiklikleri yansıtmak istiyorsanız.
- Ortak çalışanların kaynak grafiği içeren e-tablonun bağlantısına sahip olmasını istiyorsanız.
Şu durumlarda NOT_LINKED_IMAGE
(statik) modu kullanın:
- Grafiğin gelecekte hiçbir zaman değişmemesini istiyorsanız.
- Ortak çalışanların kaynak e-tablonun bağlantısını görmesini istemiyorsanız.
Google E-Tablolar'a erişim kapsamları
Slaytınıza grafik eklediğinizde Slaytlar API'sinin bu grafiğe Google E-Tablolar'da erişmesi gerekir. Bu nedenle, isteğinizde aşağıdaki kapsamlar kullanılmalıdır:
https://www.googleapis.com/auth/spreadsheets.readonly
(tercih edilen)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
En kısıtlayıcı kapsam olduğundan genellikle spreadsheets.readonly
kapsamı en iyi seçenektir. Ancak uygulamanız yukarıda listelenen diğer kapsamların birini zaten kullanıyorsa yalnızca bu kapsamı kullanın.
Grafik ekleme
Grafik eklemek için Google E-Tablolar'daki grafiğin e-tablo kimliğini ve grafik kimliğini bilmeniz gerekir. Ardından, batchUpdate
yöntemini çağırarak grafiği eklemek için CreateSheetsChartRequest'i bir kez kullanırsınız.
Aşağıdaki örnekte, bir grafik alınarak LINKED
olarak bir slayda ekleniyor. Böylece grafik daha sonra yenilenebiliyor.
Apps Komut Dosyası
Go
Java
JavaScript
Node.js
PHP
Python
Ruby
Grafiği yenileme
Sununuza LINKED
grafik yerleştirdiyseniz RefreshSheetsChartRequest kullanarak grafiği istediğiniz zaman yenileyebilirsiniz.
Bu işlem, grafiği temel alınan E-Tablolar grafiği ve verileriyle senkronize edecek şekilde günceller.
Aşağıdaki örnekte mevcut bir grafik yenilenmektedir: