Google Slaytlar API'si slayt oluşturmanızı, taşımanızı ve silmenizi sağlar. Bu sayfadaki örneklerde, presentations.batchUpdate yöntemini kullanan bazı yaygın slayt işlemleri gösterilmektedir.
Bu örneklerde aşağıdaki değişkenler kullanılmaktadır:
- PRESENTATION_ID - Sunu kimliğini nereden sağladığınızı belirtir. Bu kimliğin değerini sunu URL'sinden bulabilirsiniz.
- PAGE_ID ve PAGE_ID2 - Sayfa nesne kimliklerini nereden sağladığınızı belirtir. Bunun değerini URL'den veya API okuma isteği kullanarak alabilirsiniz.
Bu örnekler, dilsiz olması için HTTP istekleri olarak sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme yapmayı öğrenmek için Slayt oluşturma ve Şekil ve metin ekleme kılavuzlarını inceleyin.
Slayt kopyalama
Aşağıdaki presentations.batchUpdate kod örneğinde, bir slaytı kopyalamak ve sunuda orijinalden sonra eklemek için DuplicateObjectRequest yönteminin nasıl kullanılacağı gösterilmektedir.
Orijinal slayt PAGE_ID tarafından belirtilmiştir.
İstek, sayfa öğesi kimliklerinin bir kısmının mı yoksa tümünün kopyada bulunması gerekip gerekmediğini belirtmenizi sağlar (bazı kısıtlamalarla birlikte). Bu örnekte, orijinal slayt, slayt kopyasında (COPY_PAGE_ID ile belirtilir) yeni bir tabloya (COPY_TABLE_ELEMENT_ID ile belirtilir) eşlenmiş bir tablo öğesi (TABLE_ELEMENT_ID ile belirtilir) içerir. 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 Bir öğeyi kopyalama ve düzenleme örneğini inceleyin.
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 ve bunu sunuda dördüncü slayt olarak (sıfır tabanlı insertionIndex kullanarak) eklemek için CreateSlideRequest yönteminin nasıl kullanılacağı 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 belirtebilirsiniz (bazı kısıtlamalarla birlikte) veya istekteki alanı atlayarak API'nin PAGE_ID oluşturmasına izin verebilirsiniz.
Aşağıda, slayt oluşturmak için gereken istek protokolü verilmiştir:
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 kullanılarak 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 özelliğini kullanır. TITLE_ID, değiştirilebilmesi için slaytın yer tutucu şekline referans verir.
Aşağıda bir 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ı alıp göreli sıralamayı koruyarak bunları sununun başlangıcına taşımak için UpdateSlidesPositionRequest yönteminin nasıl kullanılacağı gösterilmektedir.
Belirtilen slayt kimlikleri (PAGE_ID ve PAGE_ID2), yinelemeler olmadan mevcut sunu düzeninde sağlanmalıdır. Sıfır tabanlı insertionIndex, taşıma gerçekleşmeden önceki sıraya göre slaytların nereye ekleneceğini gösterir. Değer, sıfır ile sunumdaki
slayt sayısı arasında olmalıdır.
Aşağıda, slaytları yeni bir konuma taşımak için gereken 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 resmini ayarlama
Aşağıdaki presentations.batchUpdate kod örneğinde, PAGE_ID ile 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.
Alan maskesi, diğer özellikleri korumak için yalnızca slayt arka planının değiştirilmesi gerektiğini belirtmek amacıyla kullanılır. Alan maskelerinin kullanılması performansı da artırır.
Alternatif olarak, bir slaydın arka planını düz bir renge ayarlamak için UpdatePagePropertiesRequest yöntemi kullanılabilir.
Aşağıda, slayt arka plan resmini ayarlamak için kullanılan istek protokolü verilmiştir:
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
Sayfanın küçük resmini içerik URL'si olarak 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.
ThumbnailProperties alanını sorgu parametresi olarak kullanarak döndürülen mimeType ve thumbnailSize değerlerini de belirtebilirsiniz.
Aşağıda, ThumbnailProperties kümesiyle sayfanın küçük resmini oluşturmak için gereken istek protokolü verilmiştir:
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"
}