Requests

अनुरोध

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

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

  "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)
  },
  "addDocumentTab": {
    object (AddDocumentTabRequest)
  },
  "deleteTab": {
    object (DeleteTabRequest)
  },
  "updateDocumentTabProperties": {
    object (UpdateDocumentTabPropertiesRequest)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  },
  "updateNamedStyle": {
    object (UpdateNamedStyleRequest)
  },
  "insertRichLink": {
    object (InsertRichLinkRequest)
  },
  "insertDate": {
    object (InsertDateRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  },
  "acceptSuggestion": {
    object (AcceptSuggestionRequest)
  },
  "rejectSuggestion": {
    object (RejectSuggestionRequest)
  },
  "deleteSuggestion": {
    object (DeleteSuggestionRequest)
  }
}
फ़ील्ड
लागू करने के लिए खास अनुरोध. सिर्फ़ एक फ़ील्ड की ज़रूरत होती है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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)

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

addDocumentTab

object (AddDocumentTabRequest)

यह कुकी, दस्तावेज़ टैब जोड़ती है.

deleteTab

object (DeleteTabRequest)

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

updateDocumentTabProperties

object (UpdateDocumentTabPropertiesRequest)

यह कुकी, दस्तावेज़ टैब की प्रॉपर्टी अपडेट करती है.

insertPerson

object (InsertPersonRequest)

इससे किसी व्यक्ति का नाम टैग किया जाता है.

updateNamedStyle

object (UpdateNamedStyleRequest)

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

insertDate

object (InsertDateRequest)

यह फ़ंक्शन, तारीख डालता है.

insertComment

object (InsertCommentRequest)

दस्तावेज़ में CommentThread जोड़ता है.

addCommentReply

object (AddCommentReplyRequest)

CommentThread या SuggestionThread का जवाब जोड़ता है.

updateCommentPost

object (UpdateCommentPostRequest)

यह फ़ंक्शन, CommentThread या SuggestionThread की किसी मौजूदा पोस्ट (मुख्य पोस्ट या जवाब) को अपडेट करता है.

deleteComment

object (DeleteCommentRequest)

यह कुकी, CommentThread को मिटाती है.

deleteCommentReply

object (DeleteCommentReplyRequest)

किसी Post से मिले CommentThread या SuggestionThread जवाब को मिटाता है.

acceptSuggestion

object (AcceptSuggestionRequest)

सुझाव स्वीकार करता है.

rejectSuggestion

object (RejectSuggestionRequest)

यह कुकी, किसी सुझाव को अस्वीकार करती है.

deleteSuggestion

object (DeleteSuggestionRequest)

यह कुकी, सुझाव को मिटाती है.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

ReplaceAllTextRequest

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

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
फ़ील्ड
replaceText

string

वह टेक्स्ट जिसे मैच किए गए टेक्स्ट की जगह पर इस्तेमाल किया जाएगा.

tabsCriteria

object (TabsCriteria)

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

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

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

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

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

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

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

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

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

object (SubstringMatchCriteria)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

SubstringMatchCriteria

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

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

string

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

matchCase

boolean

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

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

boolean

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

  • True : खोजे जाने वाले टेक्स्ट को रेगुलर एक्सप्रेशन माना जाता है.
  • False : खोज के लिए इस्तेमाल किए गए टेक्स्ट को मैचिंग के लिए सबस्ट्रिंग के तौर पर माना जाता है.

TabsCriteria

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

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

string

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

InsertTextRequest

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
text

string

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

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

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

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

वह जगह जहां टेक्स्ट डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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,

  "range": {
    object (Range)
  }
}
फ़ील्ड
textStyle

object (TextStyle)

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

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

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

fields

string (FieldMask format)

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

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

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

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

इस्तेमाल की गई रेंज का टाइप, जहां टेक्स्ट स्टाइल को अपडेट किया जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 न्यूमेरिक ग्लिफ़ हैं. इसके बाद, पैरंट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)
  }
}
फ़ील्ड
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)
  },

  "namedRangeId": string,
  "name": string
}
फ़ील्ड
tabsCriteria

object (TabsCriteria)

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

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

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

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

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

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

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

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

string

मिटाने के लिए, नाम वाली रेंज का आईडी.

name

string

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

UpdateParagraphStyleRequest

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

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

  "range": {
    object (Range)
  }
}
फ़ील्ड
paragraphStyle

object (ParagraphStyle)

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

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

fields

string (FieldMask format)

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

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

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

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

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

object (Range)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

DeleteContentRangeRequest

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

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

object (Range)

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

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

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

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

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

InsertInlineImageRequest

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
uri

string

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

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

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

objectSize

object (Size)

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

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

object (Location)

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

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

InsertTableRequest

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

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
rows

integer

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

columns

integer

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

वह जगह जहां टेबल डाली जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

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

columnIndex

integer

यह 0 से शुरू होने वाला कॉलम इंडेक्स है. उदाहरण के लिए, टेबल में मौजूद दूसरे कॉलम का कॉलम इंडेक्स 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 के काेड में दिखाना
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
वह जगह जहां पेज ब्रेक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 पॉइंट (5/72 इंच) से कम है, तो गड़बड़ी का मैसेज 400 Bad Request दिखता है.

