स्लाइड से जुड़ी कार्रवाइयां

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

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

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

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

स्लाइड कॉपी करना

यहां दिए गए presentations.batchUpdate कोड सैंपल में, किसी स्लाइड को कॉपी करने और उसे प्रज़ेंटेशन में ओरिजनल स्लाइड के बाद डालने के लिए, DuplicateObjectRequest तरीके का इस्तेमाल करने का तरीका बताया गया है. ओरिजनल स्लाइड को PAGE_ID से दिखाया जाता है.

अनुरोध की मदद से, यह तय किया जा सकता है कि कॉपी में पेज के कुछ या सभी एलिमेंट आईडी होने चाहिए या नहीं. हालांकि, इसके लिए कुछ पाबंदियां लागू होती हैं. इस उदाहरण में, ओरिजनल स्लाइड में एक टेबल एलिमेंट (TABLE_ELEMENT_ID से दिखाया गया) है, जिसे स्लाइड की कॉपी (COPY_PAGE_ID से दिखाया गया) में एक नई टेबल (COPY_TABLE_ELEMENT_ID से दिखाया गया) से मैप किया गया है. कॉपी के सभी अन्य एलिमेंट को रैंडम आईडी दिए गए हैं.

टेक्स्ट बॉक्स, इमेज, टेबल, बुनियादी आकार, लाइनों, और एम्बेड किए गए वीडियो जैसे PageElement को कॉपी करने के बारे में ज़्यादा जानने के लिए, किसी एलिमेंट को कॉपी करना और उसमें बदलाव करना सैंपल देखें.

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

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

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

स्लाइड बनाना

यहां दिए गए presentations.batchUpdate कोड सैंपल में, स्लाइड बनाने और उसे प्रज़ेंटेशन में चौथी स्लाइड के तौर पर शामिल करने (शून्य पर आधारित insertionIndex का इस्तेमाल करके) के लिए, CreateSlideRequest तरीके का इस्तेमाल करने का तरीका बताया गया है.

नई स्लाइड, TITLE_AND_TWO_COLUMNS के PredefinedLayout का इस्तेमाल करने के लिए सेट है. स्लाइड के लिए PAGE_ID के तौर पर इस्तेमाल करने के लिए, कुछ पाबंदियों के साथ कोई स्ट्रिंग तय की जा सकती है. इसके अलावा, अनुरोध में फ़ील्ड को हटाकर, एपीआई को PAGE_ID जनरेट करने की अनुमति भी दी जा सकती है.

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

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

स्लाइड बनाना और प्लेसहोल्डर में बदलाव करना

यहां दिए गए presentations.batchUpdate कोड सैंपल में, TITLE_AND_TWO_COLUMNS के PredefinedLayout का इस्तेमाल करके स्लाइड बनाने के लिए, CreateSlideRequest तरीके का इस्तेमाल करने का तरीका बताया गया है.

स्लाइड के लिए PAGE_ID के तौर पर इस्तेमाल करने के लिए, कोई स्ट्रिंग तय की जा सकती है. हालांकि, इसके लिए कुछ पाबंदियां लागू होती हैं. placeholderIdMappings, TITLE के Type का इस्तेमाल करता है. TITLE_ID, स्लाइड के प्लेसहोल्डर के आकार का रेफ़रंस देता है, ताकि उसमें बदलाव किया जा सके.

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

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

स्लाइड को किसी नई जगह पर ले जाना

यहां दिया गया presentations.batchUpdate कोड सैंपल, UpdateSlidesPositionRequest तरीके का इस्तेमाल करके, दो चुनी गई स्लाइड को प्रज़ेंटेशन की शुरुआत में ले जाने का तरीका दिखाता है. साथ ही, यह भी दिखाता है कि स्लाइड की क्रम से क्रम में बदलाव किए बिना ऐसा कैसे किया जा सकता है.

दिए गए स्लाइड आईडी (PAGE_ID और PAGE_ID2), प्रज़ेंटेशन के मौजूदा क्रम में दिए जाने चाहिए. साथ ही, इनमें डुप्लीकेट नहीं होने चाहिए. शून्य पर आधारित insertionIndex से पता चलता है कि स्लाइड को कहां डाला जाना चाहिए. यह जानकारी, स्लाइड को एक से दूसरी जगह ले जाने से पहले के क्रम के आधार पर दी जाती है. वैल्यू, शून्य और प्रज़ेंटेशन में मौजूद स्लाइड की संख्या के बीच होनी चाहिए.

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

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

{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

स्लाइड का बैकग्राउंड सेट करना

यहां दिए गए presentations.batchUpdate कोड सैंपल में, PAGE_ID से तय की गई स्लाइड की बैकग्राउंड इमेज सेट करने के लिए, UpdatePagePropertiesRequest तरीके का इस्तेमाल करने का तरीका बताया गया है. एपीआई, IMAGE_URL का इस्तेमाल करके इमेज को वापस लाता है.

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

इसके अलावा, किसी स्लाइड के बैकग्राउंड को एक रंग में सेट करने के लिए, UpdatePagePropertiesRequest तरीके का इस्तेमाल किया जा सकता है.

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

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

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

थंबनेल जनरेट करना

प्रज़ेंटेशन में किसी पेज के नए वर्शन का थंबनेल जनरेट करने के लिए, presentations.pages.getThumbnail वाला तरीका अपनाएं. इससे, पेज का थंबनेल कॉन्टेंट यूआरएल के तौर पर दिखेगा. इमेज के यूआरएल का डिफ़ॉल्ट लाइफ़टाइम 30 मिनट होता है.

क्वेरी पैरामीटर के तौर पर ThumbnailProperties फ़ील्ड का इस्तेमाल करके, दिखाए गए mimeType और thumbnailSize की जानकारी भी दी जा सकती है.

ThumbnailProperties सेट के साथ पेज का थंबनेल जनरेट करने के लिए, अनुरोध का प्रोटोकॉल यहां दिया गया है:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM

{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}