Temel okuma

Google Slaytlar API'si sunu, sayfa ve sayfa öğesi verilerini okumanıza olanak tanır. İlgili içeriği oluşturmak için kullanılan Bu sayfadaki örnekler, hem presentations.get ve presentations.pages.get yöntemlerine göz atın.

Bu örneklerde aşağıdaki yer tutucular kullanılmaktadır:

Bu örnekler, dilden bağımsız olarak HTTP istekleri olarak sunulur. İlgili içeriği oluşturmak için kullanılan bu örnekten okunan örnekler sunu, 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc olan PRESENTATION_ID. PAGE_ID birinci slayt Bu sunudaki katılımcı sayısı ge63a4b4_1_0.

Buradaki örneklerde yalnızca aşağıdaki durumlarda alan maskeleri kullanılmaktadır: sunu, slayt ve sayfa hakkında istenen belirli bilgileri döndür öğesine dokunun. Alan maskelerinin kullanılması performansı da artırır.

Slayt nesne kimliklerini oku

Aşağıdakiler presentations.get kodu örnek, en iyi uygulamaları paylaşacağız. Kimlikler slayt sunumu sırasında döndürülür ve sonraki API isteklerinde belirli slaytları belirtmek için kullanılır. Web sitemiz g.co/newsinitiative/labs üzerinden ana ve düzen sayfalarının nesne kimlikleri aynı şekilde, fields=masters.objectId ve fields=layout.objectId.

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, Presentation istenen nesne kimliklerini içeren nesne:

{
  "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ğıdakiler presentations.pages.get kod örneği, tüm sayfa öğeleri için nesne kimlikleri listesinin nasıl alınacağını gösterir görüntüler.

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, Page nesne istenen nesne kimliklerini içeren:

{
  "pageElements": [
    {
      "objectId": "ge63a4b4_1_5"
    },
    {
      "objectId": "ge63a4b4_1_6"
    },
    {
      "objectId": "ge63a4b4_1_7"
    },
    {
      "objectId": "ge63a4b4_1_8"
    }
  ]
}

Sayfadaki şekil öğelerini okuma

Aşağıdakiler presentations.pages.get kod örneği, tüm reklam öğelerinin listesinin Shapes görüntüler. Diğer PageElement türlerini fields parametresiyle belirtin. Örneğin, fields=pageElements(line,table), yalnızca aşağıdaki konularla ilgili bilgileri döndürür: line ve table sayfa öğeleri olup olmadığını kontrol edin.

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, Page nesne içeren bir e-posta alırsınız. Boş ayraçlar, sayfa öğelerini belirtir şekil türünde olmayanlar; 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}