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

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

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

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

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

एक टेबल बनाओ

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

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

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

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 कोड सैंपल में, textRangeमें मौजूद किसी सेल से सारा टेक्स्ट हटाने के लिए, DeleteTextRequest तरीके का इस्तेमाल करने का तरीका दिखाया गया है. इसके बाद, "कंगारू" के नए टेक्स्ट से इसे बदलने के लिए, 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
      }
    }
  ]
}

टेबल की हेडर लाइन को फ़ॉर्मैट करना

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

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

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