सामान्य लेखन

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

इन उदाहरणों में इन वैरिएबल का इस्तेमाल किया गया है:

• PRESENTATION_ID—इससे पता चलता है कि आपने प्रज़ेंटेशन आईडी. आप प्रज़ेंटेशन के यूआरएल से इस आईडी की वैल्यू देखें.
• PAGE_ID—इससे पता चलता है कि पेज ऑब्जेक्ट कहां जोड़ा गया है आईडी. वापस लाए जा सकते हैं इस वैल्यू को, यूआरएल से या एपीआई पढ़ने के अनुरोध का इस्तेमाल करके सबमिट किया जा सकता है.
• PAGE_ELEMENT_ID—यह बताता है कि आपने पेज कहां उपलब्ध कराया है एलिमेंट ऑब्जेक्ट आईडी. आपने लोगों तक पहुंचाया मुफ़्त में इस आईडी को उन एलिमेंट के लिए तय कर सकता है जिन्हें आप बनाते हैं (कुछ कुछ प्रतिबंध) या Slides API को अपने-आप जनरेट होने की अनुमति दें. एलिमेंट आईडी को एपीआई पढ़ने के अनुरोध की मदद से वापस पाया जा सकता है.

ये उदाहरण भाषा न्यूट्रल होने के एचटीटीपी अनुरोधों के तौर पर दिखाए गए हैं. सीखने में Google API का इस्तेमाल करके, बैच अपडेट को अलग-अलग भाषाओं में लागू करने का तरीका क्लाइंट लाइब्रेरी में, आकार जोड़ें और टेक्स्ट.

स्लाइड में टेक्स्ट बॉक्स जोड़ना

नीचे दिए गए presentations.batchUpdate कोड सैंपल, एक ही फ़ाइल में CreateShapeRequest एक नया टेक्स्ट बॉक्स (जिसमें "मेरा जोड़ा गया टेक्स्ट बॉक्स" स्ट्रिंग शामिल है) जोड़ने का तरीका PAGE_ID के ज़रिए तय की गई स्लाइड. इसमें दो अनुरोध दिए गए हैं अनुरोध का मुख्य हिस्सा—एक टेक्स्ट बॉक्स का आकार (जो दिए गए साइज़ और स्थान) और उसमें टेक्स्ट डालने के लिए एक सेकंड.

पहला अनुरोध ऑब्जेक्ट के बारे में बताता है इस्तेमाल करने के लिए आईडी डालें. इससे दूसरे अनुरोध को उसी एपीआई कॉल में इस्तेमाल किया जा सकता है. इससे दूसरे अनुरोध को है.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

किसी स्लाइड में इमेज जोड़ना

नीचे दिए गए presentations.batchUpdate कोड सैंपल, एक ही फ़ाइल में CreateImageRequest PAGE_ID द्वारा दर्ज की गई स्लाइड में चित्र जोड़ने का तरीका. कॉन्टेंट बनाने एपीआई, IMAGE_URL का इस्तेमाल करके इमेज को हासिल करता है. यह अनुरोध भी स्लाइड में इमेज को स्केल और पोज़ीशन करता है.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

पेज या पेज के एलिमेंट को मिटाना

नीचे दिए गए presentations.batchUpdate कोड सैंपल, एक ही फ़ाइल में DeleteObjectRequest PAGE_ELEMENT_ID के ज़रिए तय किए गए पेज तत्व को मिटाने की विधि और दो अलग-अलग अनुरोधों का इस्तेमाल करके PAGE_ID ने इस स्लाइड को तय किया है.

किसी पेज या पेज के एलिमेंट को मिटाने के लिए, अनुरोध प्रोटोकॉल इस तरह का होता है:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

दिए गए आकार में टेक्स्ट में बदलाव करें

नीचे दिए गए presentations.batchUpdate कोड सैंपल, एक ही फ़ाइल में DeleteTextRequest दिए गए आकार में मौजूद टेक्स्ट के किसी हिस्से को बदलने का तरीका PAGE_ELEMENT_ID. यह पूरा करने के लिए, पहले इसका उपयोग करके लेख हटाएं शून्य पर आधारित startIndex को चुनें और फिर उस पोज़िशन में नया टेक्स्ट डालें. इसमें उदाहरण के लिए, मूल टेक्स्ट स्ट्रिंग "मेरा आकार टेक्स्ट: •?" को "मेरा शेप टेक्स्ट: ट्रेपेज़ोइड".

इस अनुरोध से सिर्फ़ तय आकार वाले टेक्स्ट पर असर पड़ता है. हर जगह टेक्स्ट बदलने के लिए प्रज़ेंटेशन में, ReplaceAllTextRequest तरीका.

एक खास आकार में टेक्स्ट में बदलाव करने के लिए, अनुरोध का प्रोटोकॉल इस तरह से दिया जाता है:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

आकार वाले टैग को इमेज से बदलना

टैग, टेक्स्ट बॉक्स या आकार होते हैं. इनके नाम में स्ट्रिंग का एक यूनीक नाम होता है, जैसे कि "खाते के मालिक का नाम".

नीचे दिए गए presentations.batchUpdate कोड सैंपल, एक ही फ़ाइल में CreateImageRequest किसी आकार टैग के सिंगल इंस्टेंस को इमेज से बदलने का तरीका, वह उसी पोज़िशन में हो जिसे टैग के साइज़ में फ़िट करने के लिए स्केलिंग की गई हो. इसके अलावा, इमेज आसपेक्ट रेशियो या लंबाई-चौड़ाई का अनुपात.

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

CreateImageRequest तरीका सिर्फ़ किसी खास आकार को बदलता है. टैग बदलने के लिए आकार बदलने के लिए, ReplaceAllShapesWithImageRequest तरीका.

आकार टैग में ये शामिल हैं PageElement प्रॉपर्टी (जिन्हें यूआरएल, presentations.pages.get अनुरोध):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

आकार, PAGE_ID की ओर से तय की गई स्लाइड पर रहता है. यह तय करने के लिए जो इमेज आकार बदल देती है, एपीआई IMAGE_URL. इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को सीमित करते हुए, उसे बनाए रखने के लिए टैग के साइज़ तक पहुंचने के लिए, CreateImageRequest तरीका, टैग के साइज़ और स्केल के प्रॉडक्ट के लिए इमेज का साइज़ सेट करता है, और इमेज के स्केल को बदलकर 1 किया जाता है. ज़्यादा जानकारी के लिए, आसपेक्ट सुरक्षित रखें अनुपात.

आकार टैग को इमेज से बदलने के लिए अनुरोध प्रोटोकॉल नीचे दिया गया है:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}