अनुरोध
किसी दस्तावेज़ पर लागू करने के लिए एक अपडेट.
| JSON के काेड में दिखाना |
|---|
{ "replaceAllText": { object ( |
| फ़ील्ड | |
|---|---|
| लागू करने के लिए खास अनुरोध. सिर्फ़ एक फ़ील्ड की ज़रूरत होती है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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
|
इससे किसी व्यक्ति का नाम टैग किया जाता है. |
updateNamedStyle
|
नाम वाली स्टाइल को अपडेट करता है. |
insertRichLink
|
रिच लिंक डालें. |
insertDate
|
यह फ़ंक्शन, तारीख डालता है. |
insertComment
|
दस्तावेज़ में |
addCommentReply
|
|
updateCommentPost
|
यह फ़ंक्शन, |
deleteComment
|
यह कुकी, |
deleteCommentReply
|
किसी |
acceptSuggestion
|
सुझाव स्वीकार करता है. |
rejectSuggestion
|
यह कुकी, किसी सुझाव को अस्वीकार करती है. |
deleteSuggestion
|
यह कुकी, सुझाव को मिटाती है. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
ReplaceAllTextRequest
किसी मानदंड से मेल खाने वाले टेक्स्ट के सभी इंस्टेंस को replace text से बदलता है.
| JSON के काेड में दिखाना |
|---|
{ "replaceText": string, "tabsCriteria": { object ( |
| फ़ील्ड | |
|---|---|
replaceText
|
वह टेक्स्ट जिसे मैच किए गए टेक्स्ट की जगह पर इस्तेमाल किया जाएगा. |
tabsCriteria
|
ज़रूरी नहीं. इस शर्त का इस्तेमाल यह तय करने के लिए किया जाता है कि किस टैब में बदलाव किया जाएगा. अगर इस विकल्प को शामिल नहीं किया जाता है, तो बदलाव सभी टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
| बदले जाने वाले टेक्स्ट से मैच करने के लिए इस्तेमाल की गई शर्तें. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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) के वर्ण, डाले गए टेक्स्ट से हटा दिए जाएंगे. |
| वह जगह जहां टेक्स्ट डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, टेक्स्ट स्टाइल को बोल्ड में अपडेट करने के लिए, किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड का नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
| इस्तेमाल की गई रेंज का टाइप, जहां टेक्स्ट स्टाइल को अपडेट किया जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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: खोखला डायमंड, जो यूनिकोड U+25c7 कोड पॉइंट के मुताबिक है -
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
|
ज़रूरी नहीं. इस विकल्प का इस्तेमाल यह तय करने के लिए किया जाता है कि रेंज को किस टैब से मिटाना है. अगर इसे शामिल नहीं किया जाता है, तो रेंज मिटाने की सुविधा सभी टैब पर लागू होती है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
| वह वैल्यू जिससे यह तय होता है कि कौनसी रेंज या रेंज मिटानी हैं. इनमें से किसी एक को सेट करना ज़रूरी है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
namedRangeId
|
मिटाने के लिए, नाम वाली रेंज का आईडी. |
name
|
मिटाई जाने वाली रेंज का नाम. दिए गए नाम वाली सभी नेम रेंज मिटा दी जाएंगी. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
UpdateParagraphStyleRequest
दी गई रेंज में आने वाले सभी पैराग्राफ़ की स्टाइल अपडेट करें.
| JSON के काेड में दिखाना |
|---|
{ "paragraphStyle": { object ( |
| फ़ील्ड | |
|---|---|
paragraphStyle
|
पैराग्राफ़ पर सेट की जाने वाली स्टाइल.
पैराग्राफ़ की स्टाइल में कुछ बदलाव करने पर, Docs एडिटर के व्यवहार को दिखाने के लिए अन्य बदलाव भी हो सकते हैं. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, पैराग्राफ़ स्टाइल की अलाइनमेंट प्रॉपर्टी को अपडेट करने के लिए, किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड का नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
| इस्तेमाल की गई रेंज का टाइप, जहां पैराग्राफ़ स्टाइल अपडेट की जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
range
|
स्टाइल करने के लिए, पैराग्राफ़ से ओवरलैप होने वाली रेंज. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
DeleteContentRangeRequest
यह कुकी, दस्तावेज़ से कॉन्टेंट मिटाती है.
| JSON के काेड में दिखाना |
|---|
{
"range": {
object ( |
| फ़ील्ड | |
|---|---|
range
|
मिटाने के लिए कॉन्टेंट की रेंज. पैराग्राफ़ की सीमा से बाहर मौजूद टेक्स्ट को मिटाने पर, पैराग्राफ़ के स्टाइल, सूचियों, पोज़िशन किए गए ऑब्जेक्ट, और बुकमार्क में बदलाव हो सकते हैं. ऐसा इसलिए होता है, क्योंकि दोनों पैराग्राफ़ मर्ज हो जाते हैं. कुछ रेंज मिटाने की कोशिश करने पर, दस्तावेज़ का स्ट्रक्चर अमान्य हो सकता है. ऐसे में, गड़बड़ी का मैसेज 400 bad request दिखता है. डेटा मिटाने के अमान्य अनुरोधों के कुछ उदाहरण:
|
InsertInlineImageRequest
इस फ़ंक्शन की मदद से, दी गई जगह पर इमेज वाला InlineObject डाला जाता है.
| JSON के काेड में दिखाना |
|---|
{ "uri": string, "objectSize": { object ( |
| फ़ील्ड | |
|---|---|
uri
|
इमेज का यूआरआई. इमेज को दस्तावेज़ में शामिल करते समय, उसे एक बार फ़ेच किया जाता है. साथ ही, उसकी एक कॉपी दस्तावेज़ में दिखाने के लिए सेव की जाती है. इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, यह 25 मेगापिक्सल से ज़्यादा नहीं होनी चाहिए. इमेज का फ़ॉर्मैट PNG, JPEG या GIF होना चाहिए.
दिया गया यूआरआई, सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला होना चाहिए. साथ ही, इसकी लंबाई ज़्यादा से ज़्यादा 2 केबी होनी चाहिए. यूआरआई को इमेज के साथ सेव किया जाता है. साथ ही, इसे |
objectSize
|
दस्तावेज़ में इमेज का साइज़ कैसा दिखना चाहिए. यह प्रॉपर्टी ज़रूरी नहीं है. दस्तावेज़ में इमेज का फ़ाइनल साइज़, इन नियमों के हिसाब से तय किया जाता है: * अगर चौड़ाई और लंबाई, दोनों में से कोई भी तय नहीं की गई है, तो इमेज के रिज़ॉल्यूशन के आधार पर, उसके डिफ़ॉल्ट साइज़ का हिसाब लगाया जाता है. * अगर एक डाइमेंशन तय किया जाता है, तो इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखने के लिए, दूसरे डाइमेंशन की गणना की जाती है. * अगर चौड़ाई और ऊंचाई, दोनों तय की गई हैं, तो इमेज को दिए गए डाइमेंशन के हिसाब से स्केल किया जाता है. हालांकि, ऐसा करते समय उसके आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखा जाता है. |
| वह जगह जहां इमेज डाली जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर इमेज शामिल करता है.
इमेज को मौजूदा फ़ुटनोट या समीकरण में इनलाइन इमेज नहीं डाली जा सकतीं. |
endOfSegmentLocation
|
यह हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में टेक्स्ट डालता है. फ़ुटनोट में इनलाइन इमेज नहीं डाली जा सकतीं. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
InsertTableRequest
इससे बताई गई जगह पर टेबल डाली जाती है.
शामिल की गई टेबल से पहले, नई लाइन वाला वर्ण डाला जाएगा.
| JSON के काेड में दिखाना |
|---|
{ "rows": integer, "columns": integer, "location": { object ( |
| फ़ील्ड | |
|---|---|
rows
|
टेबल में मौजूद पंक्तियों की संख्या. |
columns
|
टेबल में कॉलम की संख्या. |
| वह जगह जहां टेबल डाली जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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 ( |
| फ़ील्ड | |
|---|---|
| वह जगह जहां पेज ब्रेक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, टेबल सेल के बैकग्राउंड का रंग अपडेट करने के लिए, किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड का नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. |
| वे सेल जिन्हें अपडेट किया जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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
की जगह पर लागू होता है. अगर की जानकारी नहीं दी गई है, तो यह
DocumentStyle पर लागू होता है.
अगर इस तरह का हेडर पहले से मौजूद है, तो गड़बड़ी का मैसेज 400 bad request दिखता है.
| JSON के काेड में दिखाना |
|---|
{ "type": enum ( |
| फ़ील्ड | |
|---|---|
type
|
बनाए जाने वाले हेडर का टाइप. |
sectionBreakLocation
|
|
CreateFootnoteRequest
यह फ़ंक्शन, दी गई जगह पर एक नया Footnote सेगमेंट बनाता है और उसमें एक नया FootnoteReference जोड़ता है.
नए Footnote सेगमेंट में, स्पेस के बाद नई लाइन का वर्ण होगा.
| JSON के काेड में दिखाना |
|---|
{ "location": { object ( |
| फ़ील्ड | |
|---|---|
| फ़ुटनोट रेफ़रंस डालने की जगह. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर फ़ुटनोट रेफ़रंस डालता है.
फ़ुटनोट रेफ़रंस को, मौजूदा
फ़ुटनोट के रेफ़रंस को किसी समीकरण, हेडर, फ़ुटर या फ़ुटनोट में नहीं डाला जा सकता. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
endOfSegmentLocation
|
यह फ़ंक्शन, दस्तावेज़ के मुख्य हिस्से के आखिर में फ़ुटनोट का रेफ़रंस डालता है.
फ़ुटनोट के रेफ़रंस, हेडर, फ़ुटर या फ़ुटनोट में नहीं डाले जा सकते. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
ReplaceNamedRangeContentRequest
इस फ़ंक्शन का इस्तेमाल करके, बताए गए NamedRange या NamedRanges के कॉन्टेंट को बदले गए कॉन्टेंट से बदला जा सकता है.
ध्यान दें कि किसी व्यक्ति
NamedRange
में कई अलग-अलग
ranges हो सकते हैं. इस मामले में, सिर्फ़ पहली रेंज में मौजूद कॉन्टेंट को बदला जाएगा. अन्य रेंज और उनमें मौजूद कॉन्टेंट मिटा दिया जाएगा.
अगर किसी रेंज को बदलने या मिटाने से दस्तावेज़ का स्ट्रक्चर अमान्य हो जाता है, तो गड़बड़ी का मैसेज 400 Bad Request दिखता है.
| JSON के काेड में दिखाना |
|---|
{
"tabsCriteria": {
object ( |
| फ़ील्ड | |
|---|---|
tabsCriteria
|
ज़रूरी नहीं. इस शर्त का इस्तेमाल यह तय करने के लिए किया जाता है कि किस टैब में बदलाव किया जाएगा. अगर इस विकल्प को शामिल नहीं किया जाता है, तो बदलाव सभी टैब पर लागू होता है. एक टैब वाले दस्तावेज़ में:
एक से ज़्यादा टैब वाले दस्तावेज़ में:
|
| यह वह कॉन्टेंट है जिसे नाम वाली रेंज के मौजूदा कॉन्टेंट की जगह इस्तेमाल करना है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
text
|
यह फ़ंक्शन, दी गई टेक्स्ट वैल्यू से, तय की गई नाम वाली रेंज के कॉन्टेंट को बदलता है. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
| उस नाम वाली रेंज का रेफ़रंस जिसका कॉन्टेंट बदला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
namedRangeId
|
उस नाम वाली रेंज का आईडी जिसका कॉन्टेंट बदला जाएगा. अगर दिए गए आईडी के साथ कोई नाम वाली रेंज नहीं है, तो 400 गड़बड़ी वाला अनुरोध दिखता है. |
namedRangeName
|
उस
अगर दिए गए नाम के कई
|
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
UpdateSectionStyleRequest
SectionStyle को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{ "range": { object ( |
| फ़ील्ड | |
|---|---|
range
|
स्टाइल करने के लिए, सेक्शन से ओवरलैप होने वाली रेंज.
सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, |
sectionStyle
|
सेक्शन पर सेट की जाने वाली स्टाइल.
सेक्शन की स्टाइल में कुछ बदलाव करने पर, Docs एडिटर के व्यवहार को दिखाने के लिए अन्य बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, |
fields
|
वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट
उदाहरण के लिए, बाएं मार्जिन को अपडेट करने के लिए, |
InsertSectionBreakRequest
यह बताई गई जगह पर सेक्शन ब्रेक डालता है.
सेक्शन ब्रेक से पहले, नई लाइन वाला वर्ण डाला जाएगा.
| JSON के काेड में दिखाना |
|---|
{ "sectionType": enum ( |
| फ़ील्ड | |
|---|---|
sectionType
|
यह सेक्शन का टाइप है, जिसे डाला जाना है. |
| वह जगह जहां ब्रेक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
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
|
जिस व्यक्ति की जानकारी डालनी है उसकी प्रॉपर्टी. |
| वह जगह जहां व्यक्ति का नाम डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर व्यक्ति का नाम टैग करता है.
टैग किए गए व्यक्ति का नाम, मौजूदा किसी समीकरण में लोगों को टैग नहीं किया जा सकता. |
endOfSegmentLocation
|
यह सुविधा, हेडर, फ़ुटर, फ़ुटनोट या दस्तावेज़ के मुख्य हिस्से के आखिर में, किसी व्यक्ति का नाम टैग करती है. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
UpdateNamedStyleRequest
नाम वाली स्टाइल को अपडेट करता है.
| JSON के काेड में दिखाना |
|---|
{
"namedStyle": {
object ( |
| फ़ील्ड | |
|---|---|
namedStyle
|
अपडेट की जाने वाली दस्तावेज़ की स्टाइल. |
fields
|
NamedStyle के वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए.
कम से कम
उदाहरण के लिए, टेक्स्ट स्टाइल को बोल्ड में अपडेट करने के लिए,
किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड का नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. खाली TextStyle या ParagraphStyle के साथ |
tabId
|
अपडेट करने के लिए दस्तावेज़ का टैब. डिफ़ॉल्ट रूप से, अपडेट पहले टैब पर लागू होता है. |
InsertRichLinkRequest
इससे बताई गई जगह पर RichLink डाला जाता है.
| JSON के काेड में दिखाना |
|---|
{ "richLinkProperties": { object ( |
| फ़ील्ड | |
|---|---|
richLinkProperties
|
रिच लिंक की प्रॉपर्टी, जिसे डालना है. |
| वह जगह जहां रिच लिंक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
location
|
इस तरीके का इस्तेमाल करके, दस्तावेज़ में किसी खास इंडेक्स पर रिच लिंक डाला जाता है.
रिच लिंक को किसी मौजूदा रिच लिंक को किसी समीकरण में नहीं डाला जा सकता. |
endOfSegmentLocation
|
यह हेडर, फ़ुटर, फ़ुटनोट या दस्तावेज़ के मुख्य हिस्से के आखिर में रिच लिंक डालता है. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
InsertDateRequest
यह फ़ंक्शन, तय की गई जगह पर तारीख डालता है.
| JSON के काेड में दिखाना |
|---|
{ "dateElementProperties": { object ( |
| फ़ील्ड | |
|---|---|
dateElementProperties
|
तारीख की प्रॉपर्टी को शामिल करना है. |
| वह जगह जहां तारीख डाली जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
location
|
यह फ़ंक्शन, दस्तावेज़ में किसी खास इंडेक्स पर तारीख डालता है.
तारीख, मौजूदा |
endOfSegmentLocation
|
यह फ़ंक्शन, दिए गए हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में तारीख डालता है. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
InsertCommentRequest
दस्तावेज़ में CommentThread जोड़ता है.
| JSON के काेड में दिखाना |
|---|
{
"content": string,
"assigneeEmailAddress": string,
"range": {
object ( |
| फ़ील्ड | |
|---|---|
content
|
टिप्पणी का टेक्स्ट, सामान्य टेक्स्ट के तौर पर. इस टेक्स्ट कॉन्टेंट को, Docs Editor में बनाई गई टिप्पणियों की तरह ही मैनेज किया जाएगा. इसमें फ़ॉर्मैटिंग, सूचनाएं वगैरह के लिए एक जैसे तरीके इस्तेमाल किए जाएंगे. इस फ़ील्ड को खाली नहीं छोड़ा जा सकता. साथ ही, इसमें UTF-8 कोड की 2048 से ज़्यादा यूनिट नहीं होनी चाहिए. |
assigneeEmailAddress
|
ज़रूरी नहीं. टिप्पणी असाइन करने वाले व्यक्ति का ईमेल पता. अगर आपको किसी टिप्पणी को असाइन नहीं करना है, तो इस फ़ील्ड को खाली छोड़ दें. यह 2,048 UTF-8 कोड यूनिट से ज़्यादा नहीं होना चाहिए. |
| दस्तावेज़ में वह जगह जहां यह टिप्पणी की गई है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
range
|
दस्तावेज़ में मौजूद |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
AddCommentReplyRequest
Post में CommentThread या SuggestionThread के लिए जवाब डाला जाता है.
| JSON के काेड में दिखाना |
|---|
{
"post": {
object ( |
| फ़ील्ड | |
|---|---|
post
|
जवाब को दिखाने वाला |
| जिस थ्रेड में जवाब जोड़ना है उसका आईडी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
commentId
|
जिस |
suggestionId
|
जिस |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
UpdateCommentPostRequest
यह CommentThread या SuggestionThread में मौजूद Post को अपडेट करता है.
इन मामलों में, गड़बड़ी 400: गलत अनुरोध का मैसेज दिखता है:
-
यह पोस्ट, SuggestionThread का
headPostहै. -
अनुरोध करने वाला उपयोगकर्ता, पोस्ट का लेखक नहीं है.
| JSON के काेड में दिखाना |
|---|
{ "postId": string, "content": string, "commentId": string, "suggestionId": string } |
| फ़ील्ड | |
|---|---|
postId
|
अपडेट की जा रही पोस्ट का आईडी. |
content
|
टिप्पणी का नया टेक्स्ट, सादे टेक्स्ट के तौर पर. इस टेक्स्ट कॉन्टेंट को, Docs Editor में बनाई गई टिप्पणियों की तरह ही मैनेज किया जाएगा. इसमें फ़ॉर्मैटिंग, सूचनाएं वगैरह के लिए एक जैसे तरीके इस्तेमाल किए जाएंगे. इस फ़ील्ड को खाली नहीं छोड़ा जा सकता. साथ ही, इसमें UTF-8 कोड की 2048 से ज़्यादा यूनिट नहीं होनी चाहिए. |
| उस थ्रेड का आईडी जिससे पोस्ट जुड़ी है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
commentId
|
उस |
suggestionId
|
उस |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
DeleteCommentRequest
यह कुकी, CommentThread को मिटाती है.
अगर अनुरोध करने वाला उपयोगकर्ता, headPost का लेखक नहीं है, तो यह 400 गड़बड़ी वाला अनुरोध दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "commentId": string } |
| फ़ील्ड | |
|---|---|
commentId
|
उस |
DeleteCommentReplyRequest
किसी जवाब को मिटाता है
Post
किसी
CommentThread
या
SuggestionThread से.
इन मामलों में, गड़बड़ी 400: गलत अनुरोध का मैसेज दिखता है:
-
अनुरोध करने वाला उपयोगकर्ता, पोस्ट का लेखक नहीं है.
-
जवाब वाली पोस्ट में [action][google.apps.docs.v1.Post.action] शामिल है.
-
जवाब वाली पोस्ट में
assigneeमौजूद है.
| JSON के काेड में दिखाना |
|---|
{ "postId": string, "commentId": string, "suggestionId": string } |
| फ़ील्ड | |
|---|---|
postId
|
मिटाए जा रहे जवाब का आईडी
|
| उस थ्रेड का आईडी जिससे पोस्ट जुड़ी है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
commentId
|
उस |
suggestionId
|
उस |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
AcceptSuggestionRequest
सुझाव स्वीकार करता है.
अगर अनुरोध करने वाले उपयोगकर्ता के पास दस्तावेज़ में बदलाव करने का ऐक्सेस नहीं है, तो यह फ़ंक्शन 403 गड़बड़ी का मैसेज दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "suggestionId": string } |
| फ़ील्ड | |
|---|---|
suggestionId
|
सुझाव का आईडी. |
RejectSuggestionRequest
यह कुकी, किसी सुझाव को अस्वीकार करती है.
अगर अनुरोध करने वाले उपयोगकर्ता के पास दस्तावेज़ में बदलाव करने का ऐक्सेस नहीं है और वह सुझाव देने वाला व्यक्ति नहीं है, तो यह फ़ंक्शन 403 गड़बड़ी का मैसेज दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "suggestionId": string } |
| फ़ील्ड | |
|---|---|
suggestionId
|
सुझाव का आईडी. |
DeleteSuggestionRequest
यह कुकी, सुझाव को मिटाती है.
अगर अनुरोध करने वाला उपयोगकर्ता, सुझाव देने वाला व्यक्ति नहीं है, तो यह फ़ंक्शन 403 गड़बड़ी का मैसेज दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "suggestionId": string } |
| फ़ील्ड | |
|---|---|
suggestionId
|
सुझाव का आईडी. |