fields

string (FieldMask format)

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

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

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

UpdateTableCellStyleRequest

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

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

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
फ़ील्ड
tableCellStyle

object (TableCellStyle)

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

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

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

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

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

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

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

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

वे सेल जिन्हें अपडेट किया जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
tableRange

object (TableRange)

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

tableStartLocation

object (Location)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

TableRange

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

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

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

टेबल की सेल की जगह = (tableStartLocation, row = 0, column = 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

इस फ़ंक्शन का इस्तेमाल करके, किसी मौजूदा इमेज को नई इमेज से बदला जा सकता है.

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

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)

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

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

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

UnmergeTableCellsRequest

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

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

object (TableRange)

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

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

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

CreateHeaderRequest

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

अगर इस तरह का हेडर पहले से मौजूद है, तो गड़बड़ी का मैसेज 400 bad request दिखता है.

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

enum (HeaderFooterType)

बनाए जाने वाले हेडर का टाइप.

sectionBreakLocation

object (Location)

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

HeaderFooterType

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

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

CreateFooterRequest

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

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

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

enum (HeaderFooterType)

बनाए जाने वाले फ़ुटर का टाइप.

sectionBreakLocation

object (Location)

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

CreateFootnoteRequest

यह फ़ंक्शन, दी गई जगह पर एक नया Footnote सेगमेंट बनाता है और उसमें एक नया FootnoteReference जोड़ता है.

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
फ़ुटनोट रेफ़रंस डालने की जगह. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
location

object (Location)

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

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

ReplaceNamedRangeContentRequest

इस फ़ंक्शन का इस्तेमाल करके, बताए गए NamedRange या NamedRanges के कॉन्टेंट को बदले गए कॉन्टेंट से बदला जा सकता है.

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

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

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

  "text": string

  "namedRangeId": string,
  "namedRangeName": string
}
फ़ील्ड
tabsCriteria

object (TabsCriteria)

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

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

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

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

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

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

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

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

string

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.
उस नाम वाली रेंज का रेफ़रंस जिसका कॉन्टेंट बदला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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),

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
sectionType

enum (SectionType)

यह सेक्शन का टाइप है, जिसे डाला जाना है.

वह जगह जहां ब्रेक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 का मतलब है कि सभी लाइनें अनपिन की गई हैं.

AddDocumentTabRequest

यह कुकी, दस्तावेज़ टैब जोड़ती है. किसी इंडेक्स पर टैब जोड़ने पर, उसके बाद के सभी टैब के इंडेक्स बढ़ जाते हैं.

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

object (TabProperties)

जोड़े जाने वाले टैब की प्रॉपर्टी. सभी प्रॉपर्टी वैकल्पिक हैं.

DeleteTabRequest

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

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

string

मिटाने के लिए टैब का आईडी.

UpdateDocumentTabPropertiesRequest

किसी दस्तावेज़ टैब की प्रॉपर्टी अपडेट करें.

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

object (TabProperties)

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

fields

string (FieldMask format)

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

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

InsertPersonRequest

इससे किसी व्यक्ति का नाम टैग किया जाता है.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
personProperties

object (PersonProperties)

जिस व्यक्ति की जानकारी डालनी है उसकी प्रॉपर्टी.

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

object (Location)

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

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

किसी समीकरण में लोगों को टैग नहीं किया जा सकता.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

UpdateNamedStyleRequest

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

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

object (NamedStyle)

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

fields

string (FieldMask format)

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

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

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

किसी प्रॉपर्टी को उसकी डिफ़ॉल्ट वैल्यू पर रीसेट करने के लिए, फ़ील्ड मास्क में उसका फ़ील्ड का नाम शामिल करें. हालांकि, फ़ील्ड को अनसेट छोड़ दें. खाली TextStyle या ParagraphStyle के साथ "textStyle" या "paragraphStyle" तय करने पर, उसके सभी नेस्ट किए गए फ़ील्ड रीसेट हो जाएंगे.

tabId

string

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

InsertRichLinkRequest

इससे बताई गई जगह पर RichLink डाला जाता है.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
वह जगह जहां रिच लिंक डाला जाएगा. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
location

object (Location)

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

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

रिच लिंक को किसी समीकरण में नहीं डाला जा सकता.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

InsertDateRequest

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
फ़ील्ड
dateElementProperties

object (DateElementProperties)

तारीख की प्रॉपर्टी को शामिल करना है.

वह जगह जहां तारीख डाली जाएगी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
location

object (Location)

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

एक-दूसरे से अलग फ़ील्ड के आखिर में.

InsertCommentRequest

दस्तावेज़ में CommentThread जोड़ता है.

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

  "range": {
    object (Range)
  }
}
फ़ील्ड
content

string

टिप्पणी का टेक्स्ट, सामान्य टेक्स्ट के तौर पर.

