Requests

अनुरोध

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

जेएसओएन के काेड में दिखाना 
{

  // 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)

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

सभी टेक्स्ट रिक्वेस्ट को बदलें

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

जेएसओएन के काेड में दिखाना 
{
  "replaceText": string,

  // 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

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

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

object (SubstringMatchCriteria)

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

सबस्ट्रिंग मैच मानदंड

ऐसा मानदंड जो दस्तावेज़ में मौजूद टेक्स्ट की किसी खास स्ट्रिंग से मेल खाता हो.

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

string

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

matchCase

boolean

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

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

InsertTextRequest

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

जगह

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

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

string

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

index

integer

UTF-16 कोड यूनिट में शून्य पर आधारित इंडेक्स.

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

एंड ऑफ़ सेगमेंटलोकेशन

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

जेएसओएन के काेड में दिखाना 
{
  "segmentId": string
}
फ़ील्ड
segmentId

string

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

UpdateTextStyleRequest है

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

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

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

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

बुलेटGlyphPreset

सूचियों के लिए, बुलेट ग्लिफ़ के प्रीसेट पैटर्न.

इन पैटर्न में, इस तरह के बुलेट का इस्तेमाल किया जाता है:

  • ARROW : यूनिकोड U+2794 कोड पॉइंट से जुड़ा एक तीर
  • ARROW3D : यूनिकोड U+27a2 कोड पॉइंट के अनुसार 3D शेडिंग वाला तीर
  • CHECKBOX : यूनिकोड U+274f कोड पॉइंट से जुड़ा एक खाली वर्ग
  • CIRCLE : यूनिकोड U+25cb कोड पॉइंट से जुड़ा एक खाली सर्कल
  • DIAMOND : यूनिकोड का U+25c6 कोड पॉइंट की तरह एक ठोस हीरा
  • DIAMONDX : यूनिकोड U+2756 कोड पॉइंट से जुड़ा 'x' वाला हीरा
  • 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 शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_DIAMONDX_ARROW3D_SQUARE बुलेट वाली सूची में DIAMONDX, ARROW3D और SQUARE शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_CHECKBOX बुलेट वाली सूची में, CHECKBOX सभी नेस्टिंग लेवल के लिए बुलेट ग्लिफ़.
BULLET_ARROW_DIAMOND_DISC बुलेट वाली सूची में ARROW, DIAMOND और DISC शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_STAR_CIRCLE_SQUARE बुलेट वाली सूची में STAR, CIRCLE और SQUARE शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_ARROW3D_CIRCLE_SQUARE बुलेट वाली सूची में ARROW3D, CIRCLE और SQUARE शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_LEFTTRIANGLE_DIAMOND_DISC बुलेट वाली सूची में LEFTTRIANGLE, DIAMOND और DISC शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE बुलेट वाली सूची में DIAMONDX, HOLLOWDIAMOND और SQUARE शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
BULLET_DIAMOND_CIRCLE_SQUARE बुलेट वाली सूची में DIAMOND, CIRCLE और SQUARE शुरुआती 3 सूची नेस्टिंग लेवल के लिए, बुलेट ग्लिफ़.
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

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

हर पैराग्राफ़ का नेस्टिंग लेवल, पैराग्राफ़ की शुरुआत में इंडेंट जोड़कर, विज़ुअल तौर पर सुरक्षित रहेगा.

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

object (Range)

वह रेंज जिसमें से बुलेट मिटाना है.

CreateNamedRangeRequest

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

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

string

NamedRange का नाम. यह ज़रूरी नहीं है कि नाम अलग हों.

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

range

object (Range)

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

DeleteNamedRangeRequest

NamedRange मिटाता है.

जेएसओएन के काेड में दिखाना 
{

  // 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.
}
फ़ील्ड
यूनियन फ़ील्ड named_range_reference. वह वैल्यू जो मिटाई जाने वाली रेंज या रेंज को तय करती है. ठीक एक सेट होना चाहिए. named_range_reference इनमें से सिर्फ़ एक हो सकता है:
namedRangeId

string

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

name

string

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

अपडेट ParagraphStyleRequest

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

मिटाएं ContentRangeRequest

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

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

object (Range)

कॉन्टेंट की वह रेंज जिसे मिटाना है.

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

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

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

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

इनलाइन इमेज अनुरोध डालें

दी गई जगह में इमेज वाला InlineObject डाला जाता है.

जेएसओएन के काेड में दिखाना 
{
  "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

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

सम्मिलित तालिका के पहले एक नई पंक्ति का वर्ण डाला जाएगा.

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

टेबलसेल स्थान

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

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

object (Location)

वह जगह जहां टेबल, दस्तावेज़ में शुरू होती है.

rowIndex

integer

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

columnIndex

integer

शून्य पर आधारित कॉलम इंडेक्स. उदाहरण के लिए, टेबल में दूसरे कॉलम में एक कॉलम इंडेक्स है.

InsertTableColumnRequest

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

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

object (TableCellLocation)

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

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

insertRight

boolean

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

  • True : दाईं ओर डालें.
  • False : बाईं ओर शामिल करें.

DeleteTableRowRequest

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

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

object (TableCellLocation)

रेफ़रंस टेबल की उस सेल में रखी गई जगह जहां से पंक्ति को मिटा दिया जाएगा.

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

DeleteTableColumnRequest

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

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

object (TableCellLocation)

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

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

InsertPageBreakRequest

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

जेएसओएन के काेड में दिखाना 
{

  // 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 को मिटाता है.

जेएसओएन के काेड में दिखाना 
{
  "objectId": string
}
फ़ील्ड
objectId

string

उस ऑब्जेक्ट का आईडी जिसे मिटाना है.

अपडेट टेबल कॉलम प्रॉपर्टी का अनुरोध

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

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

object (Location)

वह जगह जहां टेबल, दस्तावेज़ में शुरू होती है.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

अपडेट करने के लिए टेबल कॉलम की प्रॉपर्टी.

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

fields

string (FieldMask format)

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

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

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

UpdateTableCellStyleRequest

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

टेबल रेंज

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

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

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

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

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

object (TableCellLocation)

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

rowSpan

integer

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

columnSpan

integer

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

UpdateTableRowStyleRequest

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

जेएसओएन के काेड में दिखाना 
{
  "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" पर सेट करें.

इमेज अनुरोध बदलें

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

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

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

string

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

uri

string

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

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

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

imageReplaceMethod

enum (ImageReplaceMethod)

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

ImageReplaceMethod

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

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

UpdateDocumentStyleRequest

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

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

object (DocumentStyle)

दस्तावेज़ पर सेट की जाने वाली शैलियां.

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

fields

string (FieldMask format)

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

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

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

MergeTableCellsRequest

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

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

object (TableRange)

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

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

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

UnMergeTableCellsRequest

Table में मौजूद सेल को अनमर्ज किया जाता है.

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

object (TableRange)

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

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

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

बनाएं हेडर अनुरोध

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

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

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

enum (HeaderFooterType)

किस तरह का हेडर बनाया जाना चाहिए.

sectionBreakLocation

object (Location)

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

हेडर फ़ुटर टाइप

इस तरह के हेडर और फ़ुटर बनाए जा सकते हैं.

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

फ़ुटर अनुरोध बनाएं

Footer बनाता है. अगर नया फ़ुटर, SectionBreak की जगह पर SectionStyle लागू होता है, तो उसे DocumentStyle पर लागू कर दिया जाता है.

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

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

enum (HeaderFooterType)

किस तरह का फ़ुटर बनाना है.

sectionBreakLocation

object (Location)

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

CreateFootnoteRequest

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

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

जेएसओएन के काेड में दिखाना 
{

  // 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 फ़ील्ड खाली होना चाहिए.

बदलेंNamedRangeContentRequest

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

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

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

जेएसओएन के काेड में दिखाना 
{

  // 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.
}
फ़ील्ड
यूनियन फ़ील्ड replacement_content. कॉन्टेंट को, नाम वाले रेंज के मौजूदा कॉन्टेंट से बदलने के लिए. replacement_content इनमें से सिर्फ़ एक हो सकता है:
text

string

बताई गई श्रेणी(सीमाओं) के कॉन्टेंट को, दिए गए टेक्स्ट से बदलता है.

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

string

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

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

namedRangeName

string

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

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

अपडेट का सेक्शन स्टाइल अनुरोध

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

जेएसओएन के काेड में दिखाना 
{
  "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

दी गई जगह में सेक्शन ब्रेक डालता है.

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

जेएसओएन के काेड में दिखाना 
{
  "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 फ़ील्ड खाली होना चाहिए.

मिटाएं हेडर का अनुरोध

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

जेएसओएन के काेड में दिखाना 
{
  "headerId": string
}
फ़ील्ड
headerId

string

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

मिटाने का अनुरोध मिटाएं

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

जेएसओएन के काेड में दिखाना 
{
  "footerId": string
}
फ़ील्ड
footerId

string

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

पिनटेबल हेडर पंक्ति अनुरोध

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

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

object (Location)

वह जगह जहां टेबल, दस्तावेज़ में शुरू होती है.

pinnedHeaderRowsCount

integer

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