REST Resource: documents

संसाधन: दस्तावेज़

Google Docs का कोई दस्तावेज़.

JSON के काेड में दिखाना
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
फ़ील्ड
documentId

string

सिर्फ़ आउटपुट के लिए. दस्तावेज़ का आईडी.

title

string

दस्तावेज़ का टाइटल.

tabs[]

object (Tab)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद टैब.

टैब में चाइल्ड टैब हो सकते हैं. चाइल्ड टैब का मतलब है कि एक टैब के अंदर दूसरा टैब. चाइल्ड टैब को Tab.childTabs फ़ील्ड से दिखाया जाता है.

revisionId

string

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

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

suggestionsViewMode

enum (SuggestionsViewMode)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ पर सुझाव देखने का मोड लागू किया गया है.

ध्यान दें: किसी दस्तावेज़ में बदलाव करते समय, बदलाव SUGGESTIONS_INLINE वाले दस्तावेज़ के आधार पर होने चाहिए.

commentsViewMode

enum (CommentsViewMode)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ पर लागू किया गया टिप्पणियां देखने का मोड.

comments[]

object (CommentThread)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ से जुड़ी टिप्पणियां. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब commentsViewMode पैरामीटर को टिप्पणियां ज़रूरी हैं (जैसे कि COMMENTS_VIEW_MODE_INCLUDED) पर सेट किया गया हो.

suggestions[]

object (SuggestionThread)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ से जुड़े सुझाव. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब commentsViewMode पैरामीटर को टिप्पणियां ज़रूरी हैं (जैसे कि COMMENTS_VIEW_MODE_INCLUDED) पर सेट किया गया हो.

body

object (Body)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ का मुख्य हिस्सा.

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.body का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

headers

map (key: string, value: object (Header))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.headers का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

footers

map (key: string, value: object (Footer))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.footers का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

footnotes

map (key: string, value: object (Footnote))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.footnotes का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

documentStyle

object (DocumentStyle)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ की स्टाइल.

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.documentStyle का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.suggestedDocumentStyleChanges का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

namedStyles

object (NamedStyles)

सिर्फ़ आउटपुट के लिए. दस्तावेज़ की स्टाइल के नाम.

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.namedStyles का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.suggestedNamedStylesChanges का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

lists

map (key: string, value: object (List))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.lists का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

namedRanges

map (key: string, value: object (NamedRanges))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.namedRanges का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

inlineObjects

map (key: string, value: object (InlineObject))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.inlineObjects का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

positionedObjects

map (key: string, value: object (PositionedObject))

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

लेगसी फ़ील्ड: इसके बजाय, Document.tabs.documentTab.positionedObjects का इस्तेमाल करें. इससे, includeTabsContent पैरामीटर को true पर सेट करने पर, सभी टैब से दस्तावेज़ का असली कॉन्टेंट दिखता है. अगर false या unset है, तो इस फ़ील्ड में दस्तावेज़ के पहले टैब के बारे में जानकारी होती है.

टैब

दस्तावेज़ में मौजूद कोई टैब.

JSON के काेड में दिखाना
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  "documentTab": {
    object (DocumentTab)
  }
}
फ़ील्ड
tabProperties

object (TabProperties)

टैब की प्रॉपर्टी, जैसे कि आईडी और टाइटल.

childTabs[]

object (Tab)

इस टैब में नेस्ट किए गए चाइल्ड टैब.

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

object (DocumentTab)

दस्तावेज़ के कॉन्टेंट वाला टैब, जैसे कि टेक्स्ट और इमेज.

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

TabProperties

टैब की प्रॉपर्टी.

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

string

टैब का ऐसा आईडी जिसे बदला नहीं जा सकता.

title

string

टैब का वह नाम जो उपयोगकर्ता को दिखता है.

parentTabId

string

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

index

integer

पैरंट में मौजूद टैब का ज़ीरो-आधारित इंडेक्स.

nestingLevel

integer

सिर्फ़ आउटपुट के लिए. दस्तावेज़ में टैब की डेप्थ. रूट-लेवल टैब 0 से शुरू होते हैं.

iconEmoji

string

ज़रूरी नहीं. टैब के साथ दिखाया गया इमोजी आइकॉन. मान्य इमोजी आइकॉन को, खाली नहीं छोड़ी गई यूनिकोड स्ट्रिंग से दिखाया जाता है. वर्णों का ऐसा कोई भी सेट अमान्य होता है जो किसी एक इमोजी को नहीं दिखाता.

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

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

DocumentTab

दस्तावेज़ के कॉन्टेंट वाला टैब.

JSON के काेड में दिखाना
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  },
  "commentAnchors": {
    string: {
      object (CommentAnchor)
    },
    ...
  }
}
फ़ील्ड
body

object (Body)

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

headers

map (key: string, value: object (Header))

दस्तावेज़ के टैब में मौजूद हेडर, हेडर आईडी के हिसाब से क्रम में लगाए गए हैं.

footers

map (key: string, value: object (Footer))

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

footnotes

map (key: string, value: object (Footnote))

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

documentStyle

object (DocumentStyle)

दस्तावेज़ टैब की स्टाइल.

suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

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

namedStyles

object (NamedStyles)

दस्तावेज़ टैब के नाम वाले स्टाइल.

suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

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

lists

map (key: string, value: object (List))

दस्तावेज़ टैब में मौजूद सूचियां, सूची के आईडी के हिसाब से क्रम में लगाई गई हैं.

namedRanges

map (key: string, value: object (NamedRanges))

दस्तावेज़ टैब में मौजूद नाम वाली रेंज, नाम के हिसाब से क्रम में लगाई गई हैं.

inlineObjects

map (key: string, value: object (InlineObject))

दस्तावेज़ के टैब में मौजूद इनलाइन ऑब्जेक्ट, जिन्हें ऑब्जेक्ट आईडी के हिसाब से क्रम में लगाया गया है.

positionedObjects

map (key: string, value: object (PositionedObject))

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

commentAnchors

map (key: string, value: object (CommentAnchor))

दस्तावेज़ टैब में टिप्पणी के ऐंकर, ऐंकर आईडी के हिसाब से क्रम में लगाए जाते हैं. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब commentsViewMode पैरामीटर को टिप्पणियां ज़रूरी हैं (जैसे कि COMMENTS_VIEW_MODE_INCLUDED) पर सेट किया गया हो.

Body

दस्तावेज़ का मुख्य हिस्सा.

मुख्य हिस्से में आम तौर पर, पूरे दस्तावेज़ का कॉन्टेंट होता है. हालांकि, इसमें headers, footers, और footnotes शामिल नहीं होते.

JSON के काेड में दिखाना
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
फ़ील्ड
content[]

object (StructuralElement)

मुख्य कॉन्टेंट.

बॉडी के कॉन्टेंट के इंडेक्स, शून्य से शुरू होते हैं.

StructuralElement

StructuralElement, दस्तावेज़ को स्ट्रक्चर देने वाले कॉन्टेंट के बारे में बताता है.

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

  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
}
फ़ील्ड
startIndex

integer

यह स्ट्रक्चरल एलिमेंट का ज़ीरो-आधारित स्टार्ट इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

endIndex

integer

यह स्ट्रक्चरल एलिमेंट का ज़ीरो-आधारित एंड इंडेक्स है. यह UTF-16 कोड यूनिट में शामिल नहीं है.

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

object (Paragraph)

यह पैराग्राफ़ टाइप का स्ट्रक्चरल एलिमेंट होता है.

sectionBreak

object (SectionBreak)

यह स्ट्रक्चरल एलिमेंट का सेक्शन ब्रेक टाइप है.

table

object (Table)

यह स्ट्रक्चरल एलिमेंट का टेबल टाइप होता है.

tableOfContents

object (TableOfContents)

यह विषय सूची के टाइप का स्ट्रक्चरल एलिमेंट है.

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

पैराग्राफ़

StructuralElement, किसी पैराग्राफ़ को दिखाता है. पैराग्राफ़, कॉन्टेंट की एक रेंज होती है. यह नई लाइन वाले वर्ण के साथ खत्म होती है.

JSON के काेड में दिखाना
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
फ़ील्ड
elements[]

object (ParagraphElement)

पैराग्राफ़ का कॉन्टेंट, जिसे उसके कॉम्पोनेंट के हिसाब से बांटा गया है.

paragraphStyle

object (ParagraphStyle)

इस पैराग्राफ़ की स्टाइल.

suggestedParagraphStyleChanges

map (key: string, value: object (SuggestedParagraphStyle))

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

bullet

object (Bullet)

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

suggestedBulletChanges

map (key: string, value: object (SuggestedBullet))

इस पैराग्राफ़ की बुलेट में सुझाए गए बदलाव.

positionedObjectIds[]

string

इस पैराग्राफ़ से जुड़े, पोज़िशन किए गए ऑब्जेक्ट के आईडी.

suggestedPositionedObjectIds

map (key: string, value: object (ObjectReferences))

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

ParagraphElement

ParagraphElement, Paragraph में मौजूद कॉन्टेंट के बारे में बताता है.

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

  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  },
  "dateElement": {
    object (DateElement)
  }
}
फ़ील्ड
startIndex

integer

यह पैराग्राफ़ एलिमेंट का ज़ीरो-आधारित स्टार्ट इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

endIndex

integer

यह पैराग्राफ़ एलिमेंट का ज़ीरो-बेस वाला आखिरी इंडेक्स है. यह UTF-16 कोड यूनिट में होता है और इसमें शामिल नहीं होता.

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

object (TextRun)

यह टेक्स्ट रन पैराग्राफ़ एलिमेंट है.

autoText

object (AutoText)

अपने-आप लिखा गया पैराग्राफ़ एलिमेंट.

pageBreak

object (PageBreak)

यह पेज ब्रेक पैराग्राफ़ एलिमेंट है.

columnBreak

object (ColumnBreak)

यह कॉलम ब्रेक पैराग्राफ़ एलिमेंट है.

footnoteReference

object (FootnoteReference)

यह फ़ुटनोट रेफ़रंस पैराग्राफ़ एलिमेंट है.

horizontalRule

object (HorizontalRule)

हॉरिज़ॉन्टल रूल पैराग्राफ़ एलिमेंट.

equation

object (Equation)

यह एक इक्वेशन पैराग्राफ़ एलिमेंट है.

inlineObjectElement

object (InlineObjectElement)

यह एक इनलाइन ऑब्जेक्ट पैराग्राफ़ एलिमेंट है.

person

object (Person)

यह पैराग्राफ़ एलिमेंट है, जो किसी व्यक्ति या ईमेल पते से लिंक होता है.

dateElement

object (DateElement)

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

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

TextRun

एक ParagraphElement, जो एक ही स्टाइल वाले टेक्स्ट के रन को दिखाता है.

JSON के काेड में दिखाना
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
content

string

इस रन का टेक्स्ट.

रन में मौजूद टेक्स्ट के अलावा अन्य सभी एलिमेंट को यूनिकोड वर्ण U+E907 से बदल दिया जाता है.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस रन का टेक्स्ट स्टाइल.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

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

TextStyle

यह टेक्स्ट पर लागू की जा सकने वाली स्टाइल को दिखाता है.

इस मैसेज में, इनहेरिट की गई टेक्स्ट स्टाइल को 'सेट नहीं किया गया' फ़ील्ड के तौर पर दिखाया जाता है. किसी टेक्स्ट स्टाइल का पैरंट, इस बात पर निर्भर करता है कि टेक्स्ट स्टाइल कहां तय की गई है:

  • Paragraph में मौजूद टेक्स्ट की TextStyle, पैराग्राफ़ के named style type से मिलती है.
  • named style पर मौजूद TextStyle, normal text नाम वाली स्टाइल से इनहेरिट होती है.
  • normal text नाम वाली स्टाइल का TextStyle, Docs एडिटर में मौजूद डिफ़ॉल्ट टेक्स्ट स्टाइल से इनहेरिट होता है.
  • टेबल में मौजूद Paragraph एलिमेंट की TextStyle, टेबल स्टाइल से टेक्स्ट स्टाइल इनहेरिट कर सकती है.

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

JSON के काेड में दिखाना
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
फ़ील्ड
bold

boolean

इससे पता चलता है कि टेक्स्ट को बोल्ड के तौर पर रेंडर किया गया है या नहीं.

italic

boolean

इससे पता चलता है कि टेक्स्ट को इटैलिक किया गया है या नहीं.

underline

boolean

इससे पता चलता है कि टेक्स्ट को अंडरलाइन किया गया है या नहीं.

strikethrough

boolean

टेक्स्ट पर स्ट्राइकथ्रू का निशान लगा है या नहीं.

smallCaps

boolean

टेक्स्ट छोटे कैपिटल लेटर में है या नहीं.

backgroundColor

object (OptionalColor)

टेक्स्ट के बैकग्राउंड का रंग. अगर यह सेट है, तो रंग या तो आरजीबी रंग होता है या color फ़ील्ड के आधार पर पारदर्शी होता है.

foregroundColor

object (OptionalColor)

टेक्स्ट का फ़ोरग्राउंड रंग. अगर यह सेट है, तो रंग या तो आरजीबी रंग होता है या color फ़ील्ड के आधार पर पारदर्शी होता है.

fontSize

object (Dimension)

टेक्स्ट के फ़ॉन्ट का साइज़.

weightedFontFamily

object (WeightedFontFamily)

टेक्स्ट की फ़ॉन्ट फ़ैमिली और रेंडर किया गया वेट.

अगर अपडेट करने के अनुरोध में weightedFontFamily और bold, दोनों के लिए वैल्यू दी गई हैं, तो पहले weightedFontFamily और फिर bold लागू होगा.

अगर weightedFontFamily#weight सेट नहीं है, तो डिफ़ॉल्ट रूप से 400 लागू हो जाता है.

अगर weightedFontFamily को सेट किया गया है, तो weightedFontFamily#fontFamily को भी सेट करना ज़रूरी है. साथ ही, इसकी वैल्यू खाली नहीं होनी चाहिए. ऐसा न होने पर, 400 वाली गड़बड़ी का मैसेज दिखता है.

baselineOffset

enum (BaselineOffset)