इस टेक्स्ट कॉन्टेंट को, Docs Editor में बनाई गई टिप्पणियों की तरह ही मैनेज किया जाएगा. इसमें फ़ॉर्मैटिंग, सूचनाएं वगैरह के लिए एक जैसे तरीके इस्तेमाल किए जाएंगे.

इस फ़ील्ड को खाली नहीं छोड़ा जा सकता. साथ ही, इसमें UTF-8 कोड की 2048 से ज़्यादा यूनिट नहीं होनी चाहिए.

assigneeEmailAddress

string

ज़रूरी नहीं. टिप्पणी असाइन करने वाले व्यक्ति का ईमेल पता.

अगर आपको किसी टिप्पणी को असाइन नहीं करना है, तो इस फ़ील्ड को खाली छोड़ दें.

यह 2,048 UTF-8 कोड यूनिट से ज़्यादा नहीं होना चाहिए.

दस्तावेज़ में वह जगह जहां यह टिप्पणी की गई है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
range

object (Range)

दस्तावेज़ में मौजूद Range, इस टिप्पणी से जुड़ा है.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

AddCommentReplyRequest

Post में CommentThread या SuggestionThread के लिए जवाब डाला जाता है.

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

  "commentId": string,
  "suggestionId": string
}
फ़ील्ड
post

object (Post)

जवाब को दिखाने वाला Post.

जिस थ्रेड में जवाब जोड़ना है उसका आईडी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
commentId

string

जिस CommentThread में जवाब जोड़ना है उसका आईडी.

suggestionId

string

जिस SuggestionThread में जवाब जोड़ना है उसका आईडी.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

UpdateCommentPostRequest

यह CommentThread या SuggestionThread में मौजूद Post को अपडेट करता है.

इन मामलों में, गड़बड़ी 400: गलत अनुरोध का मैसेज दिखता है:

  • यह पोस्ट, SuggestionThread का headPost है.

  • अनुरोध करने वाला उपयोगकर्ता, पोस्ट का लेखक नहीं है.

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

  "commentId": string,
  "suggestionId": string
}
फ़ील्ड
postId

string

अपडेट की जा रही पोस्ट का आईडी.

content

string

टिप्पणी का नया टेक्स्ट, सादे टेक्स्ट के तौर पर.

इस टेक्स्ट कॉन्टेंट को, Docs Editor में बनाई गई टिप्पणियों की तरह ही मैनेज किया जाएगा. इसमें फ़ॉर्मैटिंग, सूचनाएं वगैरह के लिए एक जैसे तरीके इस्तेमाल किए जाएंगे.

इस फ़ील्ड को खाली नहीं छोड़ा जा सकता. साथ ही, इसमें UTF-8 कोड की 2048 से ज़्यादा यूनिट नहीं होनी चाहिए.

उस थ्रेड का आईडी जिससे पोस्ट जुड़ी है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
commentId

string

उस CommentThread का आईडी जिससे पोस्ट जुड़ी है.

suggestionId

string

उस SuggestionThread का आईडी जिससे पोस्ट जुड़ी है.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

DeleteCommentRequest

यह कुकी, CommentThread को मिटाती है.

अगर अनुरोध करने वाला उपयोगकर्ता, headPost का लेखक नहीं है, तो यह 400 गड़बड़ी वाला अनुरोध दिखाता है.

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

string

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

DeleteCommentReplyRequest

किसी जवाब को मिटाता है Post किसी CommentThread या SuggestionThread से.

इन मामलों में, गड़बड़ी 400: गलत अनुरोध का मैसेज दिखता है:

  • अनुरोध करने वाला उपयोगकर्ता, पोस्ट का लेखक नहीं है.

  • जवाब वाली पोस्ट में [action][google.apps.docs.v1.Post.action] शामिल है.

  • जवाब वाली पोस्ट में assignee मौजूद है.

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

  "commentId": string,
  "suggestionId": string
}
फ़ील्ड
postId

string

मिटाए जा रहे जवाब का आईडी Post.

उस थ्रेड का आईडी जिससे पोस्ट जुड़ी है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
commentId

string

उस CommentThread का आईडी जिससे पोस्ट जुड़ी है.

suggestionId

string

उस SuggestionThread का आईडी जिससे पोस्ट जुड़ी है.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

AcceptSuggestionRequest

सुझाव स्वीकार करता है.

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

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

string

सुझाव का आईडी.

RejectSuggestionRequest

यह कुकी, किसी सुझाव को अस्वीकार करती है.

अगर अनुरोध करने वाले उपयोगकर्ता के पास दस्तावेज़ में बदलाव करने का ऐक्सेस नहीं है और वह सुझाव देने वाला व्यक्ति नहीं है, तो यह फ़ंक्शन 403 गड़बड़ी का मैसेज दिखाता है.

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

string

सुझाव का आईडी.

DeleteSuggestionRequest

यह कुकी, सुझाव को मिटाती है.

अगर अनुरोध करने वाला उपयोगकर्ता, सुझाव देने वाला व्यक्ति नहीं है, तो यह फ़ंक्शन 403 गड़बड़ी का मैसेज दिखाता है.

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

string

सुझाव का आईडी.