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

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 कोड सैंपल में, CreateSlideRequest तरीके का इस्तेमाल करके स्लाइड बनाने और उसे प्रज़ेंटेशन में चौथी स्लाइड (शून्य पर आधारित) के तौर पर शामिल करने का तरीका बताया गया है.insertionIndex

नई स्लाइड 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"
}