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 } } } ] } } }, ... ] }