अनुरोध
किसी दस्तावेज़ पर लागू करने के लिए एक अपडेट.
| JSON के काेड में दिखाना |
|---|
{ "replaceAllText": { object ( |
| फ़ील्ड | |
|---|---|
यूनियन फ़ील्ड
request. लागू करने के लिए खास अनुरोध. सिर्फ़ एक फ़ील्ड की ज़रूरत है.
request
इनमें से सिर्फ़ एक हो सकता है:
|
|
replaceAllText
|
यह फ़ंक्शन, बताए गए टेक्स्ट के सभी इंस्टेंस को बदलता है. |
insertText
|
इससे बताई गई जगह पर टेक्स्ट डाला जाता है. |
updateTextStyle
|
इससे, तय की गई रेंज में टेक्स्ट स्टाइल अपडेट होती है. |
createParagraphBullets
|
यह फ़ंक्शन, पैराग्राफ़ के लिए बुलेट बनाता है. |
deleteParagraphBullets
|
इससे पैराग्राफ़ से बुलेट हट जाती हैं. |
createNamedRange
|
नाम वाली रेंज बनाता है. |
deleteNamedRange
|
यह फ़ंक्शन, किसी नामित रेंज को मिटाता है. |
updateParagraphStyle
|
यह तरीका, तय की गई रेंज में पैराग्राफ़ स्टाइल को अपडेट करता है. |
deleteContentRange
|
यह कुकी, दस्तावेज़ से कॉन्टेंट मिटाती है. |
insertInlineImage
|
इस फ़ंक्शन की मदद से, बताई गई जगह पर इनलाइन इमेज जोड़ी जा सकती है. |
insertTable
|
इससे बताई गई जगह पर टेबल डाली जाती है. |
insertTableRow
|
इस फ़ंक्शन की मदद से, टेबल में एक खाली लाइन जोड़ी जा सकती है. |
insertTableColumn
|
इस फ़ंक्शन की मदद से, टेबल में एक खाली कॉलम जोड़ा जा सकता है. |
deleteTableRow
|
यह फ़ंक्शन, किसी टेबल से पंक्ति मिटाता है. |
deleteTableColumn
|
इस फ़ंक्शन का इस्तेमाल करके, किसी टेबल से कॉलम मिटाया जा सकता है. |
insertPageBreak
|
यह फ़ंक्शन, बताई गई जगह पर पेज ब्रेक डालता है. |
deletePositionedObject
|
यह फ़ंक्शन, दस्तावेज़ से किसी ऑब्जेक्ट को मिटाता है. |
updateTableColumnProperties
|
यह फ़ंक्शन, टेबल में मौजूद कॉलम की प्रॉपर्टी अपडेट करता है. |
updateTableCellStyle
|
इससे टेबल सेल की स्टाइल अपडेट की जाती है. |
updateTableRowStyle
|
यह विकल्प, टेबल में लाइन की स्टाइल को अपडेट करता है. |
replaceImage
|
दस्तावेज़ में मौजूद इमेज को बदलता है. |
updateDocumentStyle
|
दस्तावेज़ की स्टाइल को अपडेट करता है. |
mergeTableCells
|
इस फ़ंक्शन का इस्तेमाल, टेबल में मौजूद सेल को मर्ज करने के लिए किया जाता है. |
unmergeTableCells
|
इस विकल्प का इस्तेमाल करके, टेबल में मौजूद सेल को अलग-अलग किया जा सकता है. |
createHeader
|
इससे हेडर बनता है. |
createFooter
|
यह फ़ुटर बनाता है. |
createFootnote
|
फ़ुटनोट बनाता है. |
replaceNamedRangeContent
|
नाम वाली किसी रेंज में मौजूद कॉन्टेंट को बदलता है. |
updateSectionStyle
|
इससे चुनी गई रेंज के सेक्शन की स्टाइल अपडेट की जाती है. |
insertSectionBreak
|
यह फ़ंक्शन, बताई गई जगह पर सेक्शन ब्रेक डालता है. |
deleteHeader
|
यह दस्तावेज़ से हेडर मिटाता है. |
deleteFooter
|
यह दस्तावेज़ से फ़ुटर मिटाता है. |
pinTableHeaderRows
|
यह फ़ंक्शन, किसी टेबल में पिन की गई हेडर लाइनों की संख्या को अपडेट करता है. |
addDocumentTab
|
यह कुकी, दस्तावेज़ टैब जोड़ती है. |
deleteTab
|
यह कुकी, दस्तावेज़ टैब को मिटाती है. |
updateDocumentTabProperties
|
यह कुकी, दस्तावेज़ टैब की प्रॉपर्टी अपडेट करती है. |
insertPerson
|
इससे किसी व्यक्ति का नाम टैग किया जाता है. |
insertDate
|
तारीख डालता है. |
ReplaceAllTextRequest
किसी शर्त से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को replace text से बदलता है.
| JSON के काेड में दिखाना |
|---|
{ "replaceText": string, "tabsCriteria": { object ( |
| फ़ील्ड | |
|---|---|
replaceText
|
वह टेक्स्ट जो मैच किए गए टेक्स्ट की जगह लेगा. |
tabsCriteria
|
ज़रूरी नहीं. इन शर्तों का इस्तेमाल करके यह तय किया जाता है कि किस टैब में बदलाव किया जाएगा. अगर इस विकल्प को शामिल नहीं किया जाता है, तो बदलाव सभी टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
यूनियन फ़ील्ड
criteria. बदले जाने वाले टेक्स्ट से मैच करने के लिए इस्तेमाल की गई शर्तें.
criteria
इनमें से सिर्फ़ एक हो सकता है:
|
|
containsText
|
दस्तावेज़ में इस सबस्ट्रिंग से मेल खाने वाला टेक्स्ट ढूंढता है. |
SubstringMatchCriteria
ऐसी शर्त जो दस्तावेज़ में मौजूद टेक्स्ट की किसी खास स्ट्रिंग से मेल खाती हो.
| JSON के काेड में दिखाना |
|---|
{ "text": string, "matchCase": boolean, "searchByRegex": boolean } |
| फ़ील्ड | |
|---|---|
text
|
दस्तावेज़ में खोजे जाने वाला टेक्स्ट. |
matchCase
|
इससे पता चलता है कि खोज में केस-सेंसिटिविटी का ध्यान रखना चाहिए या नहीं:
|
searchByRegex
|
ज़रूरी नहीं. अगर खोजी जाने वाली वैल्यू को रेगुलर एक्सप्रेशन के तौर पर माना जाना चाहिए, तो यह विकल्प सही होता है. पैटर्न में मौजूद किसी भी बैकस्लैश को एस्केप किया जाना चाहिए.
|
TabsCriteria
यह एक ऐसी शर्त है जिससे यह तय होता है कि अनुरोध किन टैब में पूरा होगा.
| JSON के काेड में दिखाना |
|---|
{ "tabIds": [ string ] } |
| फ़ील्ड | |
|---|---|
tabIds[]
|
उन टैब आईडी की सूची जिनमें अनुरोध पूरा किया जाता है. |
InsertTextRequest
इससे बताई गई जगह पर टेक्स्ट डाला जाता है.
| JSON के काेड में दिखाना |
|---|
{ "text": string, "location": { object ( |
| फ़ील्ड | |
|---|---|
text
|
शामिल किया जाने वाला टेक्स्ट.
नई लाइन का वर्ण डालने पर, उस इंडेक्स पर अपने-आप एक नया जोड़ा गया टेक्स्ट किस स्टाइल में दिखेगा, यह अपने-आप तय होगा. आम तौर पर, यह आस-पास के टेक्स्ट की स्टाइल के हिसाब से तय होता है. ज़्यादातर मामलों में, जोड़े गए टेक्स्ट की स्टाइल, जोड़े गए टेक्स्ट से ठीक पहले मौजूद टेक्स्ट की स्टाइल से मेल खाएगी. कंट्रोल कैरेक्टर (U+0000-U+0008, U+000C-U+001F) और यूनिकोड बेसिक मल्टीलिंग्वल प्लेन प्राइवेट यूज़ एरिया (U+E000-U+F8FF) के वर्णों को, डाले गए टेक्स्ट से हटा दिया जाएगा. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां टेक्स्ट डाला जाएगा.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
दस्तावेज़ में किसी खास इंडेक्स पर टेक्स्ट डालता है.
टेक्स्ट को मौजूदा |
endOfSegmentLocation
|
यह हेडर, फ़ुटर, फ़ुटनोट या दस्तावेज़ के मुख्य हिस्से के आखिर में टेक्स्ट जोड़ता है. |
जगह
दस्तावेज़ में मौजूद कोई खास जगह.
| JSON के काेड में दिखाना |
|---|
{ "segmentId": string, "index": integer, "tabId": string } |
| फ़ील्ड | |
|---|---|
segmentId
|
यह उस हेडर, फ़ुटर या फ़ुटनोट का आईडी होता है जिसमें जगह मौजूद है. खाली सेगमेंट आईडी का मतलब है कि दस्तावेज़ का मुख्य हिस्सा. |
index
|
UTF-16 कोड यूनिट में, ज़ीरो पर आधारित इंडेक्स.
यह इंडेक्स, |
tabId
|
वह टैब जिसमें जगह की जानकारी मौजूद है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
EndOfSegmentLocation
मुख्य जानकारी, हेडर, फ़ुटर या फ़ुटनोट के आखिर में मौजूद जगह. जगह की जानकारी, दस्तावेज़ सेगमेंट में आखिरी नई लाइन से ठीक पहले मौजूद हो.
| JSON के काेड में दिखाना |
|---|
{ "segmentId": string, "tabId": string } |
| फ़ील्ड | |
|---|---|
segmentId
|
यह उस हेडर, फ़ुटर या फ़ुटनोट का आईडी होता है जिसमें जगह मौजूद है. खाली सेगमेंट आईडी का मतलब है कि दस्तावेज़ का मुख्य हिस्सा. |
tabId
|
वह टैब जिसमें जगह की जानकारी मौजूद है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
UpdateTextStyleRequest
टेक्स्ट की स्टाइल अपडेट करें.
| JSON के काेड में दिखाना |
|---|
{ "textStyle": { object ( |
| फ़ील्ड | |
|---|---|
textStyle
|
टेक्स्ट पर सेट की जाने वाली स्टाइल. अगर किसी स्टाइल की वैल्यू, पैरंट स्टाइल की वैल्यू से मैच करती है, तो उस स्टाइल को इनहेरिट करने के लिए सेट किया जाएगा.
टेक्स्ट स्टाइल में कुछ बदलाव करने से, Docs एडिटर के व्यवहार को दिखाने के लिए अन्य बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, टेक्स्ट की स्टाइल को बोल्ड में अपडेट करने के लिए, किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
यूनियन फ़ील्ड
insertion_location. इस्तेमाल की गई रेंज का टाइप, जहां टेक्स्ट स्टाइल अपडेट की जाएगी.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
range
|
स्टाइल करने के लिए टेक्स्ट की रेंज. रेंज को बढ़ाकर, आस-पास की नई लाइनों को शामिल किया जा सकता है. अगर रेंज में सूची का कोई पैराग्राफ़ पूरी तरह से शामिल है, तो पैराग्राफ़ के बुलेट को भी मिलती-जुलती टेक्स्ट स्टाइल के साथ अपडेट किया जाता है. UpdateTextStyleRequest से मिलते-जुलते अनुरोध में रेंज नहीं डाली जा सकती. |
CreateParagraphBulletsRequest
यह उन सभी पैराग्राफ़ के लिए बुलेट बनाता है जो दी गई रेंज से ओवरलैप होते हैं.
हर पैराग्राफ़ का नेस्टिंग लेवल, हर पैराग्राफ़ के आगे मौजूद टैब की संख्या के हिसाब से तय किया जाएगा. बुलेट और उससे जुड़े पैराग्राफ़ के बीच ज़्यादा जगह न रहे, इसके लिए इस अनुरोध के ज़रिए लीडिंग टैब हटा दिए जाते हैं. इससे टेक्स्ट के कुछ हिस्सों के इंडेक्स बदल सकते हैं.
अगर अपडेट किए जा रहे पैराग्राफ़ से ठीक पहले वाला पैराग्राफ़, मेल खाने वाले प्रीसेट वाली सूची में है, तो अपडेट किए जा रहे पैराग्राफ़ को उस सूची में जोड़ दिया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "range": { object ( |
| फ़ील्ड | |
|---|---|
range
|
वह रेंज जिस पर बुलेट प्रीसेट लागू करना है. |
bulletPreset
|
बुलेट के लिए इस्तेमाल किए जाने वाले ग्लिफ़ के टाइप. |
BulletGlyphPreset
सूचियों के लिए, बुलेट ग्लिफ़ के प्रीसेट पैटर्न.
इन पैटर्न में इस तरह की बुलेट का इस्तेमाल किया जाता है:
-
ARROW: यह एक ऐरो है, जो यूनिकोड U+2794 कोड पॉइंट से मेल खाता है -
ARROW3D: यह 3D शेडिंग वाला ऐरो है. यह यूनिकोड U+27a2 कोड पॉइंट से मेल खाता है -
CHECKBOX: यह एक खाली वर्ग है. यह यूनिकोड U+274f कोड पॉइंट के बराबर है -
CIRCLE: यह एक खाली सर्कल है. यह यूनिकोड U+25cb कोड पॉइंट के बराबर है -
DIAMOND: यह एक सॉलिड डायमंड है. यह यूनिकोड U+25c6 कोड पॉइंट के बराबर होता है -
DIAMONDX: 'x' वाला डायमंड, जो यूनिकोड U+2756 कोड पॉइंट के बराबर होता है -
HOLLOWDIAMOND: A hollow diamond, corresponding to a Unicode U+25c7 code point -
DISC: यह एक सॉलिड सर्कल है, जो यूनिकोड U+25cf कोड पॉइंट से मेल खाता है -
SQUARE: यह एक सॉलिड स्क्वेयर है. यह यूनिकोड U+25a0 कोड पॉइंट के मुताबिक है -
STAR: एक स्टार, जो यूनिकोड U+2605 कोड पॉइंट के मुताबिक है -
ALPHA: अंग्रेज़ी का छोटा अक्षर, जैसे कि 'a', 'b' या 'c'. -
UPPERALPHA: अंग्रेज़ी का कोई बड़ा अक्षर, जैसे कि 'A', 'B' या 'C'. -
DECIMAL: कोई संख्या, जैसे कि '1', '2' या '3'. -
ZERODECIMAL: ऐसा नंबर जिसमें एक अंक वाली संख्याओं के पहले शून्य लगाया जाता है. जैसे, '01', '02' या '03'. एक से ज़्यादा अंकों वाले नंबरों के पहले शून्य नहीं लगाया जाता. -
ROMAN: छोटा रोमन अंक, जैसे कि 'i', 'ii' या 'iii'. -
UPPERROMAN: कैपिटल लेटर में रोमन संख्या, जैसे कि 'I', 'II' या 'III'. -
LEFTTRIANGLE: बाईं ओर इशारा करने वाला त्रिकोण. यह यूनिकोड U+25c4 कोड पॉइंट से मेल खाता है
| Enums | |
|---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
बुलेट ग्लिफ़ प्रीसेट की जानकारी नहीं दी गई है. |
BULLET_DISC_CIRCLE_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए DISC, CIRCLE, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए DIAMONDX, ARROW3D, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_CHECKBOX
|
बुलेट वाली सूची, जिसमें
CHECKBOX
सूची के सभी नेस्टिंग लेवल के लिए बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_ARROW_DIAMOND_DISC
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए ARROW, DIAMOND, और DISC बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_STAR_CIRCLE_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए STAR, CIRCLE, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए ARROW3D, CIRCLE, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए LEFTTRIANGLE, DIAMOND, और DISC बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए DIAMONDX, HOLLOWDIAMOND, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
बुलेट वाली सूची में, सूची के पहले तीन नेस्टिंग लेवल के लिए DIAMOND, CIRCLE, और SQUARE बुलेट ग्लिफ़ मौजूद हैं.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
नंबर वाली सूची, जिसमें सूची के पहले तीन नेस्टिंग लेवल के लिए DECIMAL, ALPHA, और ROMAN न्यूमेरिक ग्लिफ़ हैं. इसके बाद, अवधि दी गई है.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
नंबर वाली सूची में, पहले तीन नेस्टिंग लेवल के लिए DECIMAL, ALPHA, और ROMAN न्यूमेरिक ग्लिफ़ दिए गए हैं. इसके बाद, पैरंटheses दिए गए हैं.
|
NUMBERED_DECIMAL_NESTED
|
नंबर वाली सूची, जिसमें
DECIMAL
अंकों वाले ग्लिफ़ को पीरियड से अलग किया गया है. इसमें हर नेस्टिंग लेवल, पिछले नेस्टिंग लेवल के ग्लिफ़ को प्रीफ़िक्स के तौर पर इस्तेमाल करता है. उदाहरण के लिए: '1.', '1.1.', '2.', '2.2.'.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
नंबर वाली सूची, जिसमें सूची के पहले तीन नेस्टिंग लेवल के लिए UPPERALPHA, ALPHA, और ROMAN न्यूमेरिक ग्लिफ़ हैं. इसके बाद, अवधि दी गई है.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
नंबर वाली सूची, जिसमें सूची के पहले तीन नेस्टिंग लेवल के लिए UPPERROMAN, UPPERALPHA, और DECIMAL न्यूमेरिक ग्लिफ़ हैं. इसके बाद, अवधि दी गई है.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
नंबर वाली सूची, जिसमें सूची के पहले तीन नेस्टिंग लेवल के लिए ZERODECIMAL, ALPHA, और ROMAN न्यूमेरिक ग्लिफ़ हैं. इसके बाद, अवधि दी गई है.
|
DeleteParagraphBulletsRequest
यह फ़ंक्शन, दी गई रेंज में आने वाले सभी पैराग्राफ़ से बुलेट मिटाता है.
हर पैराग्राफ़ के नेस्टिंग लेवल को विज़ुअल तौर पर बनाए रखा जाएगा. इसके लिए, संबंधित पैराग्राफ़ की शुरुआत में इंडेंट जोड़ा जाएगा.
| JSON के काेड में दिखाना |
|---|
{
"range": {
object ( |
| फ़ील्ड | |
|---|---|
range
|
वह रेंज जिससे बुलेट हटाने हैं. |
CreateNamedRangeRequest
यह दी गई रेंज का रेफ़रंस देने वाला NamedRange बनाता है.
| JSON के काेड में दिखाना |
|---|
{
"name": string,
"range": {
object ( |
| फ़ील्ड | |
|---|---|
name
|
NamedRange का नाम. नाम अलग-अलग होने ज़रूरी नहीं हैं. नाम में कम से कम एक वर्ण और ज़्यादा से ज़्यादा 256 वर्ण होने चाहिए. वर्णों की गिनती, UTF-16 कोड यूनिट में की जाती है. |
range
|
वह रेंज जिस पर नाम लागू करना है. |
DeleteNamedRangeRequest
यह NamedRange को मिटाता है.
| JSON के काेड में दिखाना |
|---|
{
"tabsCriteria": {
object ( |
| फ़ील्ड | |
|---|---|
tabsCriteria
|
ज़रूरी नहीं. इस विकल्प का इस्तेमाल यह तय करने के लिए किया जाता है कि रेंज को किस टैब में मिटाना है. अगर इसे शामिल नहीं किया जाता है, तो रेंज में मौजूद डेटा को मिटाने की सुविधा सभी टैब पर लागू होती है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
यूनियन फ़ील्ड
named_range_reference. वह वैल्यू जिससे यह तय होता है कि कौनसी रेंज या रेंज मिटानी हैं. इनमें से किसी एक को सेट करना ज़रूरी है.
named_range_reference
इनमें से सिर्फ़ एक हो सकता है:
|
|
namedRangeId
|
मिटाई जाने वाली नाम वाली रेंज का आईडी. |
name
|
मिटाई जाने वाली रेंज का नाम. दिए गए नाम वाली सभी नाम वाली रेंज मिटा दी जाएंगी. |
UpdateParagraphStyleRequest
दी गई रेंज में आने वाले सभी पैराग्राफ़ की स्टाइल अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{ "paragraphStyle": { object ( |
| फ़ील्ड | |
|---|---|
paragraphStyle
|
पैराग्राफ़ पर सेट की जाने वाली स्टाइल.
पैराग्राफ़ की स्टाइल में कुछ बदलाव करने पर, Docs एडिटर के व्यवहार को दिखाने के लिए अन्य बदलाव भी हो सकते हैं. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, पैराग्राफ़ स्टाइल की अलाइनमेंट प्रॉपर्टी को अपडेट करने के लिए, इसे
किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
यूनियन फ़ील्ड
insertion_location. इस्तेमाल की गई रेंज का टाइप, जहां पैराग्राफ़ स्टाइल अपडेट की जाएगी.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
range
|
स्टाइल करने के लिए, पैराग्राफ़ को ओवरलैप करने वाली रेंज. |
DeleteContentRangeRequest
यह कुकी, दस्तावेज़ से कॉन्टेंट मिटाती है.
| JSON के काेड में दिखाना |
|---|
{
"range": {
object ( |
| फ़ील्ड | |
|---|---|
range
|
मिटाने के लिए कॉन्टेंट की रेंज. पैराग्राफ़ की सीमा से बाहर मौजूद टेक्स्ट को मिटाने पर, पैराग्राफ़ के स्टाइल, सूचियों, पोज़िशन किए गए ऑब्जेक्ट, और बुकमार्क में बदलाव हो सकते हैं. ऐसा इसलिए होता है, क्योंकि दोनों पैराग्राफ़ मर्ज हो जाते हैं. कुछ रेंज मिटाने की कोशिश करने पर, दस्तावेज़ का स्ट्रक्चर अमान्य हो सकता है. ऐसे में, गड़बड़ी का मैसेज 400 bad request दिखता है. मिटाने के अमान्य अनुरोधों के कुछ उदाहरण:
|
InsertInlineImageRequest
इस फ़ंक्शन की मदद से, दी गई जगह पर मौजूद इमेज को शामिल किया जाता है.InlineObject
| JSON के काेड में दिखाना |
|---|
{ "uri": string, "objectSize": { object ( |
| फ़ील्ड | |
|---|---|
uri
|
इमेज का यूआरआई. इमेज को दस्तावेज़ में डालते समय, उसे एक बार फ़ेच किया जाता है. साथ ही, उसकी एक कॉपी दस्तावेज़ में दिखाने के लिए सेव की जाती है. इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, यह 25 मेगापिक्सल से ज़्यादा नहीं होनी चाहिए. इसके अलावा, यह PNG, JPEG या GIF फ़ॉर्मैट में होनी चाहिए.
दिया गया यूआरआई, सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला होना चाहिए. साथ ही, इसकी लंबाई ज़्यादा से ज़्यादा 2 केबी होनी चाहिए. यूआरआई को इमेज के साथ सेव किया जाता है. साथ ही, इसे |
objectSize
|
दस्तावेज़ में इमेज का साइज़ कैसा दिखना चाहिए. यह प्रॉपर्टी ज़रूरी नहीं है. दस्तावेज़ में इमेज का फ़ाइनल साइज़ इन नियमों के हिसाब से तय होता है: * अगर चौड़ाई और ऊंचाई, दोनों में से कोई भी तय नहीं की गई है, तो इमेज का डिफ़ॉल्ट साइज़ उसके रिज़ॉल्यूशन के आधार पर तय किया जाता है. * अगर एक डाइमेंशन तय किया जाता है, तो इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखने के लिए, दूसरे डाइमेंशन की गणना की जाती है. * अगर चौड़ाई और ऊंचाई, दोनों के बारे में बताया गया है, तो इमेज को दिए गए डाइमेंशन के हिसाब से स्केल किया जाता है. हालांकि, ऐसा करते समय इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखा जाता है. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां इमेज डाली जाएगी.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर इमेज डालता है.
इमेज को मौजूदा फ़ुटनोट या समीकरण में इनलाइन इमेज नहीं डाली जा सकतीं. |
endOfSegmentLocation
|
यह हेडर, फ़ुटर या दस्तावेज़ के मुख्य भाग के आखिर में टेक्स्ट डालता है. फ़ुटनोट में इनलाइन इमेज नहीं डाली जा सकतीं. |
InsertTableRequest
इससे बताई गई जगह पर टेबल डाली जाती है.
टेबल डालने से पहले, नई लाइन का वर्ण डाला जाएगा.
| JSON के काेड में दिखाना |
|---|
{ "rows": integer, "columns": integer, "location": { object ( |
| फ़ील्ड | |
|---|---|
rows
|
टेबल में मौजूद पंक्तियों की संख्या. |
columns
|
टेबल में कॉलम की संख्या. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां टेबल डाली जाएगी.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह टेबल को किसी मॉडल इंडेक्स में जोड़ता है. जोड़ी गई टेबल से पहले एक नई लाइन का वर्ण डाला जाएगा. इसलिए, टेबल का शुरुआती इंडेक्स, तय किए गए इंडेक्स + 1 पर होगा.
टेबल को किसी मौजूदा फ़ुटनोट या समीकरण में टेबल नहीं डाली जा सकतीं. |
endOfSegmentLocation
|
यह टेबल को दिए गए हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में जोड़ता है. टेबल डालने से पहले, नई लाइन का वर्ण डाला जाएगा. फ़ुटनोट में टेबल नहीं डाली जा सकतीं. |
InsertTableRowRequest
इस फ़ंक्शन की मदद से, टेबल में एक खाली लाइन जोड़ी जा सकती है.
| JSON के काेड में दिखाना |
|---|
{
"tableCellLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableCellLocation
|
रेफ़रंस टेबल सेल की वह जगह जहां से पंक्तियां डाली जाएंगी. नई पंक्ति, उस पंक्ति के ऊपर (या नीचे) जोड़ी जाएगी जिसमें रेफ़रंस सेल मौजूद है. अगर रेफ़रंस सेल, मर्ज की गई सेल है, तो नई पंक्ति, मर्ज की गई सेल के ऊपर (या नीचे) जोड़ी जाएगी. |
insertBelow
|
रेफ़रंस सेल की जगह के नीचे नई लाइन जोड़नी है या नहीं.
|
TableCellLocation
टेबल में किसी सेल की जगह.
| JSON के काेड में दिखाना |
|---|
{
"tableStartLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableStartLocation
|
वह जगह जहां दस्तावेज़ में टेबल शुरू होती है. |
rowIndex
|
यह 0 से शुरू होने वाला लाइन इंडेक्स है. उदाहरण के लिए, टेबल की दूसरी लाइन का लाइन इंडेक्स 1 है. |
columnIndex
|
यह 0 से शुरू होने वाला कॉलम इंडेक्स है. उदाहरण के लिए, टेबल के दूसरे कॉलम का कॉलम इंडेक्स 1 है. |
InsertTableColumnRequest
इस फ़ंक्शन की मदद से, टेबल में एक खाली कॉलम जोड़ा जा सकता है.
| JSON के काेड में दिखाना |
|---|
{
"tableCellLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableCellLocation
|
रेफ़रंस टेबल सेल की वह जगह जहां से कॉलम डाले जाएंगे. रेफ़रंस सेल वाले कॉलम की बाईं (या दाईं) ओर एक नया कॉलम जोड़ा जाएगा. अगर रेफ़रंस सेल, मर्ज की गई सेल है, तो मर्ज की गई सेल की बाईं (या दाईं) ओर एक नया कॉलम जोड़ा जाएगा. |
insertRight
|
रेफ़रंस सेल की दाईं ओर नया कॉलम जोड़ना है या नहीं.
|
DeleteTableRowRequest
यह फ़ंक्शन, किसी टेबल से पंक्ति मिटाता है.
| JSON के काेड में दिखाना |
|---|
{
"tableCellLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableCellLocation
|
रेफ़रंस टेबल सेल की वह जगह जहां से लाइन मिटाई जाएगी. जिस लाइन में यह सेल है उसे मिटा दिया जाएगा. अगर यह मर्ज की गई कोई ऐसी सेल है जो कई लाइनों में फैली हुई है, तो सेल में मौजूद सभी लाइनें मिटा दी जाएंगी. अगर इस मिटाने के बाद टेबल में कोई लाइन नहीं बचती है, तो पूरी टेबल मिटा दी जाती है. |
DeleteTableColumnRequest
इस फ़ंक्शन का इस्तेमाल करके, किसी टेबल से कॉलम मिटाया जा सकता है.
| JSON के काेड में दिखाना |
|---|
{
"tableCellLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableCellLocation
|
रेफ़रंस टेबल सेल की वह जगह जहां से कॉलम मिटाया जाएगा. जिस कॉलम में यह सेल मौजूद है उसे मिटा दिया जाएगा. अगर यह मर्ज की गई कोई ऐसी सेल है जो कई कॉलम में फैली हुई है, तो सेल में शामिल सभी कॉलम मिट जाएंगे. अगर इस कॉलम को मिटाने के बाद टेबल में कोई कॉलम नहीं बचता है, तो पूरी टेबल मिटा दी जाती है. |
InsertPageBreakRequest
यह फ़ंक्शन, तय की गई जगह पर पेज ब्रेक और उसके बाद नई लाइन डालता है.
| JSON के काेड में दिखाना |
|---|
{ "location": { object ( |
| फ़ील्ड | |
|---|---|
यूनियन फ़ील्ड
insertion_location. वह जगह जहां पेज ब्रेक डाला जाएगा.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर पेज ब्रेक डालता है.
पेज ब्रेक को मौजूदा
पेज ब्रेक को टेबल, समीकरण, फ़ुटनोट, हेडर या फ़ुटर में नहीं डाला जा सकता. पेज ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
endOfSegmentLocation
|
यह कुकी, दस्तावेज़ के मुख्य हिस्से के आखिर में पेज ब्रेक डालती है.
फ़ुटनोट, हेडर या फ़ुटर में पेज ब्रेक नहीं डाले जा सकते. पेज ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
DeletePositionedObjectRequest
यह दस्तावेज़ से PositionedObject को मिटाता है.
| JSON के काेड में दिखाना |
|---|
{ "objectId": string, "tabId": string } |
| फ़ील्ड | |
|---|---|
objectId
|
उस ऑब्जेक्ट का आईडी जिसे मिटाना है. |
tabId
|
वह टैब जिसमें मौजूद ऑब्जेक्ट को मिटाना है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
UpdateTableColumnPropertiesRequest
यह फ़ंक्शन, किसी टेबल में मौजूद कॉलम के TableColumnProperties को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{ "tableStartLocation": { object ( |
| फ़ील्ड | |
|---|---|
tableStartLocation
|
वह जगह जहां दस्तावेज़ में टेबल शुरू होती है. |
columnIndices[]
|
ऐसे ज़ीरो-आधारित कॉलम इंडेक्स की सूची जिनकी प्रॉपर्टी अपडेट की जानी चाहिए. अगर कोई इंडेक्स नहीं दिया गया है, तो सभी कॉलम अपडेट किए जाएंगे. |
tableColumnProperties
|
टेबल कॉलम की वे प्रॉपर्टी जिन्हें अपडेट करना है.
अगर |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, कॉलम की चौड़ाई को अपडेट करने के लिए, |
UpdateTableCellStyleRequest
इससे टेबल सेल की किसी रेंज की स्टाइल अपडेट की जाती है.
| JSON के काेड में दिखाना |
|---|
{ "tableCellStyle": { object ( |
| फ़ील्ड | |
|---|---|
tableCellStyle
|
टेबल सेल पर सेट की जाने वाली स्टाइल. बॉर्डर अपडेट करते समय, अगर कोई सेल किसी आस-पास की सेल के साथ बॉर्डर शेयर करती है, तो आस-पास की सेल की बॉर्डर प्रॉपर्टी भी अपडेट हो जाती है. मर्ज किए गए और न दिखने वाले बॉर्डर अपडेट नहीं किए जाते. एक ही अनुरोध में, आस-पास की सेल के साथ शेयर की गई बॉर्डर को अपडेट करने से, बॉर्डर अपडेट में समस्याएं आ सकती हैं. इसलिए, बॉर्डर अपडेट इस क्रम में लागू किए जाते हैं:
|
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, टेबल सेल के बैकग्राउंड का रंग अपडेट करने के लिए, किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
यूनियन फ़ील्ड
cells. वे सेल जिन्हें अपडेट किया जाएगा.
cells
इनमें से सिर्फ़ एक हो सकता है:
|
|
tableRange
|
टेबल की वह रेंज जिसमें टेबल के उस सबसेट को दिखाया जाता है जिस पर अपडेट लागू किए जाते हैं. |
tableStartLocation
|
वह जगह जहां दस्तावेज़ में टेबल शुरू होती है. अपडेट की जानकारी देने पर, उन्हें टेबल की सभी सेल पर लागू किया जाता है. |
TableRange
टेबल की रेंज, टेबल के सबसेट का रेफ़रंस दिखाती है.
ध्यान दें कि टेबल की रेंज में बताई गई सेल, ज़रूरी नहीं कि आयताकार हों. उदाहरण के लिए, मान लें कि हमारे पास 3 x 3 टेबल है, जिसमें आखिरी लाइन की सभी सेल मर्ज की गई हैं. टेबल कुछ इस तरह दिखती है:
[ ][ ][ ]
[ ][ ][ ]
[ ]
टेबल सेल की जगह = (tableStartLocation, row = 0, column = 0), लाइन स्पैन = 3, और कॉलम स्पैन = 2 वाली टेबल रेंज में ये सेल शामिल होती हैं:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
| JSON के काेड में दिखाना |
|---|
{
"tableCellLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableCellLocation
|
सेल की वह जगह जहां से टेबल रेंज शुरू होती है. |
rowSpan
|
टेबल की रेंज में मौजूद पंक्तियों की संख्या. |
columnSpan
|
टेबल की रेंज का कॉलम स्पैन. |
UpdateTableRowStyleRequest
यह फ़ंक्शन, किसी टेबल में मौजूद लाइनों के TableRowStyle को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{ "tableStartLocation": { object ( |
| फ़ील्ड | |
|---|---|
tableStartLocation
|
वह जगह जहां दस्तावेज़ में टेबल शुरू होती है. |
rowIndices[]
|
शून्य पर आधारित पंक्ति इंडेक्स की सूची, जिनकी स्टाइल अपडेट की जानी चाहिए. अगर कोई इंडेक्स नहीं दिया गया है, तो सभी लाइनें अपडेट हो जाएंगी. |
tableRowStyle
|
पंक्तियों पर सेट की जाने वाली स्टाइल. |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, लाइन की कम से कम ऊंचाई को अपडेट करने के लिए, |
ReplaceImageRequest
किसी मौजूदा इमेज को नई इमेज से बदलता है.
इमेज बदलने पर, Docs एडिटर के जैसा अनुभव देने के लिए, मौजूदा इमेज से कुछ image effects हटा दिए जाते हैं.
| JSON के काेड में दिखाना |
|---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum ( |
| फ़ील्ड | |
|---|---|
imageObjectId
|
उस मौजूदा इमेज का आईडी जिसे बदला जाएगा. आईडी को, get अनुरोध के जवाब से वापस पाया जा सकता है. |
uri
|
नई इमेज का यूआरआई. इमेज को दस्तावेज़ में डालते समय, उसे एक बार फ़ेच किया जाता है. साथ ही, उसकी एक कॉपी दस्तावेज़ में दिखाने के लिए सेव की जाती है. इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, यह 25 मेगापिक्सल से ज़्यादा नहीं होनी चाहिए. इमेज का फ़ॉर्मैट PNG, JPEG या GIF होना चाहिए.
दिए गए यूआरआई का साइज़ 2 केबी से ज़्यादा नहीं होना चाहिए. यूआरआई को इमेज के साथ सेव किया जाता है. साथ ही, इसे |
imageReplaceMethod
|
बदलाव करने का तरीका. |
tabId
|
वह टैब जिसमें मौजूद इमेज को बदलना है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
ImageReplaceMethod
इमेज बदलने का तरीका.
| Enums | |
|---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
इमेज बदलने का तरीका नहीं बताया गया है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए. |
CENTER_CROP
|
यह विकल्प, इमेज को ओरिजनल इमेज के साइज़ के हिसाब से स्केल करता है और उसे बीच में अलाइन करता है. ओरिजनल इमेज के डाइमेंशन के हिसाब से इमेज को काटा जा सकता है. इमेज का रेंडर किया गया साइज़, ओरिजनल इमेज के साइज़ के बराबर होगा. |
UpdateDocumentStyleRequest
DocumentStyle को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{
"documentStyle": {
object ( |
| फ़ील्ड | |
|---|---|
documentStyle
|
दस्तावेज़ पर सेट की जाने वाली स्टाइल.
दस्तावेज़ की स्टाइल में कुछ बदलाव करने से, Docs एडिटर के व्यवहार को दिखाने के लिए अन्य बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, बैकग्राउंड को अपडेट करने के लिए, |
tabId
|
वह टैब जिसमें अपडेट की जाने वाली स्टाइल मौजूद है. अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
MergeTableCellsRequest
इस फ़ंक्शन का इस्तेमाल, Table में मौजूद सेल को मर्ज करने के लिए किया जाता है.
| JSON के काेड में दिखाना |
|---|
{
"tableRange": {
object ( |
| फ़ील्ड | |
|---|---|
tableRange
|
टेबल की वह रेंज जिसमें यह बताया गया हो कि टेबल की किन सेल को मर्ज करना है. मर्ज की जा रही सेल में मौजूद किसी भी टेक्स्ट को एक साथ जोड़ दिया जाएगा. साथ ही, उसे रेंज की "हेड" सेल में सेव कर दिया जाएगा. अगर कॉन्टेंट की दिशा बाएं से दाएं है, तो यह रेंज का सबसे ऊपर बाएं सेल होता है. अगर कॉन्टेंट की दिशा बाएं से दाएं नहीं है, तो यह रेंज का सबसे ऊपर दाएं सेल होता है. अगर रेंज आयताकार नहीं है, तो गड़बड़ी का मैसेज दिखता है. ऐसा तब हो सकता है, जब रेंज में पहले से मर्ज की गई सेल शामिल हों या टेबल आयताकार न हो. |
UnmergeTableCellsRequest
यह फ़ंक्शन, Table में मौजूद सेल को अनमर्ज करता है.
| JSON के काेड में दिखाना |
|---|
{
"tableRange": {
object ( |
| फ़ील्ड | |
|---|---|
tableRange
|
टेबल की वह रेंज जिसमें यह तय किया जाता है कि टेबल की किन सेल को अनमर्ज करना है. इस रेंज में मौजूद सभी मर्ज की गई सेल अनमर्ज हो जाएंगी. साथ ही, पहले से अनमर्ज की गई सेल पर कोई असर नहीं पड़ेगा. अगर रेंज में कोई भी सेल मर्ज नहीं की गई है, तो अनुरोध का कोई असर नहीं होगा. अगर मर्ज किए गए किसी सेल में टेक्स्ट है, तो वह टेक्स्ट, मर्ज किए गए सेल के "हेड" सेल में रहेगा. अगर कॉन्टेंट बाएं से दाएं लिखा जाता है, तो "हेडर" सेल, सबसे ऊपर बाईं ओर मौजूद सेल होती है. वहीं, अगर कॉन्टेंट दाएं से बाएं लिखा जाता है, तो "हेडर" सेल, सबसे ऊपर दाईं ओर मौजूद सेल होती है. |
CreateHeaderRequest
Header बनाता है. नया हेडर, SectionStyle पर लागू होता है. अगर SectionBreak की जानकारी दी गई है, तो यह SectionBreak की जगह पर लागू होता है. अगर SectionBreak की जानकारी नहीं दी गई है, तो यह DocumentStyle पर लागू होता है.
अगर तय किए गए टाइप का हेडर पहले से मौजूद है, तो गड़बड़ी का मैसेज '400 bad request' दिखता है.
| JSON के काेड में दिखाना |
|---|
{ "type": enum ( |
| फ़ील्ड | |
|---|---|
type
|
किस तरह का हेडर बनाना है. |
sectionBreakLocation
|
|
CreateFootnoteRequest
यह एक Footnote सेगमेंट बनाता है और दी गई जगह पर एक नया FootnoteReference डालता है.
नए Footnote सेगमेंट में, स्पेस के बाद नई लाइन का वर्ण होगा.
| JSON के काेड में दिखाना |
|---|
{ "location": { object ( |
| फ़ील्ड | |
|---|---|
यूनियन फ़ील्ड
footnote_reference_location. फ़ुटनोट रेफ़रंस डालने की जगह.
footnote_reference_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर फ़ुटनोट का रेफ़रंस डालता है.
फ़ुटनोट रेफ़रंस को मौजूदा
फ़ुटनोट के रेफ़रंस को किसी समीकरण, हेडर, फ़ुटर या फ़ुटनोट में नहीं डाला जा सकता. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
endOfSegmentLocation
|
यह विकल्प, दस्तावेज़ के मुख्य हिस्से के आखिर में फ़ुटनोट रेफ़रंस डालता है.
फ़ुटनोट के रेफ़रंस को हेडर, फ़ुटर या फ़ुटनोट में नहीं डाला जा सकता. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
ReplaceNamedRangeContentRequest
इस फ़ंक्शन की मदद से, बताए गए NamedRange या NamedRanges के कॉन्टेंट को बदले गए कॉन्टेंट से बदला जा सकता है.
ध्यान दें कि किसी व्यक्ति
NamedRange
में कई अलग-अलग
ranges हो सकते हैं. इस मामले में, सिर्फ़ पहली रेंज में मौजूद कॉन्टेंट को बदला जाएगा. अन्य रेंज और उनमें मौजूद कॉन्टेंट मिटा दिया जाएगा.
अगर किसी रेंज को बदलने या मिटाने से दस्तावेज़ का स्ट्रक्चर अमान्य हो जाता है, तो गड़बड़ी का मैसेज 400 Bad Request दिखता है.
| JSON के काेड में दिखाना |
|---|
{
"tabsCriteria": {
object ( |
| फ़ील्ड | |
|---|---|
tabsCriteria
|
ज़रूरी नहीं. इन शर्तों का इस्तेमाल करके यह तय किया जाता है कि किस टैब में बदलाव किया जाएगा. अगर इस विकल्प को शामिल नहीं किया जाता है, तो बदलाव सभी टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
यूनियन फ़ील्ड
replacement_content. यह वह कॉन्टेंट है जिससे आपको नाम वाली रेंज के मौजूदा कॉन्टेंट को बदलना है.
replacement_content
इनमें से सिर्फ़ एक हो सकता है:
|
|
text
|
इस फ़ंक्शन की मदद से, तय की गई नाम वाली रेंज के कॉन्टेंट को दिए गए टेक्स्ट से बदला जा सकता है. |
यूनियन फ़ील्ड
named_range_reference. उस नेम रेंज का रेफ़रंस जिसका कॉन्टेंट बदला जाएगा.
named_range_reference
इनमें से सिर्फ़ एक हो सकता है:
|
|
namedRangeId
|
उस नेम रेंज का आईडी जिसका कॉन्टेंट बदला जाएगा. अगर दिए गए आईडी के साथ कोई नेम रेंज नहीं है, तो 'अनुरोध पूरा नहीं किया जा सका' गड़बड़ी का 400 कोड दिखता है. |
namedRangeName
|
उस
अगर दिए गए नाम के कई
|
UpdateSectionStyleRequest
SectionStyle को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{ "range": { object ( |
| फ़ील्ड | |
|---|---|
range
|
स्टाइल करने के लिए, सेक्शन को ओवरलैप करने वाली रेंज.
सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
sectionStyle
|
सेक्शन पर सेट की जाने वाली स्टाइल.
सेक्शन की स्टाइल में कुछ बदलाव करने से, अन्य बदलाव भी हो सकते हैं. ऐसा Docs Editor के व्यवहार को दिखाने के लिए किया जाता है. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, बाएं मार्जिन को अपडेट करने के लिए, |
InsertSectionBreakRequest
यह फ़ंक्शन, दी गई जगह पर सेक्शन ब्रेक डालता है.
सेक्शन ब्रेक से पहले, नई लाइन वाला वर्ण डाला जाएगा.
| JSON के काेड में दिखाना |
|---|
{ "sectionType": enum ( |
| फ़ील्ड | |
|---|---|
sectionType
|
यह सेक्शन का टाइप है जिसे डाला जाना है. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां ब्रेक डाला जाएगा.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह दस्तावेज़ में किसी खास इंडेक्स पर नई लाइन और सेक्शन ब्रेक डालता है.
सेक्शन ब्रेक को मौजूदा
सेक्शन ब्रेक को टेबल, समीकरण, फ़ुटनोट, हेडर या फ़ुटर में नहीं डाला जा सकता. सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
endOfSegmentLocation
|
यह दस्तावेज़ के मुख्य हिस्से के आखिर में एक नई लाइन और सेक्शन ब्रेक जोड़ता है.
फ़ुटनोट, हेडर या फ़ुटर में सेक्शन ब्रेक नहीं डाले जा सकते. सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
DeleteHeaderRequest
यह दस्तावेज़ से Header को मिटाता है.
| JSON के काेड में दिखाना |
|---|
{ "headerId": string, "tabId": string } |
| फ़ील्ड | |
|---|---|
headerId
|
मिटाने के लिए हेडर का आईडी. अगर इस हेडर को |
tabId
|
वह टैब जिसमें मौजूद हेडर को मिटाना है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
PinTableHeaderRowsRequest
यह फ़ंक्शन, किसी टेबल में पिन की गई टेबल हेडर लाइनों की संख्या को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{
"tableStartLocation": {
object ( |
| फ़ील्ड | |
|---|---|
tableStartLocation
|
वह जगह जहां दस्तावेज़ में टेबल शुरू होती है. |
pinnedHeaderRowsCount
|
पिन की जाने वाली टेबल की लाइनों की संख्या. अगर वैल्यू 0 है, तो इसका मतलब है कि सभी लाइनें अनपिन हैं. |
AddDocumentTabRequest
यह कुकी, दस्तावेज़ टैब जोड़ती है. किसी इंडेक्स में टैब जोड़ने पर, उसके बाद के सभी टैब के इंडेक्स बढ़ जाते हैं.
| JSON के काेड में दिखाना |
|---|
{
"tabProperties": {
object ( |
| फ़ील्ड | |
|---|---|
tabProperties
|
जोड़ने के लिए टैब की प्रॉपर्टी. सभी प्रॉपर्टी वैकल्पिक हैं. |
DeleteTabRequest
यह कुकी, टैब को मिटाती है. अगर टैब में चाइल्ड टैब हैं, तो उन्हें भी मिटा दिया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "tabId": string } |
| फ़ील्ड | |
|---|---|
tabId
|
मिटाने के लिए टैब का आईडी. |
UpdateDocumentTabPropertiesRequest
किसी दस्तावेज़ टैब की प्रॉपर्टी अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{
"tabProperties": {
object ( |
| फ़ील्ड | |
|---|---|
tabProperties
|
अपडेट की जाने वाली टैब प्रॉपर्टी. |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
|
InsertPersonRequest
इससे किसी व्यक्ति का नाम टैग किया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "personProperties": { object ( |
| फ़ील्ड | |
|---|---|
personProperties
|
जिस व्यक्ति का नाम टैग किया गया है उसकी प्रॉपर्टी डालने के लिए. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां व्यक्ति का नाम डाला जाएगा.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर व्यक्ति का नाम टैग करता है.
टैग किए गए व्यक्ति को मौजूदा किसी समीकरण में, लोगों को टैग नहीं किया जा सकता. |
endOfSegmentLocation
|
यह हेडर, फ़ुटर, फ़ुटनोट या दस्तावेज़ के मुख्य हिस्से के आखिर में, किसी व्यक्ति का नाम टैग करता है. |
InsertDateRequest
यह फ़ंक्शन, तय की गई जगह पर तारीख डालता है.
| JSON के काेड में दिखाना |
|---|
{ "dateElementProperties": { object ( |
| फ़ील्ड | |
|---|---|
dateElementProperties
|
तारीख की प्रॉपर्टी, जिसे शामिल करना है. |
यूनियन फ़ील्ड
insertion_location. वह जगह जहां तारीख डाली जाएगी.
insertion_location
इनमें से सिर्फ़ एक हो सकता है:
|
|
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर तारीख डालता है.
तारीख को मौजूदा |
endOfSegmentLocation
|
यह फ़ंक्शन, दिए गए हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में तारीख डालता है. |