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

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