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

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 कोड सैंपल में, 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"
}