Requests

अनुरोध

किसी दस्तावेज़ पर लागू करने के लिए एक अपडेट.

JSON के काेड में दिखाना
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
फ़ील्ड
यूनियन फ़ील्ड request. लागू करने के लिए किया गया खास अनुरोध. एक फ़ील्ड ज़रूरी है. request इनमें से कोई एक हो सकता है:
replaceAllText

object (ReplaceAllTextRequest)

बताए गए टेक्स्ट के सभी इंस्टेंस बदल देता है.

insertText

object (InsertTextRequest)

बताई गई जगह पर टेक्स्ट डालता है.

updateTextStyle

object (UpdateTextStyleRequest)

तय की गई रेंज में टेक्स्ट की स्टाइल को अपडेट करता है.

createParagraphBullets

object (CreateParagraphBulletsRequest)

पैराग्राफ़ के लिए बुलेट बनाता है.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

पैराग्राफ़ से बुलेट पॉइंट हटाता है.

createNamedRange

object (CreateNamedRangeRequest)

नाम वाली रेंज बनाता है.

deleteNamedRange

object (DeleteNamedRangeRequest)

नाम वाली रेंज मिटाता है.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

तय की गई रेंज में पैराग्राफ़ स्टाइल को अपडेट करता है.

deleteContentRange

object (DeleteContentRangeRequest)

दस्तावेज़ से कॉन्टेंट मिटाता है.

insertInlineImage

object (InsertInlineImageRequest)

तय की गई जगह पर इनलाइन इमेज डालता है.

insertTable

object (InsertTableRequest)

तय की गई जगह पर टेबल डालता है.

insertTableRow

object (InsertTableRowRequest)

टेबल में खाली लाइन जोड़ता है.

insertTableColumn

object (InsertTableColumnRequest)

टेबल में खाली कॉलम जोड़ता है.

deleteTableRow

object (DeleteTableRowRequest)

टेबल से कोई पंक्ति मिटाता है.

deleteTableColumn

object (DeleteTableColumnRequest)

टेबल से कॉलम मिटाता है.

insertPageBreak

object (InsertPageBreakRequest)

बताई गई जगह पर पेज ब्रेक डालता है.

deletePositionedObject

object (DeletePositionedObjectRequest)

दस्तावेज़ से, किसी तय जगह पर मौजूद ऑब्जेक्ट को मिटाता है.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

टेबल में कॉलम की प्रॉपर्टी अपडेट करता है.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

टेबल सेल की स्टाइल अपडेट करता है.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

टेबल में लाइन की स्टाइल अपडेट करता है.

replaceImage

object (ReplaceImageRequest)

दस्तावेज़ में मौजूद किसी इमेज को बदलता है.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

दस्तावेज़ की स्टाइल अपडेट करता है.

mergeTableCells

object (MergeTableCellsRequest)

टेबल में सेल मर्ज करता है.

unmergeTableCells

object (UnmergeTableCellsRequest)

टेबल में सेल को अनमर्ज करता है.

createHeader

object (CreateHeaderRequest)

हेडर बनाता है.

createFootnote

object (CreateFootnoteRequest)

फ़ुटनोट बनाता है.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

नाम वाली रेंज में मौजूद टेक्स्ट को बदलता है.

updateSectionStyle

object (UpdateSectionStyleRequest)

यह फ़ंक्शन, तय की गई रेंज के सेक्शन की स्टाइल को अपडेट करता है.

insertSectionBreak

object (InsertSectionBreakRequest)

यह फ़ंक्शन, बताई गई जगह पर सेक्शन ब्रेक डालता है.

deleteHeader

object (DeleteHeaderRequest)

दस्तावेज़ से हेडर मिटाता है.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

टेबल में पिन की गई हेडर पंक्तियों की संख्या अपडेट करता है.

ReplaceAllTextRequest

किसी शर्त से मैच करने वाले टेक्स्ट के सभी इंस्टेंस को replace text से बदलता है.

JSON के काेड में दिखाना
{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
फ़ील्ड
replaceText

string

वह टेक्स्ट जो मैच होने वाले टेक्स्ट की जगह लेगा.

tabsCriteria

object (TabsCriteria)

ज़रूरी नहीं. यह शर्त, यह तय करने के लिए इस्तेमाल की जाती है कि बदलाव किन टैब में होगा.

अगर यह विकल्प नहीं चुना जाता है, तो बदलाव सभी टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो बदलाव सिंगल टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह वैल्यू दी गई है, तो बदलाव, दिए गए टैब पर लागू होगा.

  • अगर इसे छोड़ दिया जाता है, तो बदलाव सभी टैब पर लागू होता है.

यूनियन फ़ील्ड criteria. बदले जाने वाले टेक्स्ट से मैच करने के लिए इस्तेमाल की जाने वाली शर्तें. criteria इनमें से कोई एक हो सकता है:
containsText

object (SubstringMatchCriteria)

दस्तावेज़ में इस सबस्ट्रिंग से मैच होने वाला टेक्स्ट ढूंढता है.

SubstringMatchCriteria

दस्तावेज़ में टेक्स्ट की किसी खास स्ट्रिंग से मैच करने वाली शर्त.

JSON के काेड में दिखाना
{
  "text": string,
  "matchCase": boolean
}
फ़ील्ड
text

string

दस्तावेज़ में खोजने के लिए टेक्स्ट.

matchCase

boolean

इससे पता चलता है कि खोज के नतीजों में, केस के हिसाब से खोज की जानी चाहिए या नहीं:

  • True : खोज के लिए इस्तेमाल होने वाले शब्दों में, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) का ध्यान रखा जाता है.
  • False : खोज केस-इनसेंसिटिव होती है.

TabsCriteria

यह शर्त तय करती है कि अनुरोध किन टैब में लागू होगा.

JSON के काेड में दिखाना
{
  "tabIds": [
    string
  ]
}
फ़ील्ड
tabIds[]

string

उन टैब आईडी की सूची जिनमें अनुरोध लागू होता है.

InsertTextRequest

