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

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

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

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

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

टेबल बनाना

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

इस टेबल में आठ पंक्तियां और पांच कॉलम हैं. ध्यान दें कि 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 कोड सैंपल tableRange में, टेबल एलिमेंट की हेडर लाइन को फ़ॉर्मैट करने के लिए UpdateTableCellPropertiesRequest वाले तरीके का इस्तेमाल करने का तरीका बताया गया है. यह जानकारी TABLE_ID में दी गई है. इसके बाद, यह TableCellProperties तरीके का इस्तेमाल करके, हेडर लाइन के बैकग्राउंड कलर को काला पर सेट करता है.

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

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