टेक्स्ट का वर्टिकल ऑफ़सेट, जो उसकी सामान्य जगह से होता है.

SUPERSCRIPT या SUBSCRIPT बेसलाइन ऑफ़सेट वाले टेक्स्ट को छोटे फ़ॉन्ट साइज़ में अपने-आप रेंडर किया जाता है. इसकी गिनती fontSize फ़ील्ड के आधार पर की जाती है. इस फ़ील्ड में किए गए बदलावों का असर fontSize पर नहीं पड़ता.

OptionalColor

ऐसा रंग जो पूरी तरह से अपारदर्शी या पूरी तरह से पारदर्शी हो सकता है.

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

object (Color)

अगर इसे सेट किया जाता है, तो इसका इस्तेमाल ओपेक रंग के तौर पर किया जाएगा. अगर इसे सेट नहीं किया जाता है, तो यह पारदर्शी रंग को दिखाता है.

रंग

एक सॉलिड रंग.

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

object (RgbColor)

आरजीबी कलर वैल्यू.

RgbColor

आरजीबी कलर.

JSON के काेड में दिखाना
{
  "red": number,
  "green": number,
  "blue": number
}
फ़ील्ड
red

number

कलर का लाल कॉम्पोनेंट, 0.0 से 1.0 तक.

green

number

यह रंग का हरा कॉम्पोनेंट है. इसकी वैल्यू 0.0 से 1.0 तक होती है.

blue

number

कलर का नीला कॉम्पोनेंट, 0.0 से 1.0 तक.

डाइमेंशन

तय की गई इकाइयों में, किसी एक दिशा में मौजूद मैग्नीट्यूड.

JSON के काेड में दिखाना
{
  "magnitude": number,
  "unit": enum (Unit)
}
फ़ील्ड
magnitude

number

मैग्नीट्यूड.

unit

enum (Unit)

मैग्नीट्यूड की इकाइयां.

इकाई

माप की इकाइयों पर टैप करें.

Enums
UNIT_UNSPECIFIED यूनिट की जानकारी नहीं है.
PT एक पॉइंट, जो 1/72 इंच होता है.

WeightedFontFamily

यह टेक्स्ट की फ़ॉन्ट फ़ैमिली और वेट को दिखाता है.

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

string

टेक्स्ट की फ़ॉन्ट फ़ैमिली.

फ़ॉन्ट फ़ैमिली, Docs के फ़ॉन्ट मेन्यू में मौजूद कोई भी फ़ॉन्ट या Google Fonts में मौजूद कोई भी फ़ॉन्ट हो सकती है. अगर फ़ॉन्ट के नाम की पहचान नहीं हो पाती है, तो टेक्स्ट को Arial में रेंडर किया जाता है.

weight

integer

फ़ॉन्ट की मोटाई. इस फ़ील्ड में, 100 से 900 के बीच की कोई भी ऐसी वैल्यू हो सकती है जो 100 का गुणज हो. यह रेंज, सीएसएस 2.1 स्पेसिफ़िकेशन के सेक्शन 15.6 में बताई गई संख्यात्मक वैल्यू के हिसाब से होती है. इसमें गैर-संख्यात्मक वैल्यू इस्तेमाल करने की अनुमति नहीं है.

डिफ़ॉल्ट वैल्यू 400 ("normal") होती है.

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

  • अगर टेक्स्ट बोल्ड है और उसका वज़न 400 से कम है, तो रेंडर किया गया वज़न 400 होगा.
  • अगर टेक्स्ट बोल्ड है और उसका वेट 400 से ज़्यादा या इसके बराबर है, लेकिन 700 से कम है, तो रेंडर किया गया वेट 700 होगा.
  • अगर वज़न 700 से ज़्यादा या इसके बराबर है, तो रेंडर किया गया वज़न, वज़न के बराबर होता है.
  • अगर टेक्स्ट बोल्ड नहीं है, तो रेंडर किया गया वज़न, वज़न के बराबर होता है.

BaselineOffset

टेक्स्ट को उसकी सामान्य जगह से वर्टिकल तौर पर ऑफ़सेट करने के तरीके.

Enums
BASELINE_OFFSET_UNSPECIFIED टेक्स्ट के बेसलाइन ऑफ़सेट को पैरंट से इनहेरिट किया जाता है.
NONE टेक्स्ट को वर्टिकल तौर पर ऑफ़सेट नहीं किया गया है.
SUPERSCRIPT टेक्स्ट को वर्टिकल तौर पर ऊपर की ओर ऑफ़सेट किया गया है (सुपरस्क्रिप्ट).
SUBSCRIPT टेक्स्ट को वर्टिकल तौर पर नीचे की ओर ऑफ़सेट किया जाता है (सबस्क्रिप्ट).

SuggestedTextStyle

TextStyle में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
फ़ील्ड
textStyle

object (TextStyle)

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

textStyleSuggestionState

object (TextStyleSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस TextStyle के किन फ़ील्ड में बदलाव किया गया है.

TextStyleSuggestionState

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

JSON के काेड में दिखाना
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
फ़ील्ड
boldSuggested

boolean

इससे पता चलता है कि bold में बदलाव का कोई सुझाव दिया गया था या नहीं.

italicSuggested

boolean

इससे पता चलता है कि italic में बदलाव का कोई सुझाव दिया गया था या नहीं.

underlineSuggested

boolean

इससे पता चलता है कि underline में बदलाव का कोई सुझाव दिया गया था या नहीं.

strikethroughSuggested

boolean

इससे पता चलता है कि strikethrough में बदलाव का कोई सुझाव दिया गया था या नहीं.

smallCapsSuggested

boolean

इससे पता चलता है कि smallCaps में बदलाव का कोई सुझाव दिया गया था या नहीं.

backgroundColorSuggested

boolean

इससे पता चलता है कि backgroundColor में बदलाव का कोई सुझाव दिया गया था या नहीं.

foregroundColorSuggested

boolean

इससे पता चलता है कि foregroundColor में बदलाव का कोई सुझाव दिया गया था या नहीं.

fontSizeSuggested

boolean

इससे पता चलता है कि fontSize में बदलाव का कोई सुझाव दिया गया था या नहीं.

weightedFontFamilySuggested

boolean

इससे पता चलता है कि weightedFontFamily में बदलाव का कोई सुझाव दिया गया था या नहीं.

baselineOffsetSuggested

boolean

इससे पता चलता है कि baselineOffset में बदलाव का कोई सुझाव दिया गया था या नहीं.

AutoText

ParagraphElement, टेक्स्ट में ऐसी जगह को दिखाता है जहां लगातार अपडेट होने वाला कॉन्टेंट अपने-आप बदलता रहता है. जैसे, पेज नंबर.

JSON के काेड में दिखाना
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
type

enum (Type)

यह अपने-आप भरने वाले टेक्स्ट का टाइप है.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस AutoText की टेक्स्ट स्टाइल.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, इस ऑटोटेक्स्ट में बदल जाती है. इसे सुझाव के आईडी के हिसाब से सेट किया जाता है.

टाइप

ऑटो टेक्स्ट के टाइप.

Enums
TYPE_UNSPECIFIED अपने-आप लिखे गए लेख का टाइप नहीं बताया गया है.
PAGE_NUMBER मौजूदा पेज नंबर दिखाने वाले ऑटो टेक्स्ट के लिए टाइप करें.
PAGE_COUNT ऑटो टेक्स्ट का टाइप, जो दस्तावेज़ में मौजूद पेजों की कुल संख्या दिखाता है.

PageBreak

ParagraphElement, पेज ब्रेक को दिखाता है. पेज ब्रेक से, इसके बाद का टेक्स्ट अगले पेज की शुरुआत में दिखता है.

JSON के काेड में दिखाना
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस PageBreak की टेक्स्ट स्टाइल.

टेक्स्ट कॉन्टेंट, जैसे कि टेक्स्ट रन और फ़ुटनोट के रेफ़रंस की तरह ही, पेज ब्रेक की टेक्स्ट स्टाइल से कॉन्टेंट के लेआउट पर असर पड़ सकता है. साथ ही, इससे पेज ब्रेक के बगल में डाले गए टेक्स्ट की स्टाइल पर भी असर पड़ सकता है.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, सुझाव आईडी के हिसाब से इस PageBreak में बदल जाती है.

ColumnBreak

कॉलम ब्रेक दिखाने वाला ParagraphElement. कॉलम ब्रेक की मदद से, इसके बाद के टेक्स्ट को अगले कॉलम की शुरुआत में रखा जा सकता है.

JSON के काेड में दिखाना
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस ColumnBreak की टेक्स्ट स्टाइल.

टेक्स्ट कॉन्टेंट की तरह ही, कॉलम ब्रेक की टेक्स्ट स्टाइल से कॉन्टेंट के लेआउट पर असर पड़ सकता है. जैसे, टेक्स्ट रन और फ़ुटनोट के रेफ़रंस. साथ ही, इससे कॉलम ब्रेक के बगल में डाले गए टेक्स्ट की स्टाइल पर भी असर पड़ सकता है.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, सुझाव आईडी के हिसाब से इस ColumnBreak में बदल जाती है.

FootnoteReference

ParagraphElement, फ़ुटनोट रेफ़रंस दिखाता है. फ़ुटनोट रेफ़रंस, एक ऐसा इनलाइन कॉन्टेंट होता है जिसे किसी संख्या के साथ रेंडर किया जाता है. इसका इस्तेमाल फ़ुटनोट की पहचान करने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
footnoteId

string

उस footnote का आईडी जिसमें इस फ़ुटनोट रेफ़रंस का कॉन्टेंट शामिल है.

footnoteNumber

string

इस फ़ुटनोट का रेंडर किया गया नंबर.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस FootnoteReference का टेक्स्ट स्टाइल.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, इस FootnoteReference में बदल जाती है. इसे सुझाव के आईडी के हिसाब से सेट किया जाता है.

HorizontalRule

ParagraphElement, हॉरिज़ॉन्टल लाइन को दिखाता है.

JSON के काेड में दिखाना
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस HorizontalRule की टेक्स्ट स्टाइल.

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

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, इस HorizontalRule में बदल जाती है. इसे सुझाव के आईडी के हिसाब से कुंजी दी जाती है.

समीकरण

ParagraphElement, किसी समीकरण को दिखाता है.

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

string

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

suggestedDeletionIds[]

string

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

InlineObjectElement

एक ParagraphElement जिसमें InlineObject शामिल है.

JSON के काेड में दिखाना
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
फ़ील्ड
inlineObjectId

string

InlineObject में मौजूद एलिमेंट का आईडी.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस InlineObjectElement के टेक्स्ट की स्टाइल.

टेक्स्ट कॉन्टेंट, जैसे कि टेक्स्ट रन और फ़ुटनोट के रेफ़रंस की तरह ही, इनलाइन ऑब्जेक्ट एलिमेंट की टेक्स्ट स्टाइल से कॉन्टेंट के लेआउट पर असर पड़ सकता है. साथ ही, इससे उसके बगल में डाले गए टेक्स्ट की स्टाइलिंग पर भी असर पड़ सकता है.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, इस InlineObject में बदल जाती है. इसे सुझाव के आईडी के हिसाब से कुंजी दी जाती है.

व्यक्ति

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

JSON के काेड में दिखाना
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
फ़ील्ड
personId

string

सिर्फ़ आउटपुट के लिए. इस लिंक का यूनीक आईडी.

suggestedInsertionIds[]

string

उन सुझावों के आईडी जो इस व्यक्ति के लिंक को दस्तावेज़ में डालते हैं. अगर Person, नेस्ट किया गया सुझाया गया बदलाव है (उदाहरण के लिए, किसी दूसरे उपयोगकर्ता के सुझाव में दिया गया सुझाव), तो इसमें एक से ज़्यादा इंसर्शन आईडी हो सकते हैं. अगर यह खाली है, तो इसका मतलब है कि इस व्यक्ति के लिंक को सुझाव के तौर पर नहीं डाला गया है.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस Person के टेक्स्ट की स्टाइल.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, सुझाव आईडी के हिसाब से इस Person में बदल जाती है.

personProperties

object (PersonProperties)

सिर्फ़ आउटपुट के लिए. इस Person की प्रॉपर्टी. यह फ़ील्ड हमेशा मौजूद होता है.

PersonProperties

लिंक किए गए Person से जुड़ी प्रॉपर्टी.

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

string

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

email

string

इस Person से लिंक किया गया ईमेल पता. यह फ़ील्ड हमेशा मौजूद होता है.

RichLinkProperties

RichLink से जुड़ी प्रॉपर्टी.

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

string

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

uri

string

RichLink का यूआरआई. यह हमेशा मौजूद होता है.

mimeType

string

अगर RichLink का एमआईएमई टाइप मौजूद है, तो उसे यहां दिखाया जाता है. उदाहरण के लिए, Drive में मौजूद फ़ाइल का एमआईएमई टाइप.

DateElement

किसी दस्तावेज़ में बताई गई तारीख.

JSON के काेड में दिखाना
{
  "dateId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "suggestedDateElementPropertiesChanges": {
    string: {
      object (SuggestedDateElementProperties)
    },
    ...
  }
}
फ़ील्ड
dateId

string

सिर्फ़ आउटपुट के लिए. इस तारीख का यूनीक आईडी.

suggestedInsertionIds[]

string

उन सुझावों के आईडी जो इस तारीख को दस्तावेज़ में डालते हैं. अगर DateElement, नेस्ट किया गया सुझाया गया बदलाव है (उदाहरण के लिए, किसी दूसरे उपयोगकर्ता के सुझाव में दिया गया सुझाव), तो इसमें एक से ज़्यादा insertionId हो सकते हैं. अगर यह खाली है, तो इसका मतलब है कि इस तारीख को विज्ञापन दिखाने का सुझाव नहीं दिया गया है.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

इस DateElement का टेक्स्ट स्टाइल.

suggestedTextStyleChanges

map (key: string, value: object (SuggestedTextStyle))

सुझाए गए टेक्स्ट की स्टाइल, इस DateElement में बदल जाती है. इसे सुझाव आईडी के हिसाब से कुंजी दी जाती है.

dateElementProperties

object (DateElementProperties)

इस DateElement की प्रॉपर्टी.

