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