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

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

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

• PRESENTATION_ID—यह बताता है कि आपने प्रज़ेंटेशन आईडी कहां दिया है. प्रज़ेंटेशन यूआरएल से इस आईडी की वैल्यू देखी जा सकती है.
• PAGE_ID—यह बताता है कि आपने पेज ऑब्जेक्ट आईडी कहां दिए हैं. यूआरएल से या एपीआई रीड अनुरोध का इस्तेमाल करके, इसके लिए वैल्यू फिर से पाई जा सकती है.
• TABLE_ID—इससे पता चलता है कि आपको जिस टेबल पर काम करना है उसके लिए, पेज एलिमेंट ऑब्जेक्ट आईडी कहां देना है. इस आईडी को, आपने जो एलिमेंट बनाया है (कुछ पाबंदियों के साथ) के लिए तय किया जा सकता है या Slides API को अपने-आप बनने की अनुमति दी जा सकती है. एलिमेंट आईडी, एपीआई रीड अनुरोध के ज़रिए वापस पाए जा सकते हैं.

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

टेबल बनाएं

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

इस टेबल में आठ पंक्तियां और पांच कॉलम हैं. ध्यान दें कि Slides API, elementProperties के हिस्से के तौर पर दिए गए किसी भी size या transform फ़ील्ड को अनदेखा करता है. इसके बजाय, एपीआई एक टेबल बनाता है जो कुछ हद तक स्लाइड पर आधारित होती है. अगर हो सके, तो पंक्तियों और कॉलम की तय संख्या के हिसाब से साइज़ बदला जाता है.

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

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

{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

टेबल की पंक्तियां या कॉलम मिटाएं

यहां दिए गए presentations.batchUpdate कोड सैंपल में, छठी लाइन को हटाने के लिए DeleteTableRowRequest तरीके का इस्तेमाल करने का तरीका बताया गया है. इसके बाद, यह चौथे कॉलम को हटाने के लिए, DeleteTableColumnRequest तरीके का इस्तेमाल करता है. टेबल को TABLE_ID से तय किया जाता है. cellLocation में मौजूद rowIndex और columnIndex, दोनों शून्य आधारित हैं.

टेबल की पंक्तियों या कॉलम को मिटाने के लिए, यह अनुरोध प्रोटोकॉल है:

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

{
  "requests": [
    {
      "deleteTableRow": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        }
      }
    },
    {
      "deleteTableColumn": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        }
      }
    }
  ]
}

टेबल के डेटा में बदलाव करें

यहां दिया गया presentations.batchUpdate कोड सैंपल में बताया गया है कि DeleteTextRequest textRange में किसी सेल का पूरा टेक्स्ट हटाने का तरीका कैसे इस्तेमाल किया जाता है. इसके बाद, InsertTextRequest तरीके का इस्तेमाल करके, इसे "कंगारू" के नए टेक्स्ट से बदला जाता है.

टेबल को TABLE_ID तय करता है. जिस सेल पर असर पड़ा है वह पांचवीं पंक्ति और तीसरे कॉलम में है. cellLocation में rowIndex और columnIndex, दोनों शून्य आधारित हैं.

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

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

{
  "requests": [
    {
      "deleteText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "textRange": {
          "type": "ALL",
        }
      }
    },
    {
      "insertText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "text": "Kangaroo",
        "insertionIndex": 0
      }
    }
  ]
}

टेबल के हेडर वाली पंक्ति को फ़ॉर्मैट करना

यहां दिए गए presentations.batchUpdate कोड सैंपल में बताया गया है कि टेबल एलिमेंट की हेडर लाइन को फ़ॉर्मैट करने के लिए, UpdateTableCellPropertiesRequest तरीका कैसे इस्तेमाल किया जाता है. यह तरीका tableRange के अंदर है, जिसे TABLE_ID में बताया गया है. इसके बाद, यह TableCellProperties तरीके का इस्तेमाल करके, हेडर लाइन के बैकग्राउंड के रंग को काला पर सेट करता है.

नीचे दिए गए हर अनुरोध में, UpdateTextStyleRequest तरीका इस्तेमाल किया जाता है, जिससे हेडर लाइन की एक सेल में टेक्स्ट फ़ॉर्मैट को बोल्ड, 18-पॉइंट केम्ब्रिया फ़ॉन्ट में textRange के अंदर सेट किया जा सकता है. इसके बाद, आपको हेडर के हर अतिरिक्त सेल के लिए इस अनुरोध को दोहराना होगा.

location और cellLocation में, rowIndex और columnIndex, दोनों शून्य आधारित हैं.

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

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

{
  "requests": [
    {
      "updateTableCellProperties": {
        "objectId": TABLE_ID,
        "tableRange": {
          "location": {
            "rowIndex": 0,
            "columnIndex": 0
          },
          "rowSpan": 1,
          "columnSpan": 3
        },
        "tableCellProperties": {
          "tableCellBackgroundFill": {
            "solidFill": {
              "color": {
                "rgbColor": {
                  "red": 0.0,
                  "green": 0.0,
                  "blue": 0.0
                }
              }
            }
          }
        },
        "fields": "tableCellBackgroundFill.solidFill.color"
      }
    },
    {
      "updateTextStyle": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 0,
          "columnIndex": 0
        },
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              }
            }
          },
          "bold": true,
          "fontFamily": "Cambria",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        },
        "fields": "foregroundColor,bold,fontFamily,fontSize"
      }
    },
    // Repeat the above request for each additional cell in the header row....
  ]
}

इन अपडेट के बाद, फ़ॉर्मैट की गई हेडर लाइन कुछ इस तरह दिखेगी:

टेबल की पंक्तियां या कॉलम शामिल करें

यहां दिए गए presentations.batchUpdate कोड सैंपल में, छठी लाइन के नीचे तीन लाइन जोड़ने के लिए, InsertTableRowsRequest तरीके का इस्तेमाल करने का तरीका बताया गया है. इसके बाद, यह एक ही टेबल के चौथे कॉलम की बाईं ओर दो कॉलम जोड़ने के लिए, InsertTableColumnsRequest तरीका का इस्तेमाल करता है.

टेबल को TABLE_ID तय करता है. cellLocation में rowIndex और columnIndex, दोनों शून्य आधारित हैं.

टेबल की पंक्तियां या कॉलम शामिल करने के लिए, अनुरोध प्रोटोकॉल नीचे दिया गया है:

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

{
  "requests": [
    {
      "insertTableRows": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        },
        "insertBelow": true,
        "number": 3
      }
    },
    {
      "insertTableColumns": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        },
        "insertRight": false,
        "number": 2
      }
    }
  ]
}