suggestedDateElementPropertiesChanges

map (key: string, value: object (SuggestedDateElementProperties))

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

DateElementProperties

DateElement की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "timestamp": string,
  "timeZoneId": string,
  "locale": string,
  "dateFormat": enum (DateFormat),
  "timeFormat": enum (TimeFormat),
  "displayText": string
}
फ़ील्ड
timestamp

string (Timestamp format)

यह वैल्यू, Unix epoch के बाद से सेकंड और नैनोसेकंड में दिखाई जाती है. Unix epoch, 1 जनवरी, 1970 को आधी रात यूटीसी से शुरू होता है.

टाइमस्टैंप यूटीसी में होना चाहिए. अगर timeZoneId सेट है, तो टाइमस्टैंप को टाइम ज़ोन के हिसाब से अडजस्ट किया जाता है. उदाहरण के लिए, DATE_FORMAT_ISO8601 तारीख के फ़ॉर्मैट और TIME_FORMAT_HOUR_MINUTE समय के फ़ॉर्मैट वाले 18000 टाइमस्टैंप को 1970-01-01 5:00 AM के तौर पर दिखाया जाएगा. 18000 टाइमस्टैंप में, तारीख का फ़ॉर्मैट DATE_FORMAT_ISO8601, समय का फ़ॉर्मैट TIME_FORMAT_HOUR_MINUTE, और टाइम ज़ोन America/New_York पर सेट है. हालांकि, इसे 1970-01-01 12:00 AM के तौर पर दिखाया जाएगा.

timeZoneId

string

DateElement का टाइम ज़ोन, जिसे यूनिकोड कॉमन लोकल डेटा रिपॉज़िटरी (सीएलडीआर) प्रोजेक्ट के हिसाब से तय किया जाता है. उदाहरण के लिए, America/New_York. अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट टाइम ज़ोन etc/UTC होता है.

locale

string

DateElement का भाषा कोड. उदाहरण के लिए, en. अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट स्थान-भाषा en होती है.

यह सुविधा इन भाषाओं में उपलब्ध है: af, am, ar, as, az, be, bg, bn, ca, cs, da, de, el, en, en-CA, en-GB, es, es-419, et, eu, fa, fi, fil, fr, fr-CA, gl, gu, hi, hr, hu, hy, id, is, it, iw, ja, ka, kk, km, kn, ko, lo, lt, lv, mk, ml, mn, mr, ms, ne, nl, no, or, pa, pl, pt-BR, pt-PT, ro, ru, si, sk, sl, sq, sr, sv, sw, ta, te, th, tr, uk, ur, uz, vi, zh-CN, zh-HK, zh-TW, zu, cy, my.

dateFormat

enum (DateFormat)

इससे यह तय होता है कि दस्तावेज़ में DateElement का तारीख वाला हिस्सा कैसे दिखेगा.

अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट वैल्यू DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED होती है. इससे पता चलता है कि DateElement को en में MMM d, y के तौर पर फ़ॉर्मैट किया जाएगा या स्थानीय भाषा के हिसाब से फ़ॉर्मैट किया जाएगा.

timeFormat

enum (TimeFormat)

इससे यह तय होता है कि दस्तावेज़ में DateElement का समय वाला हिस्सा कैसे दिखेगा.

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

displayText

string

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि दस्तावेज़ में DateElement कैसे दिखता है.

DateFormat

DateElement के लिए तारीख के संभावित फ़ॉर्मैट.

Enums
DATE_FORMAT_UNSPECIFIED तारीख का फ़ॉर्मैट नहीं बताया गया है.
DATE_FORMAT_CUSTOM सिर्फ़ आउटपुट के लिए. तारीख का फ़ॉर्मैट, किसी बाहरी सोर्स से इंपोर्ट किया जाता है.
DATE_FORMAT_MONTH_DAY_ABBREVIATED तारीख का फ़ॉर्मैट, महीने के नाम का छोटा रूप और उसके बाद दिन होता है. उदाहरण के लिए, "1 जनवरी".
DATE_FORMAT_MONTH_DAY_FULL तारीख का फ़ॉर्मैट, महीना और उसके बाद दिन होता है. उदाहरण के लिए, "01 जनवरी".
DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED तारीख का फ़ॉर्मैट, महीने के नाम का छोटा रूप, उसके बाद दिन, और फिर साल होता है. उदाहरण के लिए, "1 जनवरी, 1970".
DATE_FORMAT_ISO8601 तारीख का फ़ॉर्मैट ISO 8601 फ़ॉर्मैट में है. उदाहरण के लिए, "1970-01-01".

TimeFormat

DateElement के लिए, समय के ये फ़ॉर्मैट इस्तेमाल किए जा सकते हैं.

Enums
TIME_FORMAT_UNSPECIFIED समय का फ़ॉर्मैट नहीं दिया गया है.
TIME_FORMAT_DISABLED इससे पता चलता है कि तारीख में समय शामिल नहीं है.
TIME_FORMAT_HOUR_MINUTE टाइम फ़ॉर्मैट में घंटा और मिनट दिखता है. उदाहरण के लिए, "1 जनवरी, 1970 दोपहर 12:00 बजे".
TIME_FORMAT_HOUR_MINUTE_TIMEZONE टाइम फ़ॉर्मैट में घंटा, मिनट, और टाइमज़ोन दिखता है. उदाहरण के लिए, "1 जनवरी, 1970 दोपहर 12:00 बजे यूटीसी".

SuggestedDateElementProperties

DateElementProperties में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "dateElementPropertiesSuggestionState": {
    object (DateElementPropertiesSuggestionState)
  }
}
फ़ील्ड
dateElementProperties

object (DateElementProperties)

DateElementProperties जिसमें सिर्फ़ इस सुझाव में किए गए बदलाव शामिल हों. इसका इस्तेमाल dateElementPropertiesSuggestionState के साथ किया जा सकता है. इससे यह पता चलता है कि किन फ़ील्ड में बदलाव हुआ है और उनकी नई वैल्यू क्या हैं.

dateElementPropertiesSuggestionState

