बुनियादी जानकारी

Google Slides API की मदद से, प्रज़ेंटेशन, पेज, और पेज एलिमेंट का डेटा पढ़ा जा सकता है. इस पेज पर दिए गए उदाहरणों में, presentations.get और presentations.pages.get, दोनों तरीकों का इस्तेमाल करके, पढ़ने की सामान्य कार्रवाइयां करने का तरीका बताया गया है.

इन उदाहरणों में, इन प्लेसहोल्डर का इस्तेमाल किया गया है:

• PRESENTATION_ID—इससे पता चलता है कि आपको प्रेज़ेंटेशन आईडी कहां देना है. इस आईडी की वैल्यू, प्रज़ेंटेशन यूआरएल से देखी जा सकती है.
• PAGE_ID—इससे पता चलता है कि पेज ऑब्जेक्ट आईडी कहां दिया जाता है. इसकी वैल्यू को यूआरएल से या एपीआई के रीड अनुरोध का इस्तेमाल करके वापस पाया जा सकता है.

इन उदाहरणों को एचटीटीपी अनुरोधों के तौर पर दिखाया गया है, ताकि ये किसी भी भाषा में इस्तेमाल किए जा सकें. इस उदाहरण प्रज़ेंटेशन से पढ़े गए उदाहरणों में, PRESENTATION_ID को 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc के तौर पर इस्तेमाल किया गया है. इस प्रज़ेंटेशन की पहली स्लाइड का PAGE_ID ge63a4b4_1_0 है.

यहां दिए गए उदाहरणों में, फ़ील्ड मास्क का इस्तेमाल किया गया है. इससे सिर्फ़ प्रज़ेंटेशन, स्लाइड, और पेज एलिमेंट के बारे में मांगी गई जानकारी मिलती है. फ़ील्ड मास्क का इस्तेमाल करने से भी परफ़ॉर्मेंस बेहतर होती है.

स्लाइड ऑब्जेक्ट के आईडी पढ़ें

यहां दिए गए presentations.get कोड के सैंपल से पता चलता है कि प्रज़ेंटेशन से सभी स्लाइड ऑब्जेक्ट आईडी की सूची कैसे वापस पाई जाती है. आईडी, स्लाइड प्रज़ेंटेशन के क्रम में दिखाए जाते हैं. इनका इस्तेमाल, एपीआई के बाद के अनुरोधों में खास स्लाइड दिखाने के लिए किया जा सकता है. fields=masters.objectId और fields=layout.objectId का इस्तेमाल करके, मास्टर और लेआउट पेजों के ऑब्जेक्ट आईडी उसी तरह से पाए जा सकते हैं.

स्लाइड ऑब्जेक्ट आईडी को पढ़ने के लिए, अनुरोध प्रोटोकॉल यहां दिया गया है:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId

जवाब में, अनुरोध किए गए ऑब्जेक्ट आईडी वाला Presentation ऑब्जेक्ट होता है:

{
  "slides": [
    {
      "objectId": "ge63a4b4_1_0"
    },
    {
      "objectId": "ge63a4b4_1_9"
    },
    {
      "objectId": "ge63a4b4_1_23"
    },
    {
      "objectId": "ge63a4b4_1_35"
    },
    {
      "objectId": "ge63a4b4_1_43"
    }
  ]
}

किसी पेज से एलिमेंट ऑब्जेक्ट आईडी पढ़ना

यहां दिए गए presentations.pages.get कोड के सैंपल में, किसी पेज पर मौजूद सभी पेज एलिमेंट के ऑब्जेक्ट आईडी की सूची पाने का तरीका बताया गया है.

किसी पेज से एलिमेंट ऑब्जेक्ट आईडी पढ़ने के लिए, अनुरोध प्रोटोकॉल यहां दिया गया है:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId

जवाब में, Page ऑब्जेक्ट होता है. इसमें अनुरोध किए गए ऑब्जेक्ट आईडी शामिल होते हैं:

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

किसी पेज से शेप एलिमेंट पढ़ना

यहां दिए गए presentations.pages.get कोड के सैंपल में, किसी पेज पर मौजूद सभी Shapes की सूची पाने का तरीका बताया गया है. fields पैरामीटर का इस्तेमाल करके, अन्य PageElement तरह के इवेंट वापस पाए जा सकते हैं. उदाहरण के लिए, fields=pageElements(line,table) सिर्फ़ line और table पेज एलिमेंट के बारे में जानकारी देता है. हालांकि, ऐसा तब होता है, जब पेज पर ये एलिमेंट मौजूद हों.

Slides API presentations.pages.get के अनुरोध से, किसी शेप की हर प्रॉपर्टी के बारे में जानकारी मिल सकती है. इसमें वे प्रॉपर्टी भी शामिल हैं जिनमें एपीआई बदलाव नहीं कर सकता.

किसी पेज से शेप एलिमेंट पढ़ने के लिए, अनुरोध प्रोटोकॉल यहां दिया गया है:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape

जवाब में, Page ऑब्जेक्ट होता है. इसमें अनुरोध किए गए शेप एलिमेंट शामिल होते हैं. खाली ब्रेसिज़, पेज के उन एलिमेंट के बारे में बताते हैं जो शेप टाइप के नहीं हैं. इस मामले में, ये इमेज पेज एलिमेंट हैं.

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