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