object (DateElementPropertiesSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस DateElementProperties के किन फ़ील्ड में बदलाव किया गया है.

DateElementPropertiesSuggestionState

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

JSON के काेड में दिखाना
{
  "timestampSuggested": boolean,
  "timeZoneIdSuggested": boolean,
  "localeSuggested": boolean,
  "dateFormatSuggested": boolean,
  "timeFormatSuggested": boolean
}
फ़ील्ड
timestampSuggested

boolean

इससे पता चलता है कि timestamp में बदलाव का कोई सुझाव दिया गया था या नहीं.

timeZoneIdSuggested

boolean

इससे पता चलता है कि timeZoneId में बदलाव का कोई सुझाव दिया गया था या नहीं.

localeSuggested

boolean

इससे पता चलता है कि locale में बदलाव का कोई सुझाव दिया गया था या नहीं.

dateFormatSuggested

boolean

इससे पता चलता है कि dateFormat में बदलाव का कोई सुझाव दिया गया था या नहीं.

timeFormatSuggested

boolean

इससे पता चलता है कि timeFormat में बदलाव का कोई सुझाव दिया गया था या नहीं.

ParagraphStyle

ऐसी स्टाइल जो पूरे पैराग्राफ़ पर लागू होती हैं.

इस मैसेज में, इनहेरिट की गई पैराग्राफ़ स्टाइल को 'सेट नहीं किया गया' फ़ील्ड के तौर पर दिखाया जाता है. पैराग्राफ़ स्टाइल का पैरंट, इस बात पर निर्भर करता है कि पैराग्राफ़ स्टाइल कहां तय की गई है:

  • Paragraph पर मौजूद ParagraphStyle, पैराग्राफ़ के named style type से इनहेरिट होता है.
  • named style पर मौजूद ParagraphStyle, normal text नाम की स्टाइल से इनहेरिट होता है.
  • normal text नाम वाली स्टाइल का ParagraphStyle, Docs एडिटर में डिफ़ॉल्ट पैराग्राफ़ स्टाइल से इनहेरिट होता है.
  • टेबल में मौजूद Paragraph एलिमेंट का ParagraphStyle, टेबल स्टाइल से पैराग्राफ़ स्टाइल इनहेरिट कर सकता है.

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

JSON के काेड में दिखाना
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
फ़ील्ड
headingId

string

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

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

namedStyleType

enum (NamedStyleType)

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

स्टाइल के टाइप का नाम अपडेट करने से, ParagraphStyle की अन्य प्रॉपर्टी पर असर पड़ता है. इसलिए, अन्य प्रॉपर्टी अपडेट करने से पहले, स्टाइल के टाइप का नाम लागू किया जाता है.

alignment

enum (Alignment)

इस पैराग्राफ़ के लिए टेक्स्ट अलाइनमेंट.

lineSpacing

number

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

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

पैराग्राफ़ के लिए स्पेसिंग मोड.

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

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

borderBetween

object (ParagraphBorder)

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

बॉर्डर के बीच का हिस्सा तब रेंडर होता है, जब आस-पास के पैराग्राफ़ में बॉर्डर और इंडेंट की प्रॉपर्टी एक जैसी होती हैं.

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

borderTop

object (ParagraphBorder)

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

ऊपरी बॉर्डर तब रेंडर होता है, जब ऊपर वाले पैराग्राफ़ में बॉर्डर और इंडेंट की प्रॉपर्टी अलग-अलग होती हैं.

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

borderBottom

object (ParagraphBorder)

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

नीचे दिए गए पैराग्राफ़ में बॉर्डर और इंडेंट की प्रॉपर्टी अलग-अलग होने पर, बॉटम बॉर्डर रेंडर होता है.

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

borderLeft

object (ParagraphBorder)

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

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

borderRight

object (ParagraphBorder)

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

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

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

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

indentEnd

object (Dimension)

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

tabStops[]

object (TabStop)

इस पैराग्राफ़ के लिए टैब स्टॉप की सूची. टैब स्टॉप की सूची इनहेरिट नहीं की जाती है.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

keepLinesTogether

boolean

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

keepWithNext

boolean

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

avoidWidowAndOrphan

boolean

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

shading

object (Shading)

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

pageBreakBefore

boolean

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

Table, Header, Footer, और Footnote जैसे देशों/इलाकों में पैराग्राफ़ के लिए pageBreakBefore अपडेट करने की कोशिश करने पर, दस्तावेज़ की स्थिति अमान्य हो सकती है. इससे, गड़बड़ी का मैसेज '400 Bad Request' मिलता है.

NamedStyleType

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

Enums
NAMED_STYLE_TYPE_UNSPECIFIED स्टाइल के टाइप की जानकारी नहीं दी गई है.
NORMAL_TEXT सामान्य टेक्स्ट.
TITLE टाइटल.
SUBTITLE सबटाइटल.
HEADING_1 हेडिंग 1.
HEADING_2 हेडिंग 2.
HEADING_3 हेडिंग 3.
HEADING_4 हेडिंग 4.
HEADING_5 पांचवीं हेडिंग.
HEADING_6 हेडिंग 6.

अलाइनमेंट

किसी पैराग्राफ़ के लिए टेक्स्ट अलाइनमेंट के टाइप.

Enums
ALIGNMENT_UNSPECIFIED पैराग्राफ़ अलाइनमेंट को पैरंट से इनहेरिट किया जाता है.
START पैराग्राफ़ को लाइन की शुरुआत में अलाइन किया गया है. एलटीआर टेक्स्ट के लिए बाईं ओर अलाइन किया गया है. इसके अलावा, अन्य टेक्स्ट के लिए दाईं ओर अलाइन किया गया है.
CENTER पैराग्राफ़ को बीच में अलाइन किया गया है.
END पैराग्राफ़ को लाइन के आखिर में अलाइन किया गया है. एलटीआर टेक्स्ट के लिए, राइट-अलाइन किया गया है. इसके अलावा, लेफ्ट-अलाइन किया गया है.
JUSTIFIED पैराग्राफ़ को जस्टिफ़ाई किया गया है.

ContentDirection

दिशा-निर्देशों का कॉन्टेंट इसमें शामिल किया जा सकता है.

Enums
CONTENT_DIRECTION_UNSPECIFIED कॉन्टेंट की दिशा के बारे में नहीं बताया गया है.
LEFT_TO_RIGHT कॉन्टेंट को बाईं से दाईं ओर दिखाया जाता है.
RIGHT_TO_LEFT कॉन्टेंट दाईं से बाईं ओर जाता है.

SpacingMode

पैराग्राफ़ के बीच की दूरी के लिए अलग-अलग मोड.

Enums
SPACING_MODE_UNSPECIFIED स्पेसिंग मोड को पैरंट से इनहेरिट किया जाता है.
NEVER_COLLAPSE पैराग्राफ़ के बीच की जगह हमेशा रेंडर होती है.
COLLAPSE_LISTS सूची के एलिमेंट के बीच पैराग्राफ़ की स्पेसिंग नहीं होती.

ParagraphBorder

किसी पैराग्राफ़ के चारों ओर बॉर्डर.

JSON के काेड में दिखाना
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
फ़ील्ड
color

object (OptionalColor)

बॉर्डर का रंग.

width

object (Dimension)

बॉर्डर की चौड़ाई.

padding

object (Dimension)

बॉर्डर की पैडिंग.

dashStyle

enum (DashStyle)

बॉर्डर की डैश स्टाइल.

DashStyle

इस विकल्प की मदद से, यह तय किया जा सकता है कि लीनियर ज्यामिति को किस तरह के डैश के साथ रेंडर किया जा सकता है. ये वैल्यू, "Office Open XML File Formats - Fundamentals and Markup Language Reference" के सेक्शन 20.1.10.49 में बताए गए "ST_PresetLineDashVal" सिंपल टाइप पर आधारित होती हैं. यह ECMA-376 के पांचवें वर्शन के पहले हिस्से में मौजूद है.

Enums
DASH_STYLE_UNSPECIFIED डैश स्टाइल की जानकारी नहीं दी गई है.
SOLID गहरी लाइन. यह ECMA-376 ST_PresetLineDashVal वैल्यू 'solid' से मेल खाती है. यह डिफ़ॉल्ट डैश स्टाइल है.
DOT बिंदुओं वाली लाइन. यह ECMA-376 ST_PresetLineDashVal वैल्यू 'dot' से मेल खाती है.
DASH डैश वाली लाइन. यह ECMA-376 ST_PresetLineDashVal वैल्यू 'dash' से मेल खाती है.

TabStop

किसी पैराग्राफ़ में टैब स्टॉप.

JSON के काेड में दिखाना
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
फ़ील्ड
offset

object (Dimension)

इस टैब स्टॉप और मार्जिन की शुरुआत के बीच का ऑफ़सेट.

alignment

enum (TabStopAlignment)

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

TabStopAlignment

टैब स्टॉप का अलाइनमेंट.

Enums
TAB_STOP_ALIGNMENT_UNSPECIFIED टैब स्टॉप के अलाइनमेंट की जानकारी नहीं दी गई है.
START टैब स्टॉप, लाइन की शुरुआत में अलाइन होता है. यह डिफ़ॉल्ट रूप से होता है.
CENTER टैब स्टॉप को लाइन के बीच में अलाइन किया जाता है.
END टैब स्टॉप, लाइन के आखिर में अलाइन किया जाता है.

शेडिंग

किसी पैराग्राफ़ की शेडिंग.

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

object (OptionalColor)

इस पैराग्राफ़ की शेडिंग के बैकग्राउंड का रंग.

SuggestedParagraphStyle

ParagraphStyle में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
फ़ील्ड
paragraphStyle

object (ParagraphStyle)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस ParagraphStyle के किन फ़ील्ड में बदलाव किया गया है.

ParagraphStyleSuggestionState

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

JSON के काेड में दिखाना
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
फ़ील्ड
headingIdSuggested

boolean

इससे पता चलता है कि headingId में बदलाव का कोई सुझाव दिया गया था या नहीं.

namedStyleTypeSuggested

boolean

इससे पता चलता है कि namedStyleType में बदलाव का कोई सुझाव दिया गया था या नहीं.

alignmentSuggested

boolean

इससे पता चलता है कि alignment में बदलाव का कोई सुझाव दिया गया था या नहीं.

lineSpacingSuggested

boolean

इससे पता चलता है कि lineSpacing में बदलाव का कोई सुझाव दिया गया था या नहीं.

directionSuggested

boolean

इससे पता चलता है कि direction में बदलाव का कोई सुझाव दिया गया था या नहीं.

spacingModeSuggested

boolean

इससे पता चलता है कि spacingMode में बदलाव का कोई सुझाव दिया गया था या नहीं.

spaceAboveSuggested

boolean

इससे पता चलता है कि spaceAbove में बदलाव का कोई सुझाव दिया गया था या नहीं.

spaceBelowSuggested

boolean

इससे पता चलता है कि spaceBelow में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderBetweenSuggested

boolean

इससे पता चलता है कि borderBetween में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderTopSuggested

boolean

इससे पता चलता है कि borderTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderBottomSuggested

boolean

इससे पता चलता है कि borderBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderLeftSuggested

boolean

इससे पता चलता है कि borderLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderRightSuggested

boolean

इससे पता चलता है कि borderRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

indentFirstLineSuggested

boolean

इससे पता चलता है कि indentFirstLine में बदलाव का कोई सुझाव दिया गया था या नहीं.

indentStartSuggested

boolean

इससे पता चलता है कि indentStart में बदलाव का कोई सुझाव दिया गया था या नहीं.

indentEndSuggested

boolean

इससे पता चलता है कि indentEnd में बदलाव का कोई सुझाव दिया गया था या नहीं.

keepLinesTogetherSuggested

boolean

इससे पता चलता है कि keepLinesTogether में बदलाव का कोई सुझाव दिया गया था या नहीं.

keepWithNextSuggested

boolean

इससे पता चलता है कि keepWithNext में बदलाव का कोई सुझाव दिया गया था या नहीं.

avoidWidowAndOrphanSuggested

boolean

इससे पता चलता है कि avoidWidowAndOrphan में बदलाव का कोई सुझाव दिया गया था या नहीं.

shadingSuggestionState

object (ShadingSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में shading के किन फ़ील्ड में बदलाव किया गया है.

pageBreakBeforeSuggested

boolean

इससे पता चलता है कि pageBreakBefore में बदलाव का कोई सुझाव दिया गया था या नहीं.

ShadingSuggestionState

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

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

boolean

इससे पता चलता है कि Shading में बदलाव का कोई सुझाव दिया गया था या नहीं.

बुलेट

यह किसी पैराग्राफ़ के बुलेट के बारे में बताता है.

JSON के काेड में दिखाना
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}
फ़ील्ड
listId

string

उस सूची का आईडी जिससे यह पैराग्राफ़ जुड़ा है.

nestingLevel

integer

सूची में इस पैराग्राफ़ का नेस्टिंग लेवल.

textStyle

object (TextStyle)

इस बुलेट पर पैराग्राफ़ के हिसाब से लागू की गई टेक्स्ट स्टाइल.

SuggestedBullet

Bullet में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
फ़ील्ड
bullet

object (Bullet)

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

bulletSuggestionState

object (BulletSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस Bullet के किन फ़ील्ड में बदलाव किया गया है.

BulletSuggestionState

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

JSON के काेड में दिखाना
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
फ़ील्ड
listIdSuggested

boolean

इससे पता चलता है कि listId में बदलाव का कोई सुझाव दिया गया था या नहीं.

nestingLevelSuggested

boolean

इससे पता चलता है कि nestingLevel में बदलाव का कोई सुझाव दिया गया था या नहीं.

textStyleSuggestionState

object (TextStyleSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में text style के किन फ़ील्ड में बदलाव किया गया है.

ObjectReferences

ऑब्जेक्ट आईडी का कलेक्शन.

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

string

ऑब्जेक्ट आईडी.

SectionBreak

StructuralElement, सेक्शन ब्रेक को दिखाता है. सेक्शन, कॉन्टेंट की एक रेंज होती है. इसमें एक ही तरह का SectionStyle होता है. सेक्शन ब्रेक से नए सेक्शन की शुरुआत होती है. साथ ही, सेक्शन ब्रेक के बाद वाले सेक्शन पर सेक्शन स्टाइल लागू होती है.

दस्तावेज़ का मुख्य हिस्सा हमेशा सेक्शन ब्रेक से शुरू होता है.

JSON के काेड में दिखाना
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
फ़ील्ड
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

sectionStyle

object (SectionStyle)

इस सेक्शन ब्रेक के बाद वाले सेक्शन की स्टाइल.

SectionStyle

किसी सेक्शन पर लागू होने वाली स्टाइलिंग.

JSON के काेड में दिखाना
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
फ़ील्ड
columnProperties[]

object (SectionColumnProperties)

सेक्शन के कॉलम की प्रॉपर्टी.

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

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

columnSeparatorStyle

enum (ColumnSeparatorStyle)

कॉलम सेपरेटर की स्टाइल.

इस स्टाइल को तब भी सेट किया जा सकता है, जब सेक्शन में सिर्फ़ एक कॉलम हो.

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

contentDirection

enum (ContentDirection)

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

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

marginTop

object (Dimension)

सेक्शन का सबसे ऊपर वाला पेज मार्जिन. अगर यह सेट नहीं है, तो DocumentStyle से डिफ़ॉल्ट वैल्यू marginTop का इस्तेमाल किया जाता है.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

marginBottom

object (Dimension)

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

marginRight

object (Dimension)

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

marginLeft

object (Dimension)

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

marginHeader

object (Dimension)

सेक्शन का हेडर मार्जिन. अगर यह सेट नहीं है, तो DocumentStyle से डिफ़ॉल्ट वैल्यू marginHeader का इस्तेमाल किया जाता है. अपडेट होने पर, DocumentStyle पर useCustomHeaderFooterMargins को 'सही है' पर सेट किया जाता है. DocumentStyle पर मौजूद useCustomHeaderFooterMargins की वैल्यू से पता चलता है कि इस सेक्शन के लिए हेडर मार्जिन का पालन किया जा रहा है या नहीं.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

sectionType

enum (SectionType)

सिर्फ़ आउटपुट के लिए. सेक्शन का टाइप.

defaultHeaderId

string

डिफ़ॉल्ट हेडर का आईडी. अगर यह नीति सेट नहीं है, तो इसकी वैल्यू, पिछले SectionBreak's SectionStyle से इनहेरिट की जाती है. अगर पहले SectionBreak में वैल्यू सेट नहीं की गई है, तो यह DocumentStyle के defaultHeaderId से इनहेरिट होती है.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

firstPageHeaderId

string

इस हेडर आईडी का इस्तेमाल, सेक्शन के सिर्फ़ पहले पेज के लिए किया जाता है. अगर useFirstPageHeaderFooter की वैल्यू सही है, तो इस वैल्यू का इस्तेमाल सेक्शन के पहले पेज पर मौजूद हेडर के लिए किया जाता है. अगर यह गलत है, तो सेक्शन के पहले पेज पर मौजूद हेडर में defaultHeaderId का इस्तेमाल किया जाता है. अगर यह नीति सेट नहीं है, तो इसकी वैल्यू, पिछले SectionBreak's SectionStyle से इनहेरिट की जाती है. अगर पहले SectionBreak में वैल्यू सेट नहीं की गई है, तो यह DocumentStyle के firstPageHeaderId से इनहेरिट होती है.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

evenPageHeaderId

string

यह हेडर का आईडी है. इसका इस्तेमाल सिर्फ़ सम संख्या वाले पेजों के लिए किया जाता है. अगर DocumentStyle के useEvenPageHeaderFooter की वैल्यू सही है, तो इस वैल्यू का इस्तेमाल सेक्शन में मौजूद सम संख्या वाले पेजों के हेडर के लिए किया जाता है. अगर यह वैल्यू 'गलत है' पर सेट है, तो सम पेजों पर मौजूद हेडर में defaultHeaderId का इस्तेमाल किया जाता है. अगर यह नीति सेट नहीं है, तो इसकी वैल्यू, पिछले SectionBreak's SectionStyle से इनहेरिट की जाती है. अगर पहले SectionBreak में वैल्यू सेट नहीं की गई है, तो यह DocumentStyle के evenPageHeaderId से इनहेरिट होती है.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

pageNumberStart

integer

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

flipPageOrientation

boolean

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

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

SectionColumnProperties

ये प्रॉपर्टी, सेक्शन के कॉलम पर लागू होती हैं.

JSON के काेड में दिखाना
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
फ़ील्ड
width

object (Dimension)

सिर्फ़ आउटपुट के लिए. कॉलम की चौड़ाई.

paddingEnd

object (Dimension)

कॉलम के आखिर में मौजूद पैडिंग.

ColumnSeparatorStyle

कॉलम के बीच मौजूद कॉलम सेपरेटर की स्टाइल.

Enums
COLUMN_SEPARATOR_STYLE_UNSPECIFIED कॉलम सेपरेटर की ऐसी स्टाइल जिसके बारे में कोई जानकारी नहीं दी गई है.
NONE कॉलम के बीच, कॉलम सेपरेटर लाइनें नहीं हैं.
BETWEEN_EACH_COLUMN इससे हर कॉलम के बीच कॉलम सेपरेटर लाइन रेंडर होती है.

SectionType

इससे पता चलता है कि मौजूदा सेक्शन की शुरुआत, पिछले सेक्शन के मुकाबले कहां है.

Enums
SECTION_TYPE_UNSPECIFIED सेक्शन का टाइप नहीं बताया गया है.
CONTINUOUS यह सेक्शन, पिछले सेक्शन के आखिरी पैराग्राफ़ के तुरंत बाद शुरू होता है.
NEXT_PAGE यह सेक्शन अगले पेज से शुरू होता है.

टेबल

टेबल को दिखाने वाली StructuralElement.

JSON के काेड में दिखाना
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
फ़ील्ड
rows

integer

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

columns

integer

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

ऐसा हो सकता है कि टेबल आयताकार न हो. इसलिए, कुछ लाइनों में अलग-अलग संख्या में सेल हो सकती हैं.

tableRows[]

object (TableRow)

हर लाइन का कॉन्टेंट और स्टाइल.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

tableStyle

object (TableStyle)

टेबल की स्टाइल.

TableRow

Table में मौजूद किसी लाइन का कॉन्टेंट और स्टाइल.

JSON के काेड में दिखाना
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
फ़ील्ड
startIndex

integer

यह लाइन का ज़ीरो-आधारित शुरुआती इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

endIndex

integer

इस लाइन का ज़ीरो-आधारित एंड इंडेक्स, UTF-16 कोड यूनिट में शामिल नहीं है.

tableCells[]

object (TableCell)

इस लाइन में मौजूद हर सेल का कॉन्टेंट और स्टाइल.

ऐसा हो सकता है कि टेबल आयताकार न हो. इसलिए, ऐसा हो सकता है कि कुछ लाइनों में, उसी टेबल की अन्य लाइनों की तुलना में अलग-अलग सेल हों.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

tableRowStyle

object (TableRowStyle)

टेबल की लाइन की स्टाइल.

suggestedTableRowStyleChanges

map (key: string, value: object (SuggestedTableRowStyle))

सुझाए गए स्टाइल में इस लाइन के लिए बदलाव किए गए हैं. इन्हें सुझाव आईडी के हिसाब से व्यवस्थित किया गया है.

TableCell

Table में मौजूद किसी सेल का कॉन्टेंट और स्टाइल.

JSON के काेड में दिखाना
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
फ़ील्ड
startIndex

integer

यह सेल का ज़ीरो-आधारित स्टार्ट इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

endIndex

integer

यह सेल के खत्म होने का इंडेक्स है. यह इंडेक्स, UTF-16 कोड यूनिट में होता है और इसमें शून्य से गिनती शुरू होती है. साथ ही, इसमें आखिरी इंडेक्स शामिल नहीं होता.

content[]

object (StructuralElement)

सेल का कॉन्टेंट.

tableCellStyle

object (TableCellStyle)

सेल की स्टाइल.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

suggestedTableCellStyleChanges

map (key: string, value: object (SuggestedTableCellStyle))

टेबल सेल के स्टाइल में सुझाए गए बदलाव. इन्हें सुझाव आईडी के हिसाब से बांटा गया है.

TableCellStyle

TableCell की स्टाइल.

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

JSON के काेड में दिखाना
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
फ़ील्ड
rowSpan

integer

सेल की पंक्ति की अवधि.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

columnSpan

integer

सेल का कॉलम स्पैन.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

backgroundColor

object (OptionalColor)

सेल के बैकग्राउंड का रंग.

borderLeft

object (TableCellBorder)

सेल का बायां बॉर्डर.

borderRight

object (TableCellBorder)

सेल का दायां बॉर्डर.

borderTop

object (TableCellBorder)

सेल का सबसे ऊपरी बॉर्डर.

borderBottom

object (TableCellBorder)

सेल का निचला बॉर्डर.

paddingLeft

object (Dimension)

सेल की बाईं ओर की पैडिंग.

paddingRight

object (Dimension)

सेल की दाईं ओर की पैडिंग.

paddingTop

object (Dimension)

सेल की टॉप पैडिंग.

paddingBottom

object (Dimension)

सेल के सबसे नीचे की पैडिंग.

contentAlignment

enum (ContentAlignment)

टेबल सेल में मौजूद कॉन्टेंट का अलाइनमेंट. डिफ़ॉल्ट अलाइनमेंट, Docs एडिटर में नई बनाई गई टेबल सेल के अलाइनमेंट से मेल खाता है.

TableCellBorder

टेबल सेल के चारों ओर बॉर्डर.

टेबल सेल के बॉर्डर पारदर्शी नहीं हो सकते. टेबल सेल के बॉर्डर को छिपाने के लिए, उसकी चौड़ाई 0 पर सेट करें.

JSON के काेड में दिखाना
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
फ़ील्ड
color

object (OptionalColor)

बॉर्डर का रंग.

इस रंग को पारदर्शी नहीं किया जा सकता.

width

object (Dimension)

बॉर्डर की चौड़ाई.

dashStyle

enum (DashStyle)

बॉर्डर की डैश स्टाइल.

ContentAlignment

कॉन्टेंट अलाइनमेंट के टाइप.

यह "Office Open XML File Formats - Fundamentals and Markup Language Reference" के सेक्शन 20.1.10.60 में मौजूद "ST_TextAnchoringType" सिंपल टाइप की वैल्यू के सबसेट से लिया गया है. यह ECMA-376 के पांचवें वर्शन के पहले हिस्से में मौजूद है.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED कॉन्टेंट अलाइनमेंट के बारे में जानकारी नहीं दी गई है. अगर कोई पैरंट मौजूद है, तो कॉन्टेंट अलाइनमेंट को पैरंट से इनहेरिट किया जाता है.
CONTENT_ALIGNMENT_UNSUPPORTED कॉन्टेंट अलाइनमेंट की सुविधा उपलब्ध नहीं है.
TOP यह अलाइनमेंट, कॉन्टेंट को कॉन्टेंट होल्डर के सबसे ऊपर अलाइन करता है. यह ECMA-376 ST_TextAnchoringType 't' से मेल खाता है.
MIDDLE यह अलाइनमेंट, कॉन्टेंट को कॉन्टेंट होल्डर के बीच में अलाइन करता है. यह ECMA-376 ST_TextAnchoringType 'ctr' से मेल खाता है.
BOTTOM यह अलाइनमेंट, कॉन्टेंट को कॉन्टेंट होल्डर के सबसे नीचे अलाइन करता है. यह ECMA-376 ST_TextAnchoringType 'b' से मेल खाता है.

SuggestedTableCellStyle

TableCellStyle में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
फ़ील्ड
tableCellStyle

object (TableCellStyle)

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

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस TableCellStyle के किन फ़ील्ड में बदलाव किया गया है.

TableCellStyleSuggestionState

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

JSON के काेड में दिखाना
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
फ़ील्ड
rowSpanSuggested

boolean

इससे पता चलता है कि rowSpan में बदलाव का कोई सुझाव दिया गया था या नहीं.

columnSpanSuggested

boolean

इससे पता चलता है कि columnSpan में बदलाव का कोई सुझाव दिया गया था या नहीं.

backgroundColorSuggested

boolean

इससे पता चलता है कि backgroundColor में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderLeftSuggested

boolean

इससे पता चलता है कि borderLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderRightSuggested

boolean

इससे पता चलता है कि borderRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderTopSuggested

boolean

इससे पता चलता है कि borderTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

borderBottomSuggested

boolean

इससे पता चलता है कि borderBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

paddingLeftSuggested

boolean

इससे पता चलता है कि paddingLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

paddingRightSuggested

boolean

इससे पता चलता है कि paddingRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

paddingTopSuggested

boolean

इससे पता चलता है कि paddingTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

paddingBottomSuggested

boolean

इससे पता चलता है कि paddingBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

contentAlignmentSuggested

boolean

इससे पता चलता है कि contentAlignment में बदलाव का कोई सुझाव दिया गया था या नहीं.

TableRowStyle

टेबल की किसी लाइन पर लागू होने वाली स्टाइल.

JSON के काेड में दिखाना
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
फ़ील्ड
minRowHeight

object (Dimension)

लाइन की कम से कम ऊंचाई. लाइन में मौजूद सभी सेल का कॉन्टेंट दिखाने के लिए, Docs एडिटर में लाइन को इस वैल्यू के बराबर या इससे ज़्यादा ऊंचाई पर रेंडर किया जाएगा.

tableHeader

boolean

इससे पता चलता है कि लाइन, टेबल का हेडर है या नहीं.

preventOverflow

boolean

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

SuggestedTableRowStyle

TableRowStyle में बदलाव का सुझाव.

JSON के काेड में दिखाना
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
फ़ील्ड
tableRowStyle

object (TableRowStyle)

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

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस TableRowStyle के किन फ़ील्ड में बदलाव किया गया है.

TableRowStyleSuggestionState

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

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

boolean

इससे पता चलता है कि minRowHeight में बदलाव का कोई सुझाव दिया गया था या नहीं.

TableStyle

टेबल पर लागू होने वाली स्टाइल.

JSON के काेड में दिखाना
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
फ़ील्ड
tableColumnProperties[]

object (TableColumnProperties)

हर कॉलम की प्रॉपर्टी.

ध्यान दें कि Docs में, टेबल में लाइनें होती हैं और लाइनों में सेल होती हैं. यह एचटीएमएल की तरह ही होता है. इसलिए, किसी लाइन की प्रॉपर्टी, लाइन के tableRowStyle पर देखी जा सकती हैं.

TableColumnProperties

किसी टेबल में मौजूद कॉलम की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
फ़ील्ड
widthType

enum (WidthType)

कॉलम की चौड़ाई का टाइप.

width

object (Dimension)

कॉलम की चौड़ाई. कॉलम का widthType FIXED_WIDTH होने पर सेट किया जाता है.

WidthType

कॉलम की चौड़ाई का टाइप.

Enums
WIDTH_TYPE_UNSPECIFIED कॉलम की चौड़ाई के टाइप के बारे में कोई जानकारी नहीं दी गई है.
EVENLY_DISTRIBUTED

कॉलम की चौड़ाई को, एक जैसी चौड़ाई वाले अन्य कॉलम के बीच बराबर-बराबर बांटा जाता है.

कॉलम की चौड़ाई अपने-आप तय होती है. साथ ही, तय की गई चौड़ाई वाले सभी कॉलम को ध्यान में रखने के बाद, टेबल के लिए बची हुई चौड़ाई का बराबर हिस्सा होगा.

FIXED_WIDTH कॉलम की चौड़ाई तय होती है. [width][google.apps.docs.v1.TableColumnProperties.width प्रॉपर्टी में, कॉलम की चौड़ाई होती है.

TableOfContents

StructuralElement, विषय सूची दिखाता है.

JSON के काेड में दिखाना
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
फ़ील्ड
content[]

object (StructuralElement)

विषय सूची का कॉन्टेंट.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

फ़ुटनोट

दस्तावेज़ का फ़ुटनोट.

JSON के काेड में दिखाना
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
फ़ील्ड
footnoteId

string

फ़ुटनोट का आईडी.

content[]

object (StructuralElement)

फ़ुटनोट का कॉन्टेंट.

फ़ुटनोट के कॉन्टेंट के इंडेक्स, शून्य से शुरू होते हैं.

DocumentStyle

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

JSON के काेड में दिखाना
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean,
  "documentFormat": {
    object (DocumentFormat)
  }
}
फ़ील्ड
background

object (Background)

दस्तावेज़ का बैकग्राउंड. दस्तावेज़ों का बैकग्राउंड ट्रांसपैरंट नहीं होना चाहिए.

defaultHeaderId

string

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

evenPageHeaderId

string

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

firstPageHeaderId

string

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

इस प्रॉपर्टी को सिर्फ़ देखा जा सकता है.

pageNumberStart

integer

पेज नंबर, जहां से पेजों की संख्या गिनना शुरू करना है.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

marginTop

object (Dimension)

पेज का सबसे ऊपर वाला मार्जिन.

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

marginBottom

object (Dimension)

पेज का सबसे नीचे वाला मार्जिन.

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

marginRight

object (Dimension)

पेज का दायां मार्जिन.

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

marginLeft

object (Dimension)

पेज का बायां मार्जिन.

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

pageSize

object (Size)

दस्तावेज़ में मौजूद पेज का साइज़.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

marginHeader

object (Dimension)

पेज के सबसे ऊपर वाले हिस्से और हेडर के कॉन्टेंट के बीच की जगह.

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

flipPageOrientation

boolean

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

अगर [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS है, तो इस प्रॉपर्टी को रेंडर नहीं किया जाएगा.

documentFormat

object (DocumentFormat)

यह दस्तावेज़-लेवल की फ़ॉर्मैट सेटिंग तय करता है. जैसे, दस्तावेज़ मोड (पेज बनाम पेजलेस).

बैकग्राउंड

यह किसी दस्तावेज़ के बैकग्राउंड को दिखाता है.

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

object (OptionalColor)

बैकग्राउंड का रंग.

साइज़

चौड़ाई और ऊंचाई.

JSON के काेड में दिखाना
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
फ़ील्ड
height

object (Dimension)

ऑब्जेक्ट की ऊंचाई.

width

object (Dimension)

ऑब्जेक्ट की चौड़ाई.

DocumentFormat

इससे दस्तावेज़ के लेवल पर फ़ॉर्मैट की सेटिंग के बारे में पता चलता है.

JSON के काेड में दिखाना
{
  "documentMode": enum (DocumentMode)
}
फ़ील्ड
documentMode

enum (DocumentMode)

दस्तावेज़ में पेज हैं या वह पेजलेस है.

DocumentMode

दस्तावेज़ में पेज हैं या वह पेजलेस है.

Enums
DOCUMENT_MODE_UNSPECIFIED दस्तावेज़ का मोड नहीं बताया गया है.
PAGES दस्तावेज़ में पेज हैं.
PAGELESS दस्तावेज़ पेजलेस है.

SuggestedDocumentStyle

DocumentStyle में बदलाव का सुझाव दिया गया है.

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

object (DocumentStyle)

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

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस DocumentStyle के किन फ़ील्ड में बदलाव किया गया है.

DocumentStyleSuggestionState

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

JSON के काेड में दिखाना
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
फ़ील्ड
backgroundSuggestionState

object (BackgroundSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में background के किन फ़ील्ड में बदलाव किया गया है.

defaultHeaderIdSuggested

boolean

इससे पता चलता है कि defaultHeaderId में बदलाव का कोई सुझाव दिया गया था या नहीं.

evenPageHeaderIdSuggested

boolean

इससे पता चलता है कि evenPageHeaderId में बदलाव का कोई सुझाव दिया गया था या नहीं.

firstPageHeaderIdSuggested

boolean

इससे पता चलता है कि firstPageHeaderId में बदलाव का कोई सुझाव दिया गया था या नहीं.

pageNumberStartSuggested

boolean

इससे पता चलता है कि pageNumberStart में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginTopSuggested

boolean

इससे पता चलता है कि marginTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginBottomSuggested

boolean

इससे पता चलता है कि marginBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginRightSuggested

boolean

इससे पता चलता है कि marginRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginLeftSuggested

boolean

इससे पता चलता है कि marginLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

pageSizeSuggestionState

object (SizeSuggestionState)

यह एक ऐसा मास्क है जिससे पता चलता है कि इस सुझाव में, [size] [google.apps.docs.v1.DocumentStyle.size] में मौजूद किन फ़ील्ड में बदलाव किया गया है.

marginHeaderSuggested

boolean

इससे पता चलता है कि marginHeader में बदलाव का कोई सुझाव दिया गया था या नहीं.

flipPageOrientationSuggested

boolean

ज़रूरी नहीं. इससे पता चलता है कि flipPageOrientation में बदलाव का कोई सुझाव दिया गया था या नहीं.

BackgroundSuggestionState

यह मास्क दिखाता है कि इस सुझाव में, बेस Background के किन फ़ील्ड में बदलाव किया गया है. अगर किसी फ़ील्ड के लिए 'सही है' विकल्प चुना गया है, तो Backgound में सुझाई गई नई वैल्यू दिखेगी.

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

boolean

इससे पता चलता है कि इस सुझाव में, बैकग्राउंड के मौजूदा रंग में बदलाव किया गया है या नहीं.

SizeSuggestionState

यह मास्क दिखाता है कि इस सुझाव में, बेस Size के किन फ़ील्ड में बदलाव किया गया है. अगर किसी फ़ील्ड के लिए 'सही है' विकल्प चुना गया है, तो Size में सुझाई गई नई वैल्यू दिखेगी.

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

boolean

इससे पता चलता है कि height में बदलाव का कोई सुझाव दिया गया था या नहीं.

widthSuggested

boolean

इससे पता चलता है कि width में बदलाव का कोई सुझाव दिया गया था या नहीं.

NamedStyles

नाम वाले स्टाइल. दस्तावेज़ में मौजूद पैराग्राफ़, इन स्टाइल से TextStyle और ParagraphStyle को इनहेरिट कर सकते हैं.

JSON के काेड में दिखाना
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
फ़ील्ड
styles[]

object (NamedStyle)

नाम वाले स्टाइल.

हर संभावित named style types के लिए एक एंट्री होती है.

NamedStyle

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

JSON के काेड में दिखाना
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
फ़ील्ड
namedStyleType

enum (NamedStyleType)

इस स्टाइल का टाइप.

textStyle

object (TextStyle)

इस स्टाइल का टेक्स्ट स्टाइल.

paragraphStyle

object (ParagraphStyle)

इस स्टाइल का पैराग्राफ़ स्टाइल.

SuggestedNamedStyles

NamedStyles में बदलाव का सुझाव दिया गया है.

JSON के काेड में दिखाना
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
फ़ील्ड
namedStyles

object (NamedStyles)

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

namedStylesSuggestionState

object (NamedStylesSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस NamedStyles के किन फ़ील्ड में बदलाव किया गया है.

NamedStylesSuggestionState

NamedStyles मैसेज के सुझाव की स्थिति.

JSON के काेड में दिखाना
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
फ़ील्ड
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में, styles में मौजूद NamedStyle के किन फ़ील्ड में बदलाव किया गया है.

नाम वाली स्टाइल के सुझाव की इन स्थितियों का क्रम, named styles सुझाव में नाम वाली स्टाइल के क्रम से मेल खाता है.

NamedStyleSuggestionState

NamedStyle मैसेज के लिए सुझाव की स्थिति.

JSON के काेड में दिखाना
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
फ़ील्ड
namedStyleType

enum (NamedStyleType)

यह सुझाव, स्टाइल के जिस टाइप से जुड़ा है उसका नाम.

इस फ़ील्ड को इसलिए उपलब्ध कराया गया है, ताकि NamedStyleSuggestionState को उसके NamedStyle से आसानी से मैच किया जा सके.

textStyleSuggestionState

object (TextStyleSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में text style के किन फ़ील्ड में बदलाव किया गया है.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में paragraph style के किन फ़ील्ड में बदलाव किया गया है.

सूची

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

JSON के काेड में दिखाना
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
फ़ील्ड
listProperties

object (ListProperties)

सूची की प्रॉपर्टी.

suggestedListPropertiesChanges

map (key: string, value: object (SuggestedListProperties))

सुझाव आईडी के हिसाब से, सूची की प्रॉपर्टी में सुझाए गए बदलाव.

suggestedInsertionId

string

सुझाए गए इंसर्शन का आईडी. अगर यह खाली है, तो इसका मतलब है कि यह सुझाई गई जगह नहीं है.

suggestedDeletionIds[]

string

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

ListProperties

list की ऐसी प्रॉपर्टी जो किसी सूची से जुड़े पैराग्राफ़ की बुलेट के लुक और फ़ील के बारे में बताती हैं.

JSON के काेड में दिखाना
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
फ़ील्ड
nestingLevels[]

object (NestingLevel)

इससे, उस लेवल पर मौजूद बुलेट के बारे में जानकारी मिलती है.

किसी सूची में ज़्यादा से ज़्यादा नौ लेवल की नेस्टिंग हो सकती है. नेस्टिंग लेवल 0, सबसे ऊपर वाले लेवल से मेल खाता है. वहीं, नेस्टिंग लेवल 8, सबसे ज़्यादा नेस्ट किए गए लेवल से मेल खाता है. नेस्टिंग लेवल को बढ़ते क्रम में दिखाया जाता है. इसमें सबसे कम नेस्ट किए गए लेवल को सबसे पहले दिखाया जाता है.

NestingLevel

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

JSON के काेड में दिखाना
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  "glyphType": enum (GlyphType),
  "glyphSymbol": string
}
फ़ील्ड
bulletAlignment

enum (BulletAlignment)

बुलेट को रेंडर करने के लिए तय की गई जगह में, बुलेट का अलाइनमेंट.

glyphFormat

string

नेस्टिंग के इस लेवल पर बुलेट के लिए इस्तेमाल की गई फ़ॉर्मैट स्ट्रिंग.

ग्लिफ़ फ़ॉर्मैट में एक या उससे ज़्यादा प्लेसहोल्डर होते हैं. इन प्लेसहोल्डर को glyphType या glyphSymbol के हिसाब से सही वैल्यू से बदल दिया जाता है. प्लेसहोल्डर, %[nestingLevel] पैटर्न के मुताबिक होते हैं. इसके अलावा, प्लेसहोल्डर में प्रीफ़िक्स और सफ़िक्स हो सकते हैं. इसलिए, ग्लिफ़ का फ़ॉर्मैट <prefix>%[nestingLevel]<suffix> पैटर्न के मुताबिक होता है. ध्यान दें कि प्रीफ़िक्स और सुफ़िक्स का इस्तेमाल करना ज़रूरी नहीं है. ये कोई भी स्ट्रिंग हो सकती हैं.

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

A.

B.

C.

ग्लिफ़ फ़ॉर्मैट में, मौजूदा नेस्टिंग लेवल के साथ-साथ पैरंट नेस्टिंग लेवल के लिए भी प्लेसहोल्डर शामिल हो सकते हैं. उदाहरण के लिए, किसी सूची में नेस्टिंग लेवल 0 पर %0. वाला ग्लिफ़ फ़ॉर्मैट और नेस्टिंग लेवल 1 पर %0.%1. वाला ग्लिफ़ फ़ॉर्मैट हो सकता है. मान लें कि दोनों नेस्टिंग लेवल में DECIMAL ग्लिफ़ टाइप हैं. इससे रेंडर किए गए ग्लिफ़ वाली सूची बनेगी

1.

2.

2.1.

2.2.

3.

ऑर्डर किए गए नेस्टिंग लेवल के लिए, किसी पैराग्राफ़ के ग्लिफ़ फ़ॉर्मैट में प्लेसहोल्डर की जगह इस्तेमाल की जाने वाली स्ट्रिंग, सूची में पैराग्राफ़ के क्रम पर निर्भर करती है.

indentFirstLine

object (Dimension)

नेस्टिंग के इस लेवल पर, पैराग्राफ़ की पहली लाइन के लिए इंडेंटेशन की रकम.

indentStart

object (Dimension)

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

textStyle

object (TextStyle)

नेस्टिंग के इस लेवल पर मौजूद बुलेट का टेक्स्ट स्टाइल.

startNumber

integer

इस नेस्टिंग लेवल पर मौजूद, सूची के पहले आइटम की संख्या.

अक्षर वाली सूचियों और रोमन अंकों वाली सूचियों के लिए, 0 की वैल्यू को 1 की वैल्यू माना जाता है. 0 और 1, दोनों वैल्यू के लिए, अक्षरों और रोमन अंकों वाली सूचियां क्रमशः a और i से शुरू होंगी.

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

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

enum (GlyphType)

इस तरह के नेस्टिंग लेवल वाले पैराग्राफ़ को क्रम से लगाने पर, बुलेट के लिए इस्तेमाल किए गए ग्लिफ़ का टाइप.

Glyph टाइप से यह तय होता है कि इस लेवल की नेस्टिंग में पैराग्राफ़ को क्रम से लगाने पर, glyphFormat में प्लेसहोल्डर को बदलने के लिए किस तरह के Glyph का इस्तेमाल किया जाएगा. उदाहरण के लिए, अगर नेस्टिंग लेवल 0 है, glyphFormat %0. है, और ग्लिफ़ टाइप DECIMAL है, तो रेंडर किया गया ग्लिफ़, ग्लिफ़ फ़ॉर्मैट में मौजूद प्लेसहोल्डर %0 की जगह ले लेगा. इसमें सूची के आइटम के क्रम के हिसाब से नंबर होगा.

glyphSymbol

string

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

glyphFormat में मौजूद प्लेसहोल्डर की जगह, ग्लिफ़ सिंबल का इस्तेमाल किया जाता है. उदाहरण के लिए, अगर glyphSymbol, यूनिकोड U+25cf कोड पॉइंट से जुड़ा सॉलिड सर्कल है और glyphFormat, %0 है, तो रेंडर किया गया ग्लिफ़, सॉलिड सर्कल होगा.

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

BulletAlignment

बुलेट के लिए अलाइनमेंट के टाइप.

Enums
BULLET_ALIGNMENT_UNSPECIFIED बुलेट के अलाइनमेंट की जानकारी नहीं दी गई है.
START बुलेट को उस जगह की शुरुआत में अलाइन किया जाता है जहां बुलेट को रेंडर किया जाता है. एलटीआर टेक्स्ट के लिए बाईं ओर अलाइन किया गया है. इसके अलावा, अन्य टेक्स्ट के लिए दाईं ओर अलाइन किया गया है.
CENTER बुलेट को, बुलेट रेंडर करने के लिए तय की गई जगह के बीच में अलाइन किया जाता है.
END बुलेट को, बुलेट रेंडर करने के लिए तय की गई जगह के आखिर में अलाइन किया जाता है. एलटीआर टेक्स्ट के लिए, राइट-अलाइन किया गया है. इसके अलावा, लेफ्ट-अलाइन किया गया है.

GlyphType

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

Enums
GLYPH_TYPE_UNSPECIFIED ग्लिफ़ टाइप के बारे में जानकारी नहीं दी गई है या यह काम नहीं करता.
NONE एक खाली स्ट्रिंग.
DECIMAL कोई संख्या, जैसे कि 1, 2 या 3.
ZERO_DECIMAL ऐसा नंबर जिसमें एक से नौ तक की संख्याओं के पहले शून्य लगाया गया हो. जैसे, 01, 02 या 03. एक से ज़्यादा अंकों वाले नंबरों के पहले शून्य नहीं लगाया जाता.
UPPER_ALPHA कैपिटल लेटर, जैसे कि A, B या C.
ALPHA अंग्रेज़ी का कोई छोटा अक्षर, जैसे कि a, b या c.
UPPER_ROMAN कैपिटल लेटर में रोमन अंक, जैसे कि I, II या III.
ROMAN अंग्रेज़ी के छोटे अक्षरों में लिखा रोमन अंक, जैसे कि i, ii या iii.

SuggestedListProperties

ListProperties में बदलाव का सुझाव दिया गया है.

JSON के काेड में दिखाना
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
फ़ील्ड
listProperties

object (ListProperties)

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

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस ListProperties के किन फ़ील्ड में बदलाव किया गया है.

ListPropertiesSuggestionState

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

JSON के काेड में दिखाना
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
फ़ील्ड
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में, nestingLevels में मौजूद NestingLevel के किन फ़ील्ड में बदलाव किया गया है.

नेस्टिंग लेवल के सुझावों की स्थितियां, नेस्टिंग लेवल के बढ़ते क्रम में दिखाई जाती हैं. इसमें सबसे कम नेस्ट किए गए सुझाव की स्थिति सबसे पहले दिखाई जाती है.

NestingLevelSuggestionState

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

JSON के काेड में दिखाना
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
फ़ील्ड
bulletAlignmentSuggested

boolean

इससे पता चलता है कि bulletAlignment में बदलाव का कोई सुझाव दिया गया था या नहीं.

glyphTypeSuggested

boolean

इससे पता चलता है कि glyphType में बदलाव का कोई सुझाव दिया गया था या नहीं.

glyphFormatSuggested

boolean

इससे पता चलता है कि glyphFormat में बदलाव का कोई सुझाव दिया गया था या नहीं.

glyphSymbolSuggested

boolean

इससे पता चलता है कि glyphSymbol में बदलाव का कोई सुझाव दिया गया था या नहीं.

indentFirstLineSuggested

boolean

इससे पता चलता है कि indentFirstLine में बदलाव का कोई सुझाव दिया गया था या नहीं.

indentStartSuggested

boolean

इससे पता चलता है कि indentStart में बदलाव का कोई सुझाव दिया गया था या नहीं.

textStyleSuggestionState

object (TextStyleSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में text style के किन फ़ील्ड में बदलाव किया गया है.

startNumberSuggested

boolean

इससे पता चलता है कि startNumber में बदलाव का कोई सुझाव दिया गया था या नहीं.

NamedRanges

यह दस्तावेज़ में मौजूद उन सभी NamedRange का कलेक्शन होता है जिनका नाम एक जैसा होता है.

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

string

वह नाम जो सभी named ranges शेयर करते हैं.

namedRanges[]

object (NamedRange)

एक ही नाम वाले NamedRange.

NamedRange

एक ही नाम वाली रेंज आईडी वाले Range का कलेक्शन.

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

नाम वाली रेंज, एक Range से बनाई जाती है. साथ ही, नाम वाली रेंज में कॉन्टेंट डालने पर, आम तौर पर वह रेंज बढ़ जाती है. हालांकि, दस्तावेज़ में कुछ बदलावों की वजह से, रेंज को एक से ज़्यादा रेंज में बांटा जा सकता है.

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

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

string

नाम वाली रेंज का आईडी.

name

string

नाम वाली रेंज का नाम.

ranges[]

object (Range)

इस नाम वाली रेंज से जुड़ी रेंज.

रेंज

इससे टेक्स्ट की लगातार रेंज के बारे में पता चलता है.

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

string

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

startIndex

integer

यह रेंज का ज़ीरो-आधारित शुरुआती इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

मौजूदा समय में, इसका इस्तेमाल करने के लिए स्टार्ट इंडेक्स देना ज़रूरी है. यह फ़ील्ड Int32Value है, ताकि आने वाले समय में ओपन-एंडेड रेंज के साथ इस्तेमाल के उदाहरणों को शामिल किया जा सके.

endIndex

integer

यह इस रेंज का ज़ीरो-आधारित एंड इंडेक्स है. यह UTF-16 कोड यूनिट में होता है.

फ़िलहाल, इस्तेमाल के सभी मामलों में, आखिरी इंडेक्स देना ज़रूरी है. यह फ़ील्ड Int32Value है, ताकि आने वाले समय में ओपन-एंडेड रेंज के साथ इस्तेमाल के उदाहरणों को शामिल किया जा सके.

tabId

string

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

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

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

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

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

  • अगर यह पैरामीटर दिया गया है, तो अनुरोध में बताया गया टैब खुलेगा.

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

InlineObject

ऐसा ऑब्जेक्ट जो टेक्स्ट के साथ इनलाइन दिखता है. InlineObject में EmbeddedObject होता है. जैसे, कोई इमेज.

JSON के काेड में दिखाना
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
फ़ील्ड
objectId

string

इस इनलाइन ऑब्जेक्ट का आईडी. इसका इस्तेमाल किसी ऑब्जेक्ट की प्रॉपर्टी अपडेट करने के लिए किया जा सकता है.

inlineObjectProperties

object (InlineObjectProperties)

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

suggestedInlineObjectPropertiesChanges

map (key: string, value: object (SuggestedInlineObjectProperties))

सुझाव आईडी के हिसाब से, इनलाइन ऑब्जेक्ट की प्रॉपर्टी में सुझाए गए बदलाव.

suggestedInsertionId

string

सुझाए गए इंसर्शन का आईडी. अगर यह खाली है, तो इसका मतलब है कि यह सुझाई गई जगह नहीं है.

suggestedDeletionIds[]

string

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

InlineObjectProperties

InlineObject की प्रॉपर्टी.

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

object (EmbeddedObject)

इस इनलाइन ऑब्जेक्ट का एम्बेड किया गया ऑब्जेक्ट.

EmbeddedObject

दस्तावेज़ में एम्बेड किया गया ऑब्जेक्ट.

JSON के काेड में दिखाना
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
}
फ़ील्ड
title

string

जोड़े गए ऑब्जेक्ट का टाइटल. वैकल्पिक टेक्स्ट दिखाने के लिए, title और description, दोनों को एक साथ इस्तेमाल किया जाता है.

description

string

एम्बेड किए गए ऑब्जेक्ट की जानकारी. वैकल्पिक टेक्स्ट दिखाने के लिए, title और description, दोनों को एक साथ इस्तेमाल किया जाता है.

embeddedObjectBorder

object (EmbeddedObjectBorder)

जोड़े गए ऑब्जेक्ट का बॉर्डर.

size

object (Size)

काटने के बाद इमेज का दिखने वाला साइज़.

marginTop

object (Dimension)

एम्बेड किए गए ऑब्जेक्ट का टॉप मार्जिन.

marginBottom

object (Dimension)

एम्बेड किए गए ऑब्जेक्ट का सबसे नीचे वाला मार्जिन.

marginRight

object (Dimension)

यह एम्बेड किए गए ऑब्जेक्ट का राइट मार्जिन होता है.

marginLeft

object (Dimension)

यह एम्बेड किए गए ऑब्जेक्ट का बायां मार्जिन होता है.

linkedContentReference

object (LinkedContentReference)

लिंक किए गए बाहरी सोर्स के कॉन्टेंट का रेफ़रंस. उदाहरण के लिए, जब एम्बेड किया गया ऑब्जेक्ट, लिंक किया गया चार्ट होता है, तब इसमें सोर्स Google Sheets चार्ट का रेफ़रंस होता है.

अगर इसे सेट नहीं किया जाता है, तो जोड़े गए ऑब्जेक्ट को लिंक नहीं किया जाता है.

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

object (EmbeddedDrawingProperties)

एम्बेड की गई ड्रॉइंग की प्रॉपर्टी.

imageProperties

object (ImageProperties)

किसी इमेज की प्रॉपर्टी.

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

EmbeddedDrawingProperties

इस टाइप में कोई फ़ील्ड नहीं है.

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

ImageProperties

किसी इमेज की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
फ़ील्ड
contentUri

string

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

sourceUri

string

सोर्स यूआरआई, इमेज को शामिल करने के लिए इस्तेमाल किया गया यूआरआई होता है. सोर्स यूआरआई वाला फ़ील्ड खाली छोड़ा जा सकता है.

brightness

number

इमेज की चमक का इफ़ेक्ट. वैल्यू, [-1.0, 1.0] के इंटरवल के बीच होनी चाहिए. इसमें 0 का मतलब है कि कोई इफ़ेक्ट नहीं है.

contrast

number

इमेज का कंट्रास्ट इफ़ेक्ट. वैल्यू, [-1.0, 1.0] के इंटरवल के बीच होनी चाहिए. इसमें 0 का मतलब है कि कोई इफ़ेक्ट नहीं है.

transparency

number

इमेज में पारदर्शिता का इफ़ेक्ट. वैल्यू, [0.0, 1.0] के बीच होनी चाहिए. इसमें 0 का मतलब है कि कोई इफ़ेक्ट नहीं है और 1 का मतलब है कि पारदर्शी है.

cropProperties

object (CropProperties)

इमेज की क्रॉप प्रॉपर्टी.

angle

number

इमेज को घड़ी की सुई की दिशा में घुमाने का कोण, रेडियन में.

CropProperties

किसी इमेज की क्रॉप प्रॉपर्टी.

क्रॉप किए गए रेक्टैंगल को, ओरिजनल कॉन्टेंट के चारों किनारों से फ़्रैक्शनल ऑफ़सेट का इस्तेमाल करके दिखाया जाता है.

  • अगर ऑफ़सेट (0, 1) के बीच में है, तो क्रॉप किए गए रेक्टैंगल का किनारा, इमेज के ओरिजनल बाउंडिंग रेक्टैंगल के अंदर रखा जाता है.
  • अगर ऑफ़सेट की वैल्यू नेगेटिव है या 1 से ज़्यादा है, तो क्रॉप रेक्टैंगल का किनारा, इमेज के ओरिजनल बाउंडिंग रेक्टैंगल के बाहर रखा जाता है.
  • अगर सभी ऑफ़सेट और रोटेशन ऐंगल 0 हैं, तो इमेज को नहीं काटा जाता है.
JSON के काेड में दिखाना
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
फ़ील्ड
offsetLeft

number

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

offsetRight

number

ऑफ़सेट से पता चलता है कि काटी गई इमेज का दायां किनारा, ओरिजनल कॉन्टेंट के दाएं किनारे से कितना अंदर की ओर है. यह ओरिजनल कॉन्टेंट की चौड़ाई के फ़्रैक्शन के तौर पर होता है.

offsetTop

number

ऑफ़सेट से पता चलता है कि क्रॉप किए गए रेक्टैंगल का ऊपरी किनारा, ओरिजनल कॉन्टेंट के ऊपरी किनारे से कितना अंदर की ओर है. यह ओरिजनल कॉन्टेंट की ऊंचाई के फ़्रैक्शन के तौर पर होता है.

offsetBottom

number

ऑफ़सेट से पता चलता है कि क्रॉप किए गए रेक्टैंगल का निचला किनारा, ओरिजनल कॉन्टेंट के निचले किनारे से कितना अंदर की ओर है. यह ओरिजनल कॉन्टेंट की ऊंचाई के फ़्रैक्शन के तौर पर होता है.

angle

number

क्रॉप किए गए रेक्टैंगल को उसके सेंटर के चारों ओर घड़ी की सुई की दिशा में घुमाने का कोण, रेडियन में. ऑफ़सेट के बाद रोटेशन लागू होता है.

EmbeddedObjectBorder

EmbeddedObject के चारों ओर बॉर्डर.

JSON के काेड में दिखाना
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
फ़ील्ड
color

object (OptionalColor)

बॉर्डर का रंग.

width

object (Dimension)

बॉर्डर की चौड़ाई.

dashStyle

enum (DashStyle)

बॉर्डर की डैश स्टाइल.

propertyState

enum (PropertyState)

बॉर्डर प्रॉपर्टी की प्रॉपर्टी स्टेट.

PropertyState

प्रॉपर्टी की संभावित स्थितियां.

Enums
RENDERED अगर किसी प्रॉपर्टी की स्थिति RENDERED है, तो दस्तावेज़ में रेंडर किए जाने पर एलिमेंट में उससे जुड़ी प्रॉपर्टी होती है. यह डिफ़ॉल्ट मान है.
NOT_RENDERED अगर किसी प्रॉपर्टी की स्थिति NOT_RENDERED है, तो इसका मतलब है कि दस्तावेज़ में रेंडर किए जाने पर, एलिमेंट में उससे जुड़ी प्रॉपर्टी नहीं है.

LinkedContentReference

लिंक किए गए बाहरी सोर्स के कॉन्टेंट का रेफ़रंस.

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

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

object (SheetsChartReference)

लिंक किए गए चार्ट का रेफ़रंस.

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

SheetsChartReference

Google Sheets से एम्बेड किए गए लिंक किए गए चार्ट का रेफ़रंस.

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

string

उस Google Sheets स्प्रेडशीट का आईडी जिसमें सोर्स चार्ट मौजूद है.

chartId

integer

Google Sheets की उस स्प्रेडशीट में मौजूद चार्ट का आईडी जिसे एम्बेड किया गया है.

SuggestedInlineObjectProperties

InlineObjectProperties में बदलाव का सुझाव दिया गया है.

JSON के काेड में दिखाना
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
फ़ील्ड
inlineObjectProperties

object (InlineObjectProperties)

एक InlineObjectProperties जिसमें सिर्फ़ इस सुझाव में किए गए बदलाव शामिल हों. इसका इस्तेमाल inlineObjectPropertiesSuggestionState के साथ किया जा सकता है. इससे यह पता चलता है कि किन फ़ील्ड में बदलाव हुआ है और उनकी नई वैल्यू क्या हैं.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस InlineObjectProperties के किन फ़ील्ड में बदलाव किया गया है.

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में embeddedObject के किन फ़ील्ड में बदलाव किया गया है.

EmbeddedObjectSuggestionState

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

JSON के काेड में दिखाना
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
फ़ील्ड
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में embeddedDrawingProperties के किन फ़ील्ड में बदलाव किया गया है.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में imageProperties के किन फ़ील्ड में बदलाव किया गया है.

titleSuggested

boolean

इससे पता चलता है कि title में बदलाव का कोई सुझाव दिया गया था या नहीं.

descriptionSuggested

boolean

इससे पता चलता है कि description में बदलाव का कोई सुझाव दिया गया था या नहीं.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में embeddedObjectBorder के किन फ़ील्ड में बदलाव किया गया है.

sizeSuggestionState

object (SizeSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में size के किन फ़ील्ड में बदलाव किया गया है.

marginLeftSuggested

boolean

इससे पता चलता है कि marginLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginRightSuggested

boolean

इससे पता चलता है कि marginRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginTopSuggested

boolean

इससे पता चलता है कि marginTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

marginBottomSuggested

boolean

इससे पता चलता है कि marginBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में linkedContentReference के किन फ़ील्ड में बदलाव किया गया है.

EmbeddedDrawingPropertiesSuggestionState

इस टाइप में कोई फ़ील्ड नहीं है.

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

ImagePropertiesSuggestionState

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

JSON के काेड में दिखाना
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
फ़ील्ड
contentUriSuggested

boolean

इससे पता चलता है कि contentUri में बदलाव का कोई सुझाव दिया गया था या नहीं.

sourceUriSuggested

boolean

इससे पता चलता है कि [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri] में कोई बदलाव सुझाया गया था या नहीं.

brightnessSuggested

boolean

इससे पता चलता है कि [brightness] [google.apps.docs.v1.EmbeddedObject.brightness] में बदलाव का सुझाव दिया गया था या नहीं.

contrastSuggested

boolean

इससे पता चलता है कि [contrast] [google.apps.docs.v1.EmbeddedObject.contrast] में कोई बदलाव सुझाया गया था या नहीं.

transparencySuggested

boolean

इससे पता चलता है कि क्या [transparency] [google.apps.docs.v1.EmbeddedObject.transparency] में कोई बदलाव सुझाया गया था.

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में cropProperties के किन फ़ील्ड में बदलाव किया गया है.

angleSuggested

boolean

इससे पता चलता है कि [angle] [google.apps.docs.v1.EmbeddedObject.angle] में कोई बदलाव सुझाया गया था या नहीं.

CropPropertiesSuggestionState

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

JSON के काेड में दिखाना
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
फ़ील्ड
offsetLeftSuggested

boolean

इससे पता चलता है कि offsetLeft में बदलाव का कोई सुझाव दिया गया था या नहीं.

offsetRightSuggested

boolean

इससे पता चलता है कि offsetRight में बदलाव का कोई सुझाव दिया गया था या नहीं.

offsetTopSuggested

boolean

इससे पता चलता है कि offsetTop में बदलाव का कोई सुझाव दिया गया था या नहीं.

offsetBottomSuggested

boolean

इससे पता चलता है कि offsetBottom में बदलाव का कोई सुझाव दिया गया था या नहीं.

angleSuggested

boolean

इससे पता चलता है कि angle में बदलाव का कोई सुझाव दिया गया था या नहीं.

EmbeddedObjectBorderSuggestionState

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

JSON के काेड में दिखाना
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
फ़ील्ड
colorSuggested

boolean

इससे पता चलता है कि [color] [google.apps.docs.v1.EmbeddedBorderObject.color] में बदलाव का सुझाव दिया गया था या नहीं.

widthSuggested

boolean

इससे पता चलता है कि [width] [google.apps.docs.v1.EmbeddedBorderObject.width] में कोई बदलाव सुझाया गया था या नहीं.

dashStyleSuggested

boolean

इससे पता चलता है कि [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style] में कोई बदलाव सुझाया गया था या नहीं.

propertyStateSuggested

boolean

इससे पता चलता है कि [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state] में कोई बदलाव सुझाया गया था या नहीं.

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में sheetsChartReference के किन फ़ील्ड में बदलाव किया गया है.

SheetsChartReferenceSuggestionState

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

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

boolean

इससे पता चलता है कि spreadsheetId में बदलाव का कोई सुझाव दिया गया था या नहीं.

chartIdSuggested

boolean

इससे पता चलता है कि chartId में बदलाव का कोई सुझाव दिया गया था या नहीं.

PositionedObject

यह एक ऐसा ऑब्जेक्ट है जो Paragraph से जुड़ा होता है और पैराग्राफ़ की शुरुआत के हिसाब से इसकी पोज़िशन तय की जाती है. PositionedObject में, इमेज जैसा EmbeddedObject शामिल होता है.

JSON के काेड में दिखाना
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
फ़ील्ड
objectId

string

इस ऑब्जेक्ट का आईडी.

positionedObjectProperties

object (PositionedObjectProperties)

इस पोज़िशन किए गए ऑब्जेक्ट की प्रॉपर्टी.

suggestedPositionedObjectPropertiesChanges

map (key: string, value: object (SuggestedPositionedObjectProperties))

सुझाव आईडी के हिसाब से, पोज़िशन किए गए ऑब्जेक्ट की प्रॉपर्टी में सुझाए गए बदलाव.

suggestedInsertionId

string

सुझाए गए इंसर्शन का आईडी. अगर यह खाली है, तो इसका मतलब है कि यह सुझाई गई जगह नहीं है.

suggestedDeletionIds[]

string

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

PositionedObjectProperties

PositionedObject की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
फ़ील्ड
positioning

object (PositionedObjectPositioning)

इस पोज़िशन किए गए ऑब्जेक्ट की पोज़िशन, Paragraph की नई लाइन के हिसाब से तय होती है. यह, इस पोज़िशन किए गए ऑब्जेक्ट को रेफ़रंस करता है.

embeddedObject

object (EmbeddedObject)

यह पोज़िशन किए गए ऑब्जेक्ट का एम्बेड किया गया ऑब्जेक्ट है.

PositionedObjectPositioning

PositionedObject की पोज़िशन. पोजीशन किया गया ऑब्जेक्ट, उस Paragraph की शुरुआत के हिसाब से पोजीशन किया जाता है जिससे वह जुड़ा है.

JSON के काेड में दिखाना
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
फ़ील्ड
layout

enum (PositionedObjectLayout)

इस ऑब्जेक्ट का लेआउट.

leftOffset

object (Dimension)

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

topOffset

object (Dimension)

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

PositionedObjectLayout

[PositionedObject][google.aps.docs.v1.PositionedObject] के संभावित लेआउट.

Enums
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED लेआउट की जानकारी नहीं दी गई है.
WRAP_TEXT टेक्स्ट, ऑब्जेक्ट के चारों ओर रैप हो जाता है.
BREAK_LEFT इस विकल्प से टेक्स्ट इस तरह से ब्रेक होता है कि ऑब्जेक्ट बाईं ओर और टेक्स्ट दाईं ओर होता है.
BREAK_RIGHT इस विकल्प से टेक्स्ट इस तरह से ब्रेक होता है कि ऑब्जेक्ट दाईं ओर और टेक्स्ट बाईं ओर होता है.
BREAK_LEFT_RIGHT टेक्स्ट को इस तरह से तोड़ता है कि ऑब्जेक्ट की बाईं या दाईं ओर कोई टेक्स्ट न हो.
IN_FRONT_OF_TEXT पोजीशन किया गया ऑब्जेक्ट, टेक्स्ट के सामने है.
BEHIND_TEXT पोजीशन किया गया ऑब्जेक्ट, टेक्स्ट के पीछे है.

SuggestedPositionedObjectProperties

PositionedObjectProperties में बदलाव का सुझाव दिया गया है.

JSON के काेड में दिखाना
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
फ़ील्ड
positionedObjectProperties

object (PositionedObjectProperties)

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

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

यह मास्क दिखाता है कि इस सुझाव में, बेस PositionedObjectProperties के किन फ़ील्ड में बदलाव किया गया है.

PositionedObjectPropertiesSuggestionState

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

JSON के काेड में दिखाना
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
फ़ील्ड
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में positioning के किन फ़ील्ड में बदलाव किया गया है.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

यह एक मास्क है. इससे पता चलता है कि इस सुझाव में embeddedObject के किन फ़ील्ड में बदलाव किया गया है.

PositionedObjectPositioningSuggestionState

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

JSON के काेड में दिखाना
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
फ़ील्ड
layoutSuggested

boolean

इससे पता चलता है कि layout में बदलाव का कोई सुझाव दिया गया था या नहीं.

leftOffsetSuggested

boolean

इससे पता चलता है कि leftOffset में बदलाव का कोई सुझाव दिया गया था या नहीं.

topOffsetSuggested

boolean

इससे पता चलता है कि topOffset में बदलाव का कोई सुझाव दिया गया था या नहीं.

CommentAnchor

दस्तावेज़ में मौजूद एक या उससे ज़्यादा ऐसी जगहें जो एक ही anchorId के साथ CommentThreads से जुड़ी हों. ध्यान दें: एक से ज़्यादा ऐंकर, एक ही जगह के बारे में बता सकते हैं.

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

string

टिप्पणी के ऐंकर का आईडी.

ranges[]

object (Range)

दस्तावेज़ में मौजूद Range का कलेक्शन, जो इस ऐंकर से जुड़ा है.

SuggestionsViewMode

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

Enums
DEFAULT_FOR_CURRENT_ACCESS जवाब के तौर पर दिखाए गए दस्तावेज़ पर लागू किया गया SuggestionsViewMode, उपयोगकर्ता के मौजूदा ऐक्सेस लेवल पर निर्भर करता है. अगर उपयोगकर्ता के पास सिर्फ़ देखने का ऐक्सेस है, तो PREVIEW_WITHOUT_SUGGESTIONS लागू होता है. ऐसा न होने पर, SUGGESTIONS_INLINE लागू होता है. यह सुझावों को देखने का डिफ़ॉल्ट मोड है.
SUGGESTIONS_INLINE

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

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

PREVIEW_SUGGESTIONS_ACCEPTED

दिखाया गया दस्तावेज़, सुझाए गए सभी बदलावों को स्वीकार करके तैयार की गई झलक है.

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

PREVIEW_WITHOUT_SUGGESTIONS दस्तावेज़ में कोई सुझाव होने पर, आपको सुझाए गए सभी बदलावों को अस्वीकार करके दस्तावेज़ की झलक दिखाई जाती है.

CommentsViewMode

दस्तावेज़ पर लागू किया गया टिप्पणियां देखने का मोड. इससे पता चलता है कि टिप्पणियां शामिल हैं या नहीं. इसमें दस्तावेज़ को टिप्पणियों और टिप्पणी ऐंकर के साथ या उनके बिना पढ़ने के विकल्प मिलते हैं.

अगर आपने commentsViewMode को किसी वैल्यू पर सेट किया है, तो आपको includeTabsContent को true पर भी सेट करना होगा. इसके अलावा, Document.tabs फ़ील्ड (या कोई भी सब-फ़ील्ड) का रेफ़रंस देने वाले फ़ील्ड मास्क का इस्तेमाल किया जा सकता है.

टिप्पणियां सिर्फ़ तब वापस लाई जा सकती हैं, जब इनलाइन सुझाव वापस लाए गए हों. अगर आपने commentsViewMode को COMMENTS_VIEW_MODE_INCLUDED या COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS पर सेट किया है, तो suggestionsViewMode को सिर्फ़ PREVIEW_WITHOUT_SUGGESTIONS या PREVIEW_SUGGESTIONS_ACCEPTED पर सेट किया जा सकता है.

Enums
COMMENTS_VIEW_MODE_UNSPECIFIED CommentsViewMode की जानकारी नहीं दी गई है. COMMENTS_VIEW_MODE_OMITTED लागू किया जाता है.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS जवाब के तौर पर दिखाए गए दस्तावेज़ पर लागू किया गया CommentsViewMode, उपयोगकर्ता के मौजूदा ऐक्सेस लेवल पर निर्भर करता है. अगर उपयोगकर्ता के पास सिर्फ़ देखने का ऐक्सेस है, तो COMMENTS_VIEW_MODE_OMITTED लागू होता है. ऐसा न होने पर, COMMENTS_VIEW_MODE_INCLUDED लागू होता है.
COMMENTS_VIEW_MODE_OMITTED दस्तावेज़ में टिप्पणियां शामिल नहीं की गई हैं.
COMMENTS_VIEW_MODE_INCLUDED

वापस भेजे गए दस्तावेज़ में टिप्पणियां शामिल हैं.

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

इसे सेट करने पर, suggestionsViewMode को भी SUGGESTIONS_INLINE पर सेट करना ज़रूरी है. ऐसा न होने पर, गड़बड़ी 400: गलत अनुरोध का मैसेज दिखता है.

CommentThread

यह किसी टिप्पणी की थ्रेड को दिखाता है.

JSON के काेड में दिखाना
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
फ़ील्ड
commentId

string

टिप्पणी थ्रेड का यूनीक आईडी.

anchorId

string

दस्तावेज़ में मौजूद उस CommentAnchor का आईडी जिससे यह थ्रेड जुड़ी है. एक ही CommentAnchor से कई टिप्पणी थ्रेड जुड़ी हो सकती हैं.

headPost

object (Post)

थ्रेड में पहली पोस्ट.

replies[]

object (Post)

मुख्य पोस्ट के जवाब.

status

enum (Status)

इससे पता चलता है कि थ्रेड खुली है या बंद हो गई है.

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

string

टिप्पणी बनाते समय, दस्तावेज़ से कोट किया गया टेक्स्ट. इसे सादे टेक्स्ट के तौर पर फ़ॉर्मैट किया जाता है.

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

पोस्ट करें

यह किसी टिप्पणी या सुझाव थ्रेड में मौजूद किसी पोस्ट को दिखाता है.

JSON के काेड में दिखाना
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedDocument": boolean,
  "fromCopiedDocument": boolean,
  "fromDocumentComparison": boolean,
  "assigneeEmail": string,

  "commentAction": enum (CommentActionType),
  "suggestionAction": enum (SuggestionActionType)
}
फ़ील्ड
postId

string

सिर्फ़ आउटपुट के लिए. पोस्ट का यूनीक आईडी.

content

string

पोस्ट का कॉन्टेंट.

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

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

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

contentHtml

string

सिर्फ़ आउटपुट के लिए. पोस्ट का कॉन्टेंट, एचटीएमएल के तौर पर.

author

object (PostAuthor)

सिर्फ़ आउटपुट के लिए. पोस्ट बनाने वाला उपयोगकर्ता.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पोस्ट बनाने का समय.

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पोस्ट को आखिरी बार अपडेट किए जाने का समय.

deleted

boolean

सिर्फ़ आउटपुट के लिए. क्या पोस्ट मिटा दी गई है. अगर true, content, और author फ़ील्ड खाली होंगे.

fromImportedDocument

boolean

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

fromCopiedDocument

boolean

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

fromDocumentComparison

boolean

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

assigneeEmail

string

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

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

  • पैरंट थ्रेड एक CommentThread है, जिसके headPost को किसी को असाइन नहीं किया गया है.

  • पैरंट थ्रेड एक SuggestionThread है.

  • commentAction को RESOLVE या REOPEN के तौर पर दिखाया गया हो.

  • assigneeEmail में UTF-8 कोड यूनिट की संख्या 2048 से ज़्यादा है.

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

enum (CommentActionType)

ज़रूरी नहीं. टिप्पणी वाली पोस्ट के लिए कार्रवाई का टाइप.

suggestionAction

enum (SuggestionActionType)

सिर्फ़ आउटपुट के लिए. सुझाव वाली पोस्ट के लिए ऐक्शन का टाइप.

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

PostAuthor

यह उस उपयोगकर्ता को दिखाता है जिसने कोई टिप्पणी की है या सुझाव पोस्ट किया है.

JSON के काेड में दिखाना
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
फ़ील्ड
displayName

string

उपयोगकर्ता का डिसप्ले नेम. अगर लेखक की पहचान छिपाई गई है, तो यह मौजूद नहीं हो सकता.

me

boolean

यह कुकी यह तय करती है कि अनुरोध भेजने वाला उपयोगकर्ता, पुष्टि किया गया उपयोगकर्ता है या नहीं.

anonymous

boolean

उपयोगकर्ता की पहचान छिपी हुई है या नहीं.

user

string

पोस्ट लिखने वाले व्यक्ति का संसाधन नाम. इसका इस्तेमाल, Google People API में उपयोगकर्ता की पहचान करने के लिए भी किया जा सकता है. फ़ॉर्मैट: users/{user}. अगर ऐनॉनमस फ़ील्ड true है या पोस्ट किसी इंपोर्ट किए गए दस्तावेज़ से है, तो यह फ़ील्ड नहीं भरा जाएगा.

CommentActionType

टिप्पणी थ्रेड के इस जवाब पर की गई कार्रवाई.

Enums
COMMENT_ACTION_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
NO_COMMENT_ACTION_CHANGE इस पोस्ट में कोई बदलाव नहीं किया गया है.
RESOLVE इस पोस्ट में थ्रेड से जुड़ी समस्या का समाधान किया गया है.
REOPEN इस पोस्ट से थ्रेड फिर से खुल जाती है.

SuggestionActionType

सुझाव वाली थ्रेड के इस जवाब पर की गई कार्रवाई.

Enums
SUGGESTION_ACTION_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
NO_SUGGESTION_ACTION_CHANGE इस पोस्ट में कोई बदलाव नहीं किया गया है.
ACCEPT इस पोस्ट के लिए सुझाव स्वीकार किया गया है.
REJECT इस पोस्ट में सुझाव को अस्वीकार किया गया है.

स्थिति

टिप्पणी थ्रेड के स्टेटस के विकल्प.

Enums
STATUS_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
OPEN टिप्पणी की थ्रेड खुली है.
RESOLVED टिप्पणी की थ्रेड हल हो गई है.

SuggestionThread

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

JSON के काेड में दिखाना
{
  "suggestionId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),
  "summaryText": string,
  "summaryHtml": string
}
फ़ील्ड
suggestionId

string

सुझाव का यूनीक आईडी.

headPost

object (Post)

थ्रेड में पहली पोस्ट.

replies[]

object (Post)

मुख्य पोस्ट के जवाब.

status

enum (Status)

थ्रेड खुली है, स्वीकार की गई है या अस्वीकार की गई है.

summaryText

string

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

summaryHtml

string

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

स्थिति

सुझाव वाली थ्रेड की स्थिति के विकल्प.

Enums
STATUS_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
OPEN सुझाव वाली थ्रेड खुली है.
ACCEPTED सुझाव वाला थ्रेड स्वीकार कर लिया गया है.
REJECTED सुझाव वाली थ्रेड अस्वीकार कर दी गई है.

तरीके

batchUpdate

दस्तावेज़ में एक या उससे ज़्यादा अपडेट लागू करता है.

create

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

get

इस तरीके से, चुने गए दस्तावेज़ का नया वर्शन मिलता है.