Google Slaytlar API'si kullanarak bir
PageElement
dahil olmak üzere metin kutuları, resimler, tablolar, temel şekiller, çizgiler
yerleştirilmiş videolar. Bu sayfadaki örneklerde bazı yaygın sayfa öğeleri gösterilmektedir
işlemleri
presentations.batchUpdate
yöntemidir.
Bu örneklerde aşağıdaki değişkenler kullanılmaktadır:
- PRESENTATION_ID: sunum Kimlik. Şunları yapabilirsiniz: bu kimliğe ilişkin değeri sunu URL'sinden alın.
- PAGE_ID - Sayfa nesnesini sağladığınız yeri belirtir Kimlik. Şu bilgileri alabilirsiniz: değerini URL'den veya bir API okuma isteği kullanarak girin.
- PAGE_ELEMENT_ID - Sayfayı sağladığınız yeri belirtir. öğe nesne kimliğini kullanın. Siz oluşturduğunuz öğeler için bu kimliği belirtebilir (belirli bir kısıtlamalar) uymanız gerekir. veya Slides API'nin otomatik olarak kod oluşturmasına izin verin. Öğe Kimlikleri API okuma isteği aracılığıyla alınabilir.
Bu örnekler, dilden bağımsız olarak HTTP istekleri olarak sunulur. Öğrenmek için Google API kullanılarak farklı dillerde toplu güncelleme uygulama aşağıdaki kılavuzlara bakın:
Metin kutusuna madde işaretli liste ekleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
InsertTextRequest
PAGE_ELEMENT_ID. Örnek daha sonra
CreateParagraphBulletsRequest
yöntemini kullanabilirsiniz. Listedeki öğeler
\n karakterle ayrılır, girinti ise \t ile kontrol edilir
karakteri ekleyin.
Aşağıda sunu oluşturmak için kullanılacak istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3",
"insertionIndex": 0
},
"createParagraphBullets": {
"objectId": PAGE_ELEMENT_ID,
"bulletPreset": "BULLET_ARROW_DIAMOND_DISC",
"textRange": {
"type": "ALL"
}
}
}
]
}
Bu istek, aşağıdaki gibi bir madde işaretli liste oluşturabilir:
Slayta şekil ekleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
CreateShapeRequest
yöntemini kullanarak PAGE_ID ile belirtilen bir slayda dalga şekli ekleyebilirsiniz.
Bu istek şekil türünü belirtir, ardından şekli ölçeklendirip konumlandırır
bu slaytta yer alır. Daha sonra
InsertTextRequest
yöntemini kullanabilirsiniz. İstek, satırın kimliğini
PAGE_ELEMENT_ID
Aşağıda, bir slayta şekil eklemek için gereken istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"objectId": PAGE_ELEMENT_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 0.6807,
"scaleY": 0.4585,
"translateX": 6583050,
"translateY": 1673950,
"unit": "EMU"
}
},
"shapeType": "WAVE"
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My Wave Shape",
"insertionIndex": 0
}
}
]
}
Slayta video ekleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
CreateVideoRequest
tarafından belirtilen bir slayda video yerleştirmek için PAGE_ID yöntemini kullanın.
Bu istek, slayttaki videoyu ölçeklendirip konumlandırır ve videonun
Kimliği PAGE_ELEMENT_ID olarak ayarlayın. Kaynak videonun benzersiz tanımlayıcısı:
VIDEO_ID olarak ayarlandı. Örneğin,
https://www.youtube.com/watch?v=7U3axjORYZ0
7U3axjORYZ0 kimliğine sahip.
Slayta video eklemek için gereken istek protokolü aşağıda verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createVideo": {
"objectId": PAGE_ELEMENT_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 12000,
"unit": "EMU"
},
"height": {
"magnitude": 9000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 381,
"scaleY": 381,
"translateX": 152400,
"translateY": 152400,
"unit": "EMU"
}
},
"source": "YOUTUBE",
"id": VIDEO_ID
}
}
]
}
Öğeleri kopyalama ve düzenleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
DuplicateObjectRequest
yöntemini kullanarak (
PAGE_ELEMENT_ID) ve dosyanın kopyasını oluşturun (
COPY_ELEMENT_ID) tıklayın.
Sonraki istekler, kopya nesnede aşağıdaki değişiklikleri yapar:
- Arka plan rengini
LIGHT2tema rengine ayarlar. - Kopyayı sayfanın aşağısına taşır (orijinal şeklin konumundan).
- Metin yazı tipini 18 pt Georgia olarak ayarlar.
- Metni "Şekil Kopyam" olarak okuyacak şekilde düzenler.
Buradaki istekler, verileri korumak için alan maskelerini değiştirilmeyen şekil özellikleri (anahat stili gibi). Kullanım alan maskeleri de performansı artırır.
Slayt kopyalama hakkında daha fazla bilgi için bkz. Bir slayt'ı tıklayın.
Aşağıda, bir öğeyi kopyalamak ve düzenlemek için kullanılan istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ELEMENT_ID,
"objectIds": {
PAGE_ELEMENT_ID: COPY_ELEMENT_ID
}
}
},
{
"updateShapeProperties": {
"objectId": COPY_ELEMENT_ID,
"fields": "shapeBackgroundFill.solidFill.color",
"shapeProperties": {
"shapeBackgroundFill": {
"solidFill": {
"color": {
"themeColor": "LIGHT2"
}
}
}
}
}
},
{
"updatePageElementTransform": {
"objectId": COPY_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 0,
"translateY": 1250000,
"unit": "EMU"
}
}
},
{
"updateTextStyle": {
"objectId": COPY_ELEMENT_ID,
"fields": "fontFamily,fontSize",
"textRange": {
"type": "ALL"
},
"style": {
"fontFamily": "Georgia",
"fontSize": {
"magnitude": 18,
"unit": "PT"
}
}
}
},
{
"deleteText": {
"objectId": COPY_ELEMENT_ID,
"textRange": {
"type": "ALL"
}
}
},
{
"insertText": {
"objectId": COPY_ELEMENT_ID,
"text": "My Shape Copy",
"insertionIndex": 0
}
}
]
}
Bu güncellemelerden sonra şeklin ve kopyasının nasıl görünebileceği aşağıda gösterilmektedir:
Resim veya videonun ana hatlarını düzenleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
UpdateImagePropertiesRequest
yönteminde belirtilen bir resmin dış çizgi görünümünü
IMAGE_ELEMENT_ID. Ayrıca
UpdateVideoPropertiesRequest
yerleştirilmiş bir videonun dış çizgi görünümünü güncellemek için
VIDEO_ELEMENT_ID.
İstekler, nesnede aşağıdaki değişiklikleri yapar:
- Resmin ana hatlarını, kısmi renkteki
ACCENT5tema rengine ayarlar şeffaflık. - Videonun ana hatlarını "Hayır" ile
ACCENT1tema rengi olarak ayarlar şeffaflık. - Dış çizgi ağırlıklarını her ikisi için de 3 nk olarak ayarlar.
- Görsel anahat stilini
SOLIDolarak ayarlar. - Videonun dış çizgi stilini
DASH_DOTolarak ayarlar.
Hem UpdateImagePropertiesRequest yöntemi hem de
UpdateVideoPropertiesRequest yöntemi yalnızca resmin görünümünü değiştirebilir
ve video özetleri. Diğer tüm özellikler salt okunurdur. Buradaki istekler,
alan maskelerini kullanarak yalnızca ana hatların
değiştirilmesi gerektiğini unutmayın. Alan kullanılıyor
performansı da artırır.
Aşağıda, bir resmin veya videonun ana hatlarını düzenlemek için kullanılan istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateImageProperties": {
"objectId": IMAGE_ELEMENT_ID,
"fields": "outline",
"imageProperties": {
"outline": {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 0.8,
"color": {
"themeColor": "ACCENT5"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
},
{
"updateVideoProperties": {
"objectId": VIDEO_ELEMENT_ID,
"fields": "outline",
"videoProperties": {
"outline": {
"dashStyle": "DASH_DOT",
"outlineFill": {
"solidFill": {
"alpha": 0.8,
"color": {
"themeColor": "ACCENT1"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
}
]
}
Bu güncellemelerden sonra resmin ve yerleştirilmiş videonun nasıl görünebileceği aşağıda gösterilmektedir:
Şeklin ana hatlarını düzenleme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
UpdateShapePropertiesRequest
yöntemini kullanarak (
PAGE_ELEMENT_ID) ve dış çizgisinin görünümünü günceller.
İstekler, nesnede aşağıdaki değişiklikleri yapar:
- Dış çizgi rengini, kısmi
ACCENT5tema rengi olarak ayarlar şeffaflık. - Dış çizgi ağırlığını 3 nk. olarak ayarlar.
- Dış çizgi stilini
LONG_DASHolarak ayarlar.
Buradaki istekler, verileri korumak için alan maskelerini değiştirilmeyen şekil özellikleri (şekil dolgu rengi gibi). Kullanım alan maskeleri de performansı artırır.
Aşağıda, bir şeklin ana hatlarını düzenlemek için kullanılabilecek istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateShapeProperties": {
"objectId": PAGE_ELEMENT_ID,
"fields": "outline",
"shapeProperties": {
"outline": {
"dashStyle": "LONG_DASH",
"outlineFill": {
"solidFill": {
"alpha": 0.6,
"color": {
"themeColor": "ACCENT5"
}
}
},
"weight": {
"magnitude": 3,
"unit": "PT"
}
}
}
}
}
]
}
Bu güncellemelerden sonra şekiller şu şekilde görünebilir:
Şekil veya metin kutusundaki metni biçimlendirme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
UpdateTextStyleRequest
yöntemini kullanarak (
PAGE_ELEMENT_ID) ve metninin görünümünü günceller.
İstekler, nesnede aşağıdaki değişiklikleri yapar:
- Metin rengini
ACCENT5tema rengine ayarlar. - Yazı tipini kalın, italik 18 punto Corsiva olacak şekilde ayarlar.
- Metnin altını çizer.
Buradaki istekler, verileri korumak için alan maskelerini değiştirilmeyen metin stili özellikleri (örneğin, arka plan rengi, bağlantıları veya referans değer ofsetleri) görebilirsiniz. Alan maskelerinin kullanılması performansı da artırır.
Aşağıda, şekil veya metin kutusundaki metni biçimlendirmek için kullanılan istek protokolü verilmiştir:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateTextStyle": {
"objectId": PAGE_ELEMENT_ID,
"fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline",
"style": {
"foregroundColor": {
"opaqueColor": {
"themeColor": "ACCENT5"
}
},
"bold": true,
"italic": true,
"underline": true,
"fontFamily": "Corsiva",
"fontSize": {
"magnitude": 18,
"unit": "PT"
}
},
"textRange": {
"type": "ALL"
}
}
}
]
}
Bu güncellemelerden sonra şekil metni şu şekilde görünebilir:
Google E-Tablolar'dan grafik içe aktarma
Aşağıdakiler
presentations.batchUpdate
kod örneği,
CreateSheetsChartRequest
yöntemini kullanarak bir sayfadaki grafiği içe aktarabilir ve
PAGE_ID.
İstek, SPREADSHEET_ID) ve e-tablo grafik kimliğini ( SPREADSHEET_CHART_ID) tıklayın. Slaytlar sunusu PRESENTATION_CHART_ID.
İstek ayrıca
LinkingMode
güncelleyebilmeniz için Slaytlar grafiğini LINKED olarak güncelleyin.
yerleştirilmiş grafikteki
grafik seçeneğini kullanabilirsiniz.
Aşağıda, E-Tablolar:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSheetsChart": {
"objectId": PRESENTATION_CHART_ID,
"spreadsheetId": SPREADSHEET_ID,
"chartId": SPREADSHEET_CHART_ID,
"linkingMode": "LINKED",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 4000000,
"unit": "EMU"
},
"height": {
"magnitude": 4000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 100000,
"translateY": 100000,
"unit": "EMU"
}
}
}
]
}
Bir grafiği E-Tablolar'dan yenileme
Aşağıdakiler
presentations.batchUpdate
kod örneği,
RefreshSheetsChartRequest
bir sunudaki bağlantılı grafiği yenilemek ve bunu en son gösterimle değiştirmek için
bu grafiğin E-Tablolar kaynak e-tablosundan gönderilir. İlgili içeriği oluşturmak için kullanılan
Slaytlar sunusunda grafik kimliği gerekir
(PRESENTATION_CHART_ID tarafından belirtilir).
Aşağıda, grafik yenilenecek istek protokolü verilmiştir: E-Tablolar:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"refreshSheetsChart": {
"objectId": PRESENTATION_CHART_ID
}
}
]
}