बताई गई जगह पर टेक्स्ट डालता है.

JSON के काेड में दिखाना
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
text

string

डाला जाने वाला टेक्स्ट.

नई लाइन का वर्ण डालने पर, उस इंडेक्स पर एक नया Paragraph बन जाएगा. नए पैराग्राफ की पैराग्राफ स्टाइल, मौजूदा इंसर्शन इंडेक्स में मौजूद पैराग्राफ से कॉपी की जाएगी. इसमें सूचियां और बुलेट भी शामिल हैं.

डाले गए टेक्स्ट के लिए टेक्स्ट स्टाइल अपने-आप तय हो जाएंगे. आम तौर पर, आस-पास के टेक्स्ट की स्टाइल को बनाए रखा जाएगा. ज़्यादातर मामलों में, डाले गए टेक्स्ट की टेक्स्ट स्टाइल, डालने के इंडेक्स से ठीक पहले के टेक्स्ट से मेल खाएगी.

डाले गए टेक्स्ट से कुछ कंट्रोल कैरेक्टर (U+0000-U+0008, U+000C-U+001F) और यूनिकोड बेसिक मल्टीलिंगुअल प्लेन प्राइवेट यूज़ एरिया (U+E000-U+F8FF) के कैरेक्टर हटा दिए जाएंगे.

यूनियन फ़ील्ड insertion_location. वह जगह जहां टेक्स्ट डाला जाएगा. insertion_location इनमें से कोई एक हो सकता है:
location

object (Location)

दस्तावेज़ में किसी खास इंडेक्स पर टेक्स्ट डालता है.

टेक्स्ट को किसी मौजूदा Paragraph की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, टेबल के स्टार्ट इंडेक्स (यानी टेबल और उसके पहले पैराग्राफ़ के बीच) में टेक्स्ट नहीं डाला जा सकता. टेक्स्ट को पिछले पैराग्राफ़ में डाला जाना चाहिए.

endOfSegmentLocation

object (EndOfSegmentLocation)

यह हेडर, फ़ुटर, फ़ुटनोट या दस्तावेज़ के मुख्य हिस्से के आखिर में टेक्स्ट डालता है.

जगह

दस्तावेज़ में कोई खास जगह.

JSON के काेड में दिखाना
{
  "segmentId": string,
  "index": integer,
  "tabId": string
}
फ़ील्ड
segmentId

string

उस हेडर, फ़ुटर या फ़ुटनोट का आईडी जिसमें जगह की जानकारी मौजूद है. खाली सेगमेंट आईडी, दस्तावेज़ के मुख्य हिस्से को दिखाता है.

index

integer

UTF-16 कोड यूनिट में, शून्य से शुरू होने वाला इंडेक्स.

इंडेक्स, segmentId से तय किए गए सेगमेंट की शुरुआत से जुड़ा होता है.

tabId

string

वह टैब जिसमें जगह की जानकारी मौजूद है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर इसे शामिल नहीं किया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

EndOfSegmentLocation

मुख्य जानकारी देने वाले सेक्शन, हेडर, फ़ुटर या फ़ुटनोट के आखिर में. यह जगह, दस्तावेज़ के सेगमेंट में आखिरी नई लाइन से ठीक पहले होती है.

JSON के काेड में दिखाना
{
  "segmentId": string,
  "tabId": string
}
फ़ील्ड
segmentId

string

उस हेडर, फ़ुटर या फ़ुटनोट का आईडी जिसमें जगह की जानकारी मौजूद है. खाली सेगमेंट आईडी, दस्तावेज़ के मुख्य हिस्से को दिखाता है.

tabId

string

वह टैब जिसमें जगह की जानकारी मौजूद है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर टैब का नाम नहीं दिया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

UpdateTextStyleRequest

टेक्स्ट की स्टाइल अपडेट करें.

JSON के काेड में दिखाना
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
textStyle

object (TextStyle)

टेक्स्ट पर सेट की जाने वाली स्टाइल.

अगर किसी स्टाइल की वैल्यू, पैरंट स्टाइल की वैल्यू से मेल खाती है, तो उस स्टाइल को इनहेरिट करने के लिए सेट किया जाएगा.

टेक्स्ट स्टाइल में किए गए कुछ बदलावों की वजह से, Docs एडिटर के व्यवहार में भी बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, TextStyle का दस्तावेज़ देखें.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट textStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, टेक्स्ट की स्टाइल को बोल्ड में अपडेट करने के लिए, fields को "bold" पर सेट करें.

किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें, लेकिन फ़ील्ड को अनसेट रहने दें.

यूनियन फ़ील्ड insertion_location. टेक्स्ट की शैली अपडेट करने के लिए इस्तेमाल की जाने वाली रेंज का टाइप. insertion_location इनमें से कोई एक हो सकता है:
range

object (Range)

स्टाइल करने के लिए टेक्स्ट की रेंज.

रेंज को आस-पास की न्यूलाइन शामिल करने के लिए बड़ा किया जा सकता है.

अगर रेंज में पूरी तरह से किसी सूची का पैराग्राफ़ है, तो पैराग्राफ़ के बुलेट को भी मैच करने वाली टेक्स्ट स्टाइल के साथ अपडेट किया जाता है.

UpdateTextStyleRequest फ़ंक्शन में रेंज नहीं डाली जा सकतीं.

CreateParagraphBulletsRequest

यह उन सभी पैराग्राफ़ के लिए बुलेट बनाता है जो दी गई रेंज से ओवरलैप होते हैं.

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

अगर अपडेट किए जा रहे पैराग्राफ़ से ठीक पहले मौजूद पैराग्राफ़, मैच करने वाले प्रीसेट की सूची में है, तो अपडेट किए जा रहे पैराग्राफ़ को उस सूची में जोड़ दिया जाता है.

JSON के काेड में दिखाना
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
फ़ील्ड
range

object (Range)

वह रेंज जिसमें बुलेट प्रीसेट लागू करना है.

bulletPreset

enum (BulletGlyphPreset)

