Google Slaytlar API'si ile slayt oluşturabilir, taşıyabilir ve silebilirsiniz. Bu sayfadaki örnekler, presentations.batchUpdate yöntemini kullanan bazı yaygın slayt işlemlerini göstermektedir.
Bu örneklerde aşağıdaki değişkenler kullanılmaktadır:
- PRESENTATION_ID: Sunu kimliğini sağladığınız yeri belirtir. Bu kimliğin değerini sunu URL'sinden bulabilirsiniz.
- PAGE_ID ve PAGE_ID2: Sayfa nesne kimliklerini nerede sağladığınızı gösterir. Bunun değerini URL'den veya API okuma isteği kullanarak alabilirsiniz.
Bu örnekler, dilden bağımsız olarak HTTP istekleri olarak sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme yapmayı öğrenmek için şu kılavuzları inceleyin: Slayt oluşturma ve Şekil ve metin ekleme.
Slayt kopyalama
Aşağıdaki presentations.batchUpdate kod örneğinde, bir slaytı kopyalamak ve sunumda orijinalin arkasına eklemek için DuplicateObjectRequest yönteminin nasıl kullanılacağı gösterilmektedir.
Orijinal slayt PAGE_ID tarafından belirlenir.
İstek, sayfa öğesi kimliklerinin bir kısmının mı yoksa tamamının kopyada mı yer alacağını belirtmenizi sağlar (bazı kısıtlamalarla). Bu örnekte, orijinal slayt, slayt kopyasındaki (COPY_PAGE_ID ile belirtilir) yeni bir tabloya (COPY_TABLE_ELEMENT_ID ile belirtilir) eşlenmiş bir tablo öğesi (TABLE_ELEMENT_ID ile belirtilir). Kopyadaki diğer tüm öğelere rastgele kimlikler verilir.
Metin kutuları, resimler, tablolar, temel şekiller, çizgiler ve yerleştirilmiş videolar dahil olmak üzere PageElement öğelerini kopyalama hakkında daha fazla bilgi için Öğe kopyalama ve düzenleme örneğine bakın.
Aşağıda bir slaytın kopyalanması için gereken istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}
Slayt oluştur:
Aşağıdaki presentations.batchUpdate kod örneğinde, slayt oluşturmak için CreateSlideRequest yönteminin nasıl kullanılacağı ve sıfır tabanlıinsertionIndex kullanılarak sunuda dördüncü slayt olarak nasıl ekleneceği gösterilmektedir.
Yeni slayt, TITLE_AND_TWO_COLUMNS öğesinin PredefinedLayout değerini kullanacak şekilde ayarlandı. Slayt için PAGE_ID olarak kullanılacak bir dize belirtebilir (bazı kısıtlamalarla birlikte) veya istekteki alanı atlayarak API'nin PAGE_ID öğesini oluşturmasına izin verebilirsiniz.
Slayt oluşturmak için kullanılacak istek protokolü şöyledir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
Slayt oluşturma ve yer tutucuları değiştirme
Aşağıdaki presentations.batchUpdate kod örneğinde, TITLE_AND_TWO_COLUMNS PredefinedLayout ile slayt oluşturmak için CreateSlideRequest yönteminin nasıl kullanılacağı gösterilmektedir.
Slayt için PAGE_ID olarak kullanılacak bir dize belirtebilirsiniz (bazı kısıtlamalar vardır).
placeholderIdMappings, TITLE öğesinin Type değerini kullanır. TITLE_ID, değiştirilebilmesi için slaytın yer tutucu şekline referans verir.
Aşağıda, slayt oluşturmak ve yer tutucuları değiştirmek için kullanılan istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": PAGE_ID,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": TITLE_ID,
},
],
}
},
{
"insertText": {
"objectId": TITLE_ID,
"text": "This is my slide title",
}
},
]
}
Slaytları yeni bir konuma taşıma
Aşağıdaki presentations.batchUpdate kod örneğinde, belirtilen iki slaytı almak ve göreceli sıralarını koruyarak bunları sunumun başına taşımak için UpdateSlidesPositionRequest yönteminin nasıl kullanılacağı gösterilmektedir.
Belirtilen slayt kimlikleri (PAGE_ID ve PAGE_ID2), mevcut sunu sırasında yinelenenler olmadan sağlanmalıdır. Sıfır tabanlı insertionIndex, taşıma gerçekleşmeden önceki sıraya göre slaytların nereye eklenmesi gerektiğini belirtir. Değer, sıfır ile sunumdaki slayt sayısı arasında (bu değerler dahil) olmalıdır.
Aşağıda, slaytları yeni bir konuma taşımak için kullanılan istek protokolü bulunmaktadır:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
Slayt arka plan resmi ayarla
Aşağıdaki presentations.batchUpdate kod örneğinde, PAGE_ID tarafından belirtilen bir slaytın arka plan resmini ayarlamak için UpdatePagePropertiesRequest yönteminin nasıl kullanılacağı gösterilmektedir. API, görüntüyü IMAGE_URL kullanarak alır.
Diğer özellikleri korumak için yalnızca slayt arka planının değiştirilmesini belirtmek amacıyla alan maskesi kullanılır. Alan maskelerinin kullanılması da performansı artırır.
Alternatif olarak, bir slaytın arka planını düz renge ayarlamak için
bir UpdatePagePropertiesRequest yöntemi kullanılabilir.
Aşağıda, slayt arka plan resmi ayarlamaya yönelik istek protokolü bulunmaktadır:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}
Küçük resim oluştur
İçerik URL'si olarak sayfanın küçük resmini döndüren presentations.pages.getThumbnail yöntemini çağırarak sunudaki belirli bir sayfanın en son sürümünün küçük resmini oluşturabilirsiniz. Resim URL'sinin varsayılan ömrü 30 dakikadır.
Sorgu parametresi olarak ThumbnailProperties alanını kullanarak döndürülen mimeType ve thumbnailSize değerlerini de belirtebilirsiniz.
Aşağıda, ThumbnailProperties grubuyla sayfanın küçük resmini oluşturmak için kullanılan istek protokolü bulunmaktadır:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}