Google Slaytlar API'sı sunu, sayfa ve sayfa öğesi verilerini okumanıza olanak tanır. Bu sayfadaki örneklerde, hem presentations.get hem de presentations.pages.get yöntemleri kullanılarak genel okuma işlemlerinin nasıl gerçekleştirileceği gösterilmektedir.
Bu örneklerde aşağıdaki yer tutucular 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 - Sayfa nesne kimliğini nereden sağladığınızı belirtir. Bunun değerini URL'den veya bir API okuma isteği kullanarak alabilirsiniz.
Bu örnekler, dilden bağımsız olmaları için HTTP istekleri olarak sunulur. Örnekler, PRESENTATION_ID değeri 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc olan bu örnek sunudan okunmuştur. Bu sunumdaki ilk slaytın PAGE_ID: ge63a4b4_1_0.
Buradaki örneklerde yalnızca sunum, slayt ve sayfa öğesi hakkında istenen belirli bilgileri döndürmek için alan maskeleri kullanılmaktadır. Alan maskeleri kullanmak performansı da artırır.
Slayt nesne kimliklerini okuma
Aşağıdaki presentations.get kod örneğinde, sunudan tüm slayt nesnesi kimliklerinin bir listesinin nasıl alınacağı gösterilmektedir. Kimlikler slayt sunumu sırasında döndürülür ve sonraki API isteklerinde belirli slaytları belirtmek için kullanılabilir. Ana sayfaların ve düzen sayfalarının nesne kimliklerini fields=masters.objectId ve fields=layout.objectId kullanarak aynı şekilde alabilirsiniz.
Aşağıda, slayt nesnesi kimliklerini okumak için gereken istek protokolü verilmiştir:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
Yanıt, istenen nesne kimliklerini içeren bir Presentation nesnesinden oluşur:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Bir sayfadan öğe nesne kimliklerini okuma
Aşağıdaki presentations.pages.get kod örneğinde, bir sayfadaki tüm sayfa öğeleri için nesne kimlikleri listesinin nasıl alınacağı gösterilmektedir.
Aşağıda, bir sayfadan öğe nesne kimliklerini okumak için istek protokolü verilmiştir:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
Yanıt, istenen nesne kimliklerini içeren bir Page nesnesinden oluşur:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Bir sayfadaki şekil öğelerini okuma
Aşağıdaki presentations.pages.get kod örneğinde, bir sayfadaki tüm Shapes listelerinin nasıl alınacağı gösterilmektedir. Diğer PageElement türlerini fields parametresiyle belirterek alabilirsiniz. Örneğin, fields=pageElements(line,table), sayfada varsa yalnızca line ve table sayfa öğeleri ile ilgili bilgileri döndürür.
Aşağıda, bir sayfadaki şekil öğelerini okumak için kullanılan istek protokolü verilmiştir:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
Yanıt, istenen şekil öğelerini içeren bir Page nesnesinden oluşur. Boş kaşlı ayraçlar, şekil türünde olmayan sayfa öğelerini belirtir. Bu örnekte, bunlar resim sayfası öğeleridir.
{
"pageElements": [
{},
{},
{
"shape": {
"shapeProperties" {
"outline" {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 1,
"color": {
"rgbColor": {}
}
},
},
"propertyState": "NOT_RENDERED",
"weight": {
"magnitude": 9525,
"unit": "EMU"
}
},
"shadow": {
"alignment": "BOTTOM_LEFT",
"alpha": 1,
"blurRadius": {
"unit": "EMU"
},
"color": {
"rgbColor": {}
},
"propertyState": "NOT_RENDERED",
"rotateWithShape": false,
"transform": {
"scaleX": 1,
"scaleY": 1,
"unit": "EMU"
},
"type": "OUTER"
},
"shapeBackgroundFill" : {
"propertyState": "NOT_RENDERED",
"solidFill": {
"alpha": 1,
"color": {
"rgbColor: {
"blue": 1,
"green": 1,
"red": 1
}
}
}
}
},
"shapeType": "TEXT_BOX",
"text": {
"textElements": [
{
"endIndex": 11,
"paragraphMarker": {
"style": {
"alignment": "START",
"direction": "LEFT_TO_RIGHT",
"indentEnd": {
"unit": "PT"
},
"indentFirstLine": {
"unit": "PT"
},
"indentStart": {
"unit": "PT"
},
"lineSpacing": 100,
"spaceAbove": {
"unit": "PT"
},
"spaceBelow": {
"unit": "PT"
},
"spacingMode": "COLLAPSE_LISTS"
}
}
},
{
"endIndex": 11,
"textRun": {
"content": "Baby Album\n",
"style": {
"backgroundColor": {},
"baselineOffset": "NONE",
"bold": false,
"fontFamily": "Arial",
"fontSize": {
"magnitude": 14,
"unit": "PT"
},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {}
}
},
"italic": false,
"smallCaps": false,
"strikethrough": false,
"underline": false
}
}
}
]
}
}
},
...
]
}