इस्तेमाल किए जाने वाले बुलेट ग्लिफ़ के टाइप.

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 शामिल हैं. इसके बाद, ब्रैकेट का इस्तेमाल किया गया है.
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)
  }
}
फ़ील्ड
range

object (Range)

बुलेट पॉइंट मिटाने के लिए रेंज.

CreateNamedRangeRequest

दी गई रेंज का रेफ़रंस देने वाला NamedRange बनाता है.

JSON के काेड में दिखाना
{
  "name": string,
  "range": {
    object (Range)
  }
}
फ़ील्ड
name

string

NamedRange का नाम. नामों के यूनीक होने की ज़रूरत नहीं है.

नाम में कम से कम एक और ज़्यादा से ज़्यादा 256 वर्ण होने चाहिए. इन वर्णों को UTF-16 कोड यूनिट में मेज़र किया जाता है.

range

object (Range)

वह रेंज जिस पर नाम लागू करना है.

DeleteNamedRangeRequest

किसी NamedRange को मिटाता है.

JSON के काेड में दिखाना
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
फ़ील्ड
tabsCriteria

object (TabsCriteria)

ज़रूरी नहीं. यह शर्त, यह तय करने के लिए इस्तेमाल की जाती है कि रेंज को किन टैब से मिटाना है. अगर रेंज नहीं दी जाती है, तो रेंज मिटाने की सुविधा सभी टैब पर लागू होती है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो रेंज मिटाने की कार्रवाई सिर्फ़ एक टैब पर लागू होगी.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो तय किए गए टैब से डेटा मिटाया जाएगा.

  • अगर यह पैरामीटर नहीं दिया गया है, तो डेटा की सीमा मिटाने की कार्रवाई सभी टैब पर लागू होगी.

यूनियन फ़ील्ड named_range_reference. यह वैल्यू तय करती है कि कौनसी रेंज मिटानी है. इनमें से किसी एक को सेट करना ज़रूरी है. named_range_reference इनमें से कोई एक हो सकता है:
namedRangeId

string

जिस नाम वाली रेंज को मिटाना है उसका आईडी.

name

string

मिटाए जाने वाली रेंज का नाम. दिए गए नाम वाली सभी नाम वाली रेंज मिटा दी जाएंगी.

UpdateParagraphStyleRequest

दी गई रेंज से ओवरलैप होने वाले सभी पैराग्राफ़ की स्टाइल अपडेट करें.

JSON के काेड में दिखाना
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
paragraphStyle

object (ParagraphStyle)

पैराग्राफ़ पर सेट की जाने वाली स्टाइल.

पैराग्राफ़ की स्टाइल में किए गए कुछ बदलावों की वजह से, Docs एडिटर के व्यवहार में अन्य बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, ParagraphStyle का दस्तावेज़ देखें.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट paragraphStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, पैराग्राफ़ स्टाइल की अलाइनमेंट प्रॉपर्टी को अपडेट करने के लिए, fields को "alignment" पर सेट करें.

किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें, लेकिन फ़ील्ड को अनसेट रहने दें.

यूनियन फ़ील्ड insertion_location. पैराग्राफ़ की स्टाइल अपडेट करने के लिए इस्तेमाल की जाने वाली रेंज का टाइप. insertion_location इनमें से कोई एक हो सकता है:
range

object (Range)

पैराग्राफ़ को स्टाइल देने के लिए ओवरलैप की गई रेंज.

DeleteContentRangeRequest

दस्तावेज़ से कॉन्टेंट मिटाता है.

JSON के काेड में दिखाना
{
  "range": {
    object (Range)
  }
}
फ़ील्ड
range

object (Range)

मिटाए जाने वाले कॉन्टेंट की सीमा.

पैराग्राफ़ की सीमा से परे का टेक्स्ट मिटाने पर, पैराग्राफ़ के स्टाइल, सूचियों, पोज़िशन किए गए ऑब्जेक्ट, और बुकमार्क में बदलाव हो सकते हैं. ऐसा इसलिए होता है, क्योंकि दोनों पैराग्राफ़ मर्ज हो जाते हैं.

कुछ रेंज मिटाने की कोशिश करने पर, दस्तावेज़ का स्ट्रक्चर अमान्य हो सकता है. ऐसे में, 400 गलत अनुरोध वाली गड़बड़ी का मैसेज दिखता है.

मिटाने के अमान्य अनुरोधों के कुछ उदाहरण:

  • किसी सरोगेट पेयर की एक कोड यूनिट मिटाना.
  • Body, Header, Footer, Footnote, TableCell या TableOfContents के आखिरी न्यू लाइन वर्ण को मिटाना.
  • पूरे एलिमेंट को मिटाए बिना, Table, TableOfContents या Equation के शुरुआती या आखिरी हिस्से को मिटाना.
  • एलिमेंट को मिटाए बिना, Table, TableOfContents या SectionBreak से पहले नया लाइन वर्ण मिटाना.
  • टेबल की अलग-अलग पंक्तियां या सेल मिटाना. टेबल सेल में मौजूद कॉन्टेंट को मिटाया जा सकता है.

InsertInlineImageRequest

यह फ़ंक्शन, दी गई जगह पर इमेज वाली InlineObject डालता है.

JSON के काेड में दिखाना
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
uri

string

इमेज का यूआरआई.

इमेज को डालने के समय एक बार फ़ेच किया जाता है और दस्तावेज़ में दिखाने के लिए उसकी एक कॉपी सेव की जाती है. इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, इमेज का रिज़ॉल्यूशन 25 मेगापिक्सल से ज़्यादा नहीं होना चाहिए. इमेज, PNG, JPEG या GIF फ़ॉर्मैट में होनी चाहिए.

दिया गया यूआरआई सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला होना चाहिए. साथ ही, यह ज़्यादा से ज़्यादा 2 केबी का होना चाहिए. यूआरआई को इमेज के साथ सेव किया जाता है और इसे ImageProperties.content_uri फ़ील्ड के ज़रिए दिखाया जाता है.

objectSize

object (Size)

दस्तावेज़ में इमेज का साइज़. यह प्रॉपर्टी ज़रूरी नहीं है. दस्तावेज़ में इमेज का फ़ाइनल साइज़, इन नियमों के आधार पर तय होता है: * अगर चौड़ाई या ऊंचाई में से किसी की भी वैल्यू नहीं दी गई है, तो इमेज के रिज़ॉल्यूशन के आधार पर, इमेज का डिफ़ॉल्ट साइज़ कैलकुलेट किया जाता है. * अगर एक डाइमेंशन तय किया जाता है, तो इमेज के आसपेक्ट रेशियो को बनाए रखने के लिए, दूसरे डाइमेंशन का हिसाब लगाया जाता है. * अगर चौड़ाई और ऊंचाई, दोनों की वैल्यू दी गई है, तो इमेज को दिए गए डाइमेंशन में फ़िट करने के लिए स्केल किया जाता है. साथ ही, इसका आसपेक्ट रेशियो भी बनाए रखा जाता है.

यूनियन फ़ील्ड insertion_location. वह जगह जहां इमेज डाली जाएगी. insertion_location इनमें से कोई एक हो सकता है:
location

object (Location)

दस्तावेज़ में किसी खास इंडेक्स पर इमेज डालता है.

इमेज को किसी मौजूदा Paragraph की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, इसे टेबल के स्टार्ट इंडेक्स (यानी टेबल और उसके पहले पैराग्राफ़ के बीच) में नहीं डाला जा सकता.

इनलाइन इमेज को फ़ुटनोट या समीकरण में नहीं डाला जा सकता.

endOfSegmentLocation

object (EndOfSegmentLocation)

यह हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में टेक्स्ट डालता है.

इनलाइन इमेज को फ़ुटनोट में नहीं डाला जा सकता.

InsertTableRequest

तय की गई जगह पर टेबल डालता है.

डाली गई टेबल से पहले, नया लाइन वर्ण डाला जाएगा.

JSON के काेड में दिखाना
{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
rows

integer

टेबल में पंक्तियों की संख्या.

columns

integer

टेबल में कॉलम की संख्या.

यूनियन फ़ील्ड insertion_location. वह जगह जहां टेबल डाली जाएगी. insertion_location इनमें से कोई एक हो सकता है:
location

object (Location)

टेबल को किसी खास मॉडल इंडेक्स में डालता है.

डाली गई टेबल से पहले, एक नया लाइन वर्ण डाला जाएगा. इसलिए, टेबल का स्टार्ट इंडेक्स, तय की गई जगह के इंडेक्स + 1 पर होगा.

टेबल को किसी मौजूदा Paragraph की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, इसे टेबल के स्टार्ट इंडेक्स (यानी किसी मौजूदा टेबल और उसके पहले पैराग्राफ़ के बीच) में नहीं डाला जा सकता.

टेबल को फ़ुटनोट या समीकरण में शामिल नहीं किया जा सकता.

endOfSegmentLocation

object (EndOfSegmentLocation)

दिए गए हेडर, फ़ुटर या दस्तावेज़ के मुख्य हिस्से के आखिर में टेबल डालता है. डाली गई टेबल से पहले, नया लाइन वर्ण डाला जाएगा.

फ़ुटनोट में टेबल नहीं डाली जा सकतीं.

InsertTableRowRequest

टेबल में खाली लाइन जोड़ता है.

JSON के काेड में दिखाना
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
फ़ील्ड
tableCellLocation

object (TableCellLocation)

रेफ़रंस टेबल की सेल की वह जगह जहां से पंक्तियां डाली जाएंगी.

रेफ़रंस सेल वाली पंक्ति के ऊपर (या नीचे) नई पंक्ति डाली जाएगी. अगर रेफ़रंस सेल, मर्ज की गई सेल है, तो मर्ज की गई सेल के ऊपर (या नीचे) नई पंक्ति डाली जाएगी.

insertBelow

boolean

रेफ़रंस सेल की जगह के नीचे नई लाइन डालनी है या नहीं.

  • True : सेल के नीचे डालें.
  • False : सेल के ऊपर डालें.

TableCellLocation

टेबल में किसी सेल की जगह.

JSON के काेड में दिखाना
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
फ़ील्ड
tableStartLocation

object (Location)

दस्तावेज़ में टेबल की शुरुआती जगह.

rowIndex

integer

शून्य से शुरू होने वाला पंक्ति इंडेक्स. उदाहरण के लिए, टेबल की दूसरी पंक्ति का पंक्ति इंडेक्स 1 है.

columnIndex

integer

शून्य से शुरू होने वाला कॉलम इंडेक्स. उदाहरण के लिए, टेबल के दूसरे कॉलम का कॉलम इंडेक्स 1 है.

InsertTableColumnRequest

टेबल में खाली कॉलम जोड़ता है.

JSON के काेड में दिखाना
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
फ़ील्ड
tableCellLocation

object (TableCellLocation)

रेफ़रंस टेबल की सेल की वह जगह जहां से कॉलम डाले जाएंगे.

रेफ़रंस सेल वाले कॉलम की बाईं (या दाईं) ओर नया कॉलम डाला जाएगा. अगर रेफ़रंस सेल मर्ज की गई सेल है, तो मर्ज की गई सेल की बाईं (या दाईं) ओर नया कॉलम डाला जाएगा.

insertRight

boolean

रेफ़रंस सेल की जगह की दाईं ओर नया कॉलम डालना है या नहीं.

  • True : दाईं ओर डालें.
  • False : बाईं ओर डालें.

DeleteTableRowRequest

टेबल से कोई पंक्ति मिटाता है.

JSON के काेड में दिखाना
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
फ़ील्ड
tableCellLocation

object (TableCellLocation)

रेफ़रंस टेबल की सेल की वह जगह जहां से लाइन मिटाई जाएगी.

इस सेल की पूरी पंक्ति मिटा दी जाएगी. अगर यह एक से ज़्यादा पंक्तियों में मौजूद मर्ज की गई सेल है, तो सेल में मौजूद सभी पंक्तियां मिटा दी जाएंगी. अगर इस मिटाने के बाद टेबल में कोई लाइन नहीं रहती है, तो पूरी टेबल मिटा दी जाती है.

DeleteTableColumnRequest

टेबल से कॉलम मिटाता है.

JSON के काेड में दिखाना
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
फ़ील्ड
tableCellLocation

object (TableCellLocation)

रेफ़रंस टेबल की सेल की वह जगह जहां से कॉलम मिटाया जाएगा.

इस सेल में मौजूद कॉलम मिटा दिया जाएगा. अगर यह एक से ज़्यादा कॉलम में मर्ज की गई सेल है, तो उस सेल में मौजूद सभी कॉलम मिटा दिए जाएंगे. अगर कॉलम मिटाने के बाद टेबल में कोई कॉलम नहीं रहता है, तो पूरी टेबल मिटा दी जाती है.

InsertPageBreakRequest

तय की गई जगह पर पेज ब्रेक के बाद नई लाइन डालता है.

JSON के काेड में दिखाना
{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
यूनियन फ़ील्ड insertion_location. वह जगह जहां पेज ब्रेक डाला जाएगा. insertion_location इनमें से कोई एक हो सकता है:
location

object (Location)

दस्तावेज़ में किसी खास इंडेक्स पर पेज ब्रेक डालता है.

पेज ब्रेक को किसी मौजूदा Paragraph की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, इसे टेबल के स्टार्ट इंडेक्स (यानी टेबल और उसके पहले पैराग्राफ़ के बीच) में नहीं डाला जा सकता.

टेबल, समीकरण, फ़ुटनोट, हेडर या फ़ुटर में पेज ब्रेक नहीं डाले जा सकते. पेज ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

endOfSegmentLocation

object (EndOfSegmentLocation)

दस्तावेज़ के मुख्य हिस्से के आखिर में पेज ब्रेक डालता है.

फ़ुटनोट, हेडर या फ़ुटर में पेज ब्रेक नहीं डाले जा सकते. पेज ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

DeletePositionedObjectRequest

दस्तावेज़ से किसी PositionedObject को मिटाता है.

JSON के काेड में दिखाना
{
  "objectId": string,
  "tabId": string
}
फ़ील्ड
objectId

string

मिटाए जाने वाले ऑब्जेक्ट का आईडी.

tabId

string

वह टैब जिसमें मिटाए जाने वाले ऑब्जेक्ट को पोज़िशन किया गया है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर यह पैरामीटर नहीं दिया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

UpdateTableColumnPropertiesRequest

टेबल में मौजूद कॉलम के TableColumnProperties को अपडेट करता है.

JSON के काेड में दिखाना
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
फ़ील्ड
tableStartLocation

object (Location)

दस्तावेज़ में टेबल की शुरुआती जगह.

columnIndices[]

integer

शून्य पर आधारित कॉलम इंडेक्स की सूची, जिनकी प्रॉपर्टी को अपडेट करना है. अगर कोई इंडेक्स नहीं दिया गया है, तो सभी कॉलम अपडेट हो जाएंगे.

tableColumnProperties

object (TableColumnProperties)

टेबल कॉलम की वे प्रॉपर्टी जिन्हें अपडेट करना है.

अगर tableColumnProperties#width की वैल्यू पांच पॉइंट (5/72 इंच) से कम है, तो 400 गलत अनुरोध वाली गड़बड़ी दिखती है.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट tableColumnProperties का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, कॉलम की चौड़ाई अपडेट करने के लिए, fields को "width" पर सेट करें.

UpdateTableCellStyleRequest

टेबल की सेल की रेंज की स्टाइल को अपडेट करता है.

JSON के काेड में दिखाना
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
फ़ील्ड
tableCellStyle

object (TableCellStyle)

टेबल सेल पर सेट की जाने वाली स्टाइल.

बॉर्डर अपडेट करते समय, अगर कोई सेल आस-पास की सेल के साथ बॉर्डर शेयर करती है, तो आस-पास की सेल की बॉर्डर प्रॉपर्टी भी अपडेट हो जाती है. मर्ज की गई और छिपी हुई सीमाओं को अपडेट नहीं किया जाता.

एक ही अनुरोध में, आस-पास की सेल के साथ शेयर की गई बॉर्डर को अपडेट करने से, बॉर्डर के अपडेट में अंतर हो सकता है. इसलिए, बॉर्डर के अपडेट इस क्रम में लागू किए जाते हैं:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट tableCellStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, टेबल सेल के बैकग्राउंड का रंग अपडेट करने के लिए, fields को "backgroundColor" पर सेट करें.

किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड नाम शामिल करें, लेकिन फ़ील्ड को अनसेट ही रहने दें.

यूनियन फ़ील्ड cells. वे सेल जिन्हें अपडेट किया जाएगा. cells इनमें से कोई एक हो सकता है:
tableRange

object (TableRange)

टेबल की वह रेंज जो टेबल के उस सबसेट को दिखाती है जिस पर अपडेट लागू किए जाते हैं.

tableStartLocation

object (Location)

दस्तावेज़ में टेबल की शुरुआती जगह. तय किए जाने पर, अपडेट टेबल की सभी सेल पर लागू होते हैं.

TableRange

टेबल रेंज, टेबल के सबसेट का रेफ़रंस दिखाती है.

ध्यान रखें कि टेबल रेंज से तय की गई सेल, ज़रूरी नहीं कि आयताकार हों. उदाहरण के लिए, मान लें कि हमारे पास 3 x 3 टेबल है, जिसमें आखिरी लाइन की सभी सेल एक साथ मर्ज की गई हैं. टेबल इस तरह दिखती है:

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

टेबल सेल की जगह = (tableStartLocation, पंक्ति = 0, कॉलम = 0), पंक्ति स्पैन = 3, और कॉलम स्पैन = 2 वाली टेबल रेंज में ये सेल शामिल हैं:

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON के काेड में दिखाना
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
फ़ील्ड
tableCellLocation

object (TableCellLocation)

वह सेल जहां से टेबल की रेंज शुरू होती है.

rowSpan

integer

टेबल रेंज की पंक्ति का स्पैन.

columnSpan

integer

टेबल रेंज का कॉलम स्पैन.

UpdateTableRowStyleRequest

टेबल में पंक्तियों की संख्या को अपडेट करता है.TableRowStyle

JSON के काेड में दिखाना
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
फ़ील्ड
tableStartLocation

object (Location)

दस्तावेज़ में टेबल की शुरुआती जगह.

rowIndices[]

integer

शून्य से शुरू होने वाले पंक्ति इंडेक्स की सूची, जिनकी स्टाइल अपडेट करनी है. अगर कोई इंडेक्स नहीं चुना गया है, तो सभी लाइनें अपडेट हो जाएंगी.

tableRowStyle

object (TableRowStyle)

पंक्तियों पर सेट की जाने वाली स्टाइल.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट tableRowStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, पंक्ति की कम से कम ऊंचाई अपडेट करने के लिए, fields को "minRowHeight" पर सेट करें.

ReplaceImageRequest

किसी मौजूदा इमेज को नई इमेज से बदलता है.

किसी इमेज को बदलने पर, मौजूदा इमेज से कुछ image effects हट जाते हैं. ऐसा, Docs एडिटर के काम करने के तरीके को दिखाने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}
फ़ील्ड
imageObjectId

string

मौजूदा इमेज का आईडी, जिसे बदला जाएगा. आईडी को, 'GET' अनुरोध के जवाब से वापस पाया जा सकता है.

uri

string

नई इमेज का यूआरआई.

इमेज को डालने के समय एक बार फ़ेच किया जाता है और दस्तावेज़ में दिखाने के लिए उसकी एक कॉपी सेव की जाती है. इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, इमेज का रिज़ॉल्यूशन 25 मेगापिक्सल से ज़्यादा नहीं होना चाहिए. इमेज, PNG, JPEG या GIF फ़ॉर्मैट में होनी चाहिए.

दिया गया यूआरएल 2 केबी से ज़्यादा नहीं हो सकता. यूआरआई को इमेज के साथ सेव किया जाता है और इसे ImageProperties.source_uri फ़ील्ड के ज़रिए दिखाया जाता है.

imageReplaceMethod

enum (ImageReplaceMethod)

बदलाव करने का तरीका.

tabId

string

वह टैब जिसमें बदली जाने वाली इमेज मौजूद है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर टैब का नाम नहीं दिया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

ImageReplaceMethod

इमेज बदलने का तरीका.

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED इमेज बदलने का तरीका नहीं बताया गया है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
CENTER_CROP ओरिजनल इमेज के बॉर्डर को भरने के लिए, इमेज को स्केल और सेंटर करता है. ओरिजनल इमेज के बॉउंड को भरने के लिए, इमेज को काटा जा सकता है. रेंडर की गई इमेज का साइज़, ओरिजनल इमेज के साइज़ जैसा ही होगा.

UpdateDocumentStyleRequest

DocumentStyle को अपडेट करता है.

JSON के काेड में दिखाना
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
फ़ील्ड
documentStyle

object (DocumentStyle)

दस्तावेज़ पर सेट की जाने वाली स्टाइल.

दस्तावेज़ के स्टाइल में किए गए कुछ बदलावों की वजह से, Docs एडिटर के व्यवहार में भी बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, DocumentStyle का दस्तावेज़ देखें.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट documentStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, बैकग्राउंड अपडेट करने के लिए, fields को "background" पर सेट करें.

tabId

string

वह टैब जिसमें अपडेट किया जाने वाला स्टाइल मौजूद है. अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर यह जानकारी नहीं दी जाती है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

MergeTableCellsRequest

Table में सेल को मर्ज करता है.

JSON के काेड में दिखाना
{
  "tableRange": {
    object (TableRange)
  }
}
फ़ील्ड
tableRange

object (TableRange)

टेबल की रेंज, जिसमें यह तय किया जाता है कि टेबल की किन सेल को मर्ज करना है.

मर्ज की जा रही सेल में मौजूद टेक्स्ट को जोड़कर, रेंज की "हेड" सेल में सेव कर दिया जाएगा. अगर कॉन्टेंट की दिशा बाएं से दाएं है, तो यह रेंज की सबसे ऊपर बाईं सेल होती है. अगर कॉन्टेंट की दिशा दाएं से बाएं है, तो यह रेंज की सबसे ऊपर दाईं सेल होती है.

अगर रेंज, रेक्टैंगल के आकार में नहीं है, तो 400 गलत अनुरोध वाला गड़बड़ी का कोड दिखता है. ऐसा तब हो सकता है, जब रेंज में पहले से मर्ज की गई सेल शामिल हों या टेबल रेक्टैंगल के आकार में न हो.

UnmergeTableCellsRequest

Table में सेल अनमर्ज करता है.

JSON के काेड में दिखाना
{
  "tableRange": {
    object (TableRange)
  }
}
फ़ील्ड
tableRange

object (TableRange)

टेबल की रेंज, जिसमें यह तय किया जाता है कि टेबल की किन सेल को अनमर्ज करना है.

इस रेंज में मर्ज की गई सभी सेल को अनमर्ज कर दिया जाएगा. हालांकि, पहले से अनमर्ज की गई सेल पर इसका कोई असर नहीं पड़ेगा. अगर रेंज में कोई मर्ज की गई सेल नहीं है, तो अनुरोध का कोई असर नहीं होगा.

अगर मर्ज की गई किसी सेल में टेक्स्ट है, तो वह टेक्स्ट, मर्ज नहीं की गई सेल के ब्लॉक की "हेड" सेल में बना रहेगा. अगर कॉन्टेंट की दिशा बाएं से दाएं है, तो "हेड" सेल सबसे ऊपर बाईं ओर होती है. अगर कॉन्टेंट की दिशा दाएं से बाएं है, तो "हेड" सेल सबसे ऊपर दाईं ओर होती है.

CreateHeaderRequest

इससे एक Header बनता है. अगर SectionBreak की जानकारी दी गई है, तो नया हेडर SectionStyle पर, SectionBreak की जगह पर लागू होता है. अगर SectionBreak की जानकारी नहीं दी गई है, तो यह DocumentStyle पर लागू होता है.

अगर तय किए गए टाइप का हेडर पहले से मौजूद है, तो 400 गलत अनुरोध वाली गड़बड़ी का मैसेज दिखता है.

JSON के काेड में दिखाना
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
फ़ील्ड
type

enum (HeaderFooterType)

आपको किस तरह का हेडर बनाना है.

sectionBreakLocation

object (Location)

उस SectionBreak की जगह जहां से वह सेक्शन शुरू होता है जिससे यह हेडर जुड़ा है. अगर `sectionBreakLocation' सेट नहीं है या यह दस्तावेज़ के मुख्य हिस्से में पहले सेक्शन ब्रेक का रेफ़रंस देता है, तो हेडर इन पर लागू होता है DocumentStyle

HeaderFooterType

हेडर और फ़ुटर के टाइप, जिन्हें बनाया जा सकता है.

Enums
DEFAULT डिफ़ॉल्ट हेडर/फ़ुटर.

CreateFooterRequest

इससे एक Footer बनता है. अगर SectionBreak की जानकारी दी गई है, तो नया फ़ुटर SectionBreak के स्थान पर SectionStyle पर लागू होता है. अगर SectionBreak की जानकारी नहीं दी गई है, तो यह DocumentStyle पर लागू होता है.

अगर बताए गए टाइप का फ़ुटर पहले से मौजूद है, तो 400 गलत अनुरोध वाली गड़बड़ी का मैसेज दिखता है.

JSON के काेड में दिखाना
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
फ़ील्ड
type

enum (HeaderFooterType)

फ़ुटर का टाइप.

sectionBreakLocation

object (Location)

उस सेक्शन से ठीक पहले के SectionBreak की जगह, जिसके SectionStyle से यह फ़ुटर जुड़ा होना चाहिए. अगर यह सेट नहीं है या दस्तावेज़ में पहले सेक्शन ब्रेक का रेफ़रंस दिया गया है, तो फ़ुटर, दस्तावेज़ के स्टाइल पर लागू होता है.

CreateFootnoteRequest

इससे एक Footnote सेगमेंट बनता है और उसमें दी गई जगह पर एक नया FootnoteReference डाला जाता है.

नए Footnote सेगमेंट में एक स्पेस के बाद, नया लाइन वर्ण होगा.

JSON के काेड में दिखाना
{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
फ़ील्ड
यूनियन फ़ील्ड footnote_reference_location. फ़ुटनोट रेफ़रंस डालने की जगह. footnote_reference_location इनमें से कोई एक हो सकता है:
location

object (Location)

दस्तावेज़ में किसी खास इंडेक्स पर फ़ुटनोट का रेफ़रंस डालता है.

फ़ुटनोट रेफ़रंस को किसी मौजूदा Paragraph के दायरे में डाला जाना चाहिए. उदाहरण के लिए, इसे टेबल के स्टार्ट इंडेक्स (यानी टेबल और उसके पहले पैराग्राफ़ के बीच) में नहीं डाला जा सकता.

फ़ुटनोट के रेफ़रंस, किसी समीकरण, हेडर, फ़ुटर या फ़ुटनोट में नहीं डाले जा सकते. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

endOfSegmentLocation

object (EndOfSegmentLocation)

दस्तावेज़ के मुख्य हिस्से के आखिर में फ़ुटनोट का रेफ़रंस डालता है.

फ़ुटनोट के रेफ़रंस, हेडर, फ़ुटर या फ़ुटनोट में नहीं डाले जा सकते. फ़ुटनोट के रेफ़रंस सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

ReplaceNamedRangeContentRequest

बताए गए NamedRange या NamedRanges के कॉन्टेंट को, दिए गए बदले गए कॉन्टेंट से बदलता है.

ध्यान दें कि किसी व्यक्ति के एक से ज़्यादा NamedRange हो सकते हैं.ranges इस मामले में, सिर्फ़ पहली रेंज में मौजूद कॉन्टेंट बदला जाएगा. अन्य रेंज और उनका कॉन्टेंट मिटा दिया जाएगा.

अगर किसी रेंज को बदलने या मिटाने से दस्तावेज़ का स्ट्रक्चर अमान्य हो जाता है, तो 400 गलत अनुरोध वाली गड़बड़ी का कोड दिखता है.

JSON के काेड में दिखाना
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
फ़ील्ड
tabsCriteria

object (TabsCriteria)

ज़रूरी नहीं. यह शर्त, यह तय करने के लिए इस्तेमाल की जाती है कि बदलाव किन टैब में होगा. अगर यह विकल्प नहीं चुना जाता है, तो बदलाव सभी टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो बदलाव सिंगल टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह वैल्यू दी गई है, तो बदलाव, दिए गए टैब पर लागू होगा.

  • अगर इसे छोड़ दिया जाता है, तो बदलाव सभी टैब पर लागू होता है.

यूनियन फ़ील्ड replacement_content. नाम वाली रेंज के मौजूदा कॉन्टेंट को बदलने के लिए कॉन्टेंट. replacement_content इनमें से कोई एक हो सकता है:
text

string

नाम वाली किसी रेंज के कॉन्टेंट को दिए गए टेक्स्ट से बदलता है.

यूनियन फ़ील्ड named_range_reference. नाम वाली उन रेंज का रेफ़रंस जिनका कॉन्टेंट बदला जाएगा. named_range_reference इनमें से कोई एक हो सकता है:
namedRangeId

string

नाम वाली उस रेंज का आईडी जिसका कॉन्टेंट बदला जाएगा.

अगर दिए गए आईडी के साथ कोई नाम वाली रेंज नहीं है, तो 400 गलत अनुरोध वाली गड़बड़ी दिखती है.

namedRangeName

string

उस NamedRanges का नाम जिसका कॉन्टेंट बदला जाएगा.

अगर दिए गए नाम वाले एक से ज़्यादा named ranges हैं, तो हर एक का कॉन्टेंट बदल दिया जाएगा. अगर दिए गए नाम वाली कोई नाम वाली रेंज नहीं है, तो अनुरोध पूरा नहीं किया जाएगा.

UpdateSectionStyleRequest

SectionStyle को अपडेट करता है.

JSON के काेड में दिखाना
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
फ़ील्ड
range

object (Range)

स्टाइल करने के लिए, सेक्शन को ओवरलैप करने वाली रेंज.

सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

sectionStyle

object (SectionStyle)

सेक्शन पर सेट की जाने वाली स्टाइल.

सेक्शन की स्टाइल में किए गए कुछ बदलावों की वजह से, Docs एडिटर के व्यवहार में भी बदलाव हो सकते हैं. ज़्यादा जानकारी के लिए, SectionStyle का दस्तावेज़ देखें.

fields

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट करना चाहिए.

कम से कम एक फ़ील्ड की जानकारी देना ज़रूरी है. रूट sectionStyle का मतलब है और इसे बताने की ज़रूरत नहीं है. हर फ़ील्ड को सूची में शामिल करने के लिए, एक "*" का इस्तेमाल शॉर्टहैंड के तौर पर किया जा सकता है.

उदाहरण के लिए, बाएं मार्जिन को अपडेट करने के लिए, fields को "marginLeft" पर सेट करें.

InsertSectionBreakRequest

यह टैग, दी गई जगह पर सेक्शन ब्रेक डालता है.

सेक्शन ब्रेक से पहले, नया लाइन वर्ण डाला जाएगा.

JSON के काेड में दिखाना
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
फ़ील्ड
sectionType

enum (SectionType)

डाले जाने वाले सेक्शन का टाइप.

यूनियन फ़ील्ड insertion_location. वह जगह जहां ब्रेक डाला जाएगा. insertion_location इनमें से कोई एक हो सकता है:
location

object (Location)

दस्तावेज़ में किसी खास इंडेक्स पर, नया लाइन और सेक्शन ब्रेक डालता है.

सेक्शन ब्रेक को किसी मौजूदा Paragraph के अंदर डाला जाना चाहिए. उदाहरण के लिए, इसे टेबल के स्टार्ट इंडेक्स (यानी टेबल और उसके पहले पैराग्राफ़ के बीच) में नहीं डाला जा सकता.

सेक्शन ब्रेक को टेबल, समीकरण, फ़ुटनोट, हेडर या फ़ुटर में नहीं डाला जा सकता. सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

endOfSegmentLocation

object (EndOfSegmentLocation)

दस्तावेज़ के मुख्य हिस्से के आखिर में, एक नया लाइन और सेक्शन ब्रेक डालता है.

सेक्शन ब्रेक को फ़ुटनोट, हेडर या फ़ुटर में नहीं डाला जा सकता. सेक्शन ब्रेक सिर्फ़ मुख्य हिस्से में डाले जा सकते हैं. इसलिए, segment ID फ़ील्ड खाली होना चाहिए.

DeleteHeaderRequest

दस्तावेज़ से किसी Header को मिटाता है.

JSON के काेड में दिखाना
{
  "headerId": string,
  "tabId": string
}
फ़ील्ड
headerId

string

मिटाए जाने वाले हेडर का आईडी. अगर यह हेडर DocumentStyle पर तय किया गया है, तो इस हेडर का रेफ़रंस हटा दिया जाता है. इस वजह से, दस्तावेज़ के पहले सेक्शन के लिए उस टाइप का कोई हेडर नहीं होता. अगर यह हेडर किसी SectionStyle पर तय किया गया है, तो इस हेडर का रेफ़रंस हटा दिया जाता है और उस टाइप का हेडर अब पिछले सेक्शन से जारी रखा जाता है.

tabId

string

वह टैब जिसमें मौजूद हेडर को मिटाना है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर इसे शामिल नहीं किया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

DeleteFooterRequest

दस्तावेज़ से किसी Footer को मिटाता है.

JSON के काेड में दिखाना
{
  "footerId": string,
  "tabId": string
}
फ़ील्ड
footerId

string

मिटाए जाने वाले फ़ुटर का आईडी. अगर इस फ़ुटर को DocumentStyle पर तय किया गया है, तो इस फ़ुटर का रेफ़रंस हटा दिया जाता है. इस वजह से, दस्तावेज़ के पहले सेक्शन के लिए उस टाइप का कोई फ़ुटर नहीं होता. अगर यह फ़ुटर किसी SectionStyle पर तय किया गया है, तो इस फ़ुटर का रेफ़रंस हटा दिया जाता है और उस टाइप का फ़ुटर अब पिछले सेक्शन से जारी रखा जाता है.

tabId

string

वह टैब जिसमें मौजूद फ़ुटर को मिटाना है. अगर टैब नहीं चुना जाता है, तो अनुरोध पहले टैब पर लागू होता है.

एक टैब वाले दस्तावेज़ में:

  • अगर दिया गया है, तो यह एकल टैब के आईडी से मेल खाना चाहिए.

  • अगर इसे छोड़ दिया जाता है, तो अनुरोध सिर्फ़ एक टैब पर लागू होता है.

एक से ज़्यादा टैब वाले दस्तावेज़ में:

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध उस टैब पर लागू होगा.

  • अगर यह पैरामीटर नहीं दिया जाता है, तो अनुरोध दस्तावेज़ के पहले टैब पर लागू होता है.

PinTableHeaderRowsRequest

टेबल में पिन की गई टेबल हेडर पंक्तियों की संख्या अपडेट करता है.

JSON के काेड में दिखाना
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
फ़ील्ड
tableStartLocation

object (Location)

दस्तावेज़ में टेबल की शुरुआती जगह.

pinnedHeaderRowsCount

integer

पिन की जाने वाली टेबल लाइनों की संख्या. 0 का मतलब है कि सभी लाइनें अनपिन की गई हैं.