Google Slaytlar API'si sunu, sayfa ve sayfa öğesi verilerini okumanıza olanak tanır. Bu sayfadaki örnekler, hem presentations.get hem de presentations.pages.get yöntemlerini kullanarak genel okuma işlemlerinin nasıl gerçekleştirileceğini gösterir.
Bu örneklerde aşağıdaki yer tutucular 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: Sayfa nesnesi kimliğini sağladığınız yeri 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. Örnekler, PRESENTATION_ID olarak 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc kullanılan bu örnek sunudan okunur. Bu sunumdaki PAGE_ID
ilk
slayt
ge63a4b4_1_0.
Buradaki örneklerde yalnızca sunu, slayt ve sayfa öğesi hakkında istenen belirli bilgileri döndürmek için alan maskeleri kullanılmaktadır. Alan maskelerinin kullanılması performansı da artırır.
Slayt nesne kimliklerini oku
Aşağıdaki presentations.get kod örneğinde, sunudaki tüm slayt nesnesi kimliklerinin 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. fields=masters.objectId ve fields=layout.objectId kullanarak ana sayfa ve düzen sayfalarının nesne kimliklerini aynı şekilde alabilirsiniz.
Aşağıda, slayt nesne kimliklerini okumak için kullanılacak 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 sayfadaki öğe nesne kimliklerini okumak için kullanılacak 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"
}
]
}
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) yalnızca sayfada varsa line ve table sayfa öğeleriyle ilgili bilgileri döndürür.
Aşağıda, bir sayfadaki şekil öğelerini okumak için kullanılacak 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ş köşeli parantezler, şekil türünde olmayan sayfa öğelerini belirtir; bu durumda, 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
}
}
}
]
}
}
},
...
]
}