Temel okuma

Google Slides API ile sunu, sayfa ve sayfa öğesi verilerini okuyabilirsiniz. Bu sayfadaki örneklerde, hem presentations.get hem de presentations.pages.get yöntemleri kullanılarak yaygın 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 nerede sağladığınızı gösterir. Bu kimliğin değerini sunum URL'sinden öğrenebilirsiniz.
  • PAGE_ID—Sayfa nesnesi kimliğini nerede sağladığınızı gösterir. Bu değerin URL'sini alabilir veya API okuma isteği kullanarak değeri edinebilirsiniz.

Bu örnekler, dilden bağımsız olması için HTTP istekleri olarak sunulur. Bu örnekler, 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc adlı PRESENTATION_ID'ye sahip örnek sunudan alınmıştır. Bu sunudaki ilk slaydın PAGE_ID ge63a4b4_1_0.

Buradaki örneklerde, yalnızca sunu, slayt ve sayfa öğesiyle ilgili istenen belirli bilgileri döndürmek için alan maskeleri kullanılır. Alan maskeleri kullanmak da performansı artırır.

Slayt nesnesi kimliklerini okuma

Aşağıdaki presentations.get kod örneğinde, sunudaki tüm slayt nesnesi kimliklerinin listesinin nasıl alınacağı gösterilmektedir. Kimlikler, slayt sunusu sırasına göre 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 ve düzen sayfalarının nesne kimliklerini aynı şekilde alabilirsiniz.

Slayt nesnesi kimliklerini okumak için kullanılan istek protokolü aşağıda 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 sayfadaki öğe nesnesi kimliklerini okuma

Aşağıdaki presentations.pages.get kod örneğinde, bir sayfadaki tüm sayfa öğelerinin nesne kimliklerinin listesinin nasıl alınacağı gösterilmektedir.

Bir sayfadaki öğe nesnesi kimliklerini okumak için kullanılan istek protokolü aşağıda 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 listesinin nasıl alınacağı gösterilmektedir. fields parametresini kullanarak belirteceğiniz diğer PageElement türlerini de alabilirsiniz. Örneğin, sayfada varsa yalnızca line ve table sayfa öğeleriyle ilgili bilgileri döndürür.fields=pageElements(line,table)

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ş küme parantezleri, şekil türünde olmayan sayfa öğelerini gösterir. Bu örnekte, bunlar resim sayfa öğ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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}