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

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"
        }
      }
    }
  ]
}

Create a slide

यहां दिए गए 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 कोड सैंपल में, UpdatePagePropertiesRequest तरीके का इस्तेमाल करके, PAGE_ID से तय की गई स्लाइड की बैकग्राउंड इमेज सेट करने का तरीका दिखाया गया है. एपीआई, 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"
}