Sheets

शीट

स्प्रेडशीट में मौजूद कोई शीट.

JSON के काेड में दिखाना
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ],
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ]
}
फ़ील्ड
properties

object (SheetProperties)

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

data[]

object (GridData)

अगर यह ग्रिड शीट है, तो ग्रिड में मौजूद डेटा.

लौटाए गए GridData ऑब्जेक्ट की संख्या, इस शीट पर अनुरोध की गई रेंज की संख्या पर निर्भर करती है. उदाहरण के लिए, अगर यह Sheet1 को दिखाता है और स्प्रेडशीट का अनुरोध Sheet1!A1:C10 और Sheet1!D15:E20 रेंज के साथ किया गया था, तो पहले GridData में startRow / startColumn 0 होगा. वहीं, दूसरे GridData में startRow 14 (शून्य पर आधारित पंक्ति 15) और startColumn 3 (शून्य पर आधारित कॉलम D) होगा.

DATA_SOURCE शीट के लिए, किसी खास रेंज का अनुरोध नहीं किया जा सकता. GridData में सभी वैल्यू शामिल होती हैं.

merges[]

object (GridRange)

मर्ज की गई रेंज.

conditionalFormats[]

object (ConditionalFormatRule)

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

filterViews[]

object (FilterView)

इस शीट में मौजूद फ़िल्टर व्यू.

protectedRanges[]

object (ProtectedRange)

इस शीट में सुरक्षित की गई रेंज.

basicFilter

object (BasicFilter)

इस शीट पर लागू किया गया फ़िल्टर.

charts[]

object (EmbeddedChart)

इस शीट पर मौजूद हर चार्ट की खास जानकारी.

bandedRanges[]

object (BandedRange)

इस शीट में बैंडेड (पंक्ति या कॉलम के लिए अलग-अलग रंगों का विकल्प) रेंज.

developerMetadata[]

object (DeveloperMetadata)

किसी शीट से जुड़ा डेवलपर मेटाडेटा.

rowGroups[]

object (DimensionGroup)

इस शीट पर मौजूद सभी लाइन ग्रुप. इन्हें रेंज के शुरुआती इंडेक्स के हिसाब से बढ़ते क्रम में और फिर ग्रुप डेप्थ के हिसाब से क्रम में लगाया जाता है.

columnGroups[]

object (DimensionGroup)

इस शीट पर मौजूद सभी कॉलम ग्रुप. इन्हें रेंज के शुरुआती इंडेक्स के हिसाब से बढ़ते क्रम में और फिर ग्रुप डेप्थ के हिसाब से क्रम में लगाया जाता है.

slicers[]

object (Slicer)

इस शीट पर मौजूद स्लाइसर.

tables[]

object (Table)

इस शीट में मौजूद टेबल.

commentAnchors[]

object (CommentAnchor)

यह टिप्पणी इस शीट पर ऐंकर की गई है.

SheetProperties

किसी शीट की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
फ़ील्ड
sheetId

integer

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

title

string

शीट का नाम.

index

integer

स्प्रेडशीट में मौजूद शीट का इंडेक्स. शीट की प्रॉपर्टी जोड़ते या अपडेट करते समय, अगर इस फ़ील्ड को शामिल नहीं किया जाता है, तो शीट को शीट की सूची के आखिर में जोड़ दिया जाता है या वहां ले जाया जाता है. शीट इंडेक्स अपडेट करते समय या शीट डालते समय, "बदलाव से पहले" इंडेक्स में बदलाव को शामिल किया जाता है. उदाहरण के लिए, अगर तीन शीट (S1, S2, S3) हैं, तो S1 को S2 से पहले ले जाने के लिए, इंडेक्स को 2 पर सेट करना होगा. अगर अनुरोध किया गया इंडेक्स, शीट के मौजूदा इंडेक्स के जैसा ही है या अनुरोध किया गया नया इंडेक्स, शीट के मौजूदा इंडेक्स + 1 के बराबर है, तो शीट इंडेक्स अपडेट करने के अनुरोध को अनदेखा कर दिया जाता है.

sheetType

enum (SheetType)

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

gridProperties

object (GridProperties)

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

अगर यह शीट DATA_SOURCE शीट है, तो यह फ़ील्ड सिर्फ़ आउटपुट होता है.हालांकि, इसमें ऐसी प्रॉपर्टी होती हैं जिनसे पता चलता है कि यूज़र इंटरफ़ेस (यूआई) में डेटा सोर्स शीट कैसे रेंडर की जाती है. उदाहरण के लिए, rowCount.

hidden

boolean

अगर शीट को यूज़र इंटरफ़ेस (यूआई) में छिपाया गया है, तो वैल्यू true होगी. अगर शीट दिख रही है, तो वैल्यू false होगी.

tabColor
(deprecated)

object (Color)

यूज़र इंटरफ़ेस (यूआई) में टैब का रंग. बंद कर दिया गया: tabColorStyle का इस्तेमाल करें.

tabColorStyle

object (ColorStyle)

यूज़र इंटरफ़ेस (यूआई) में टैब का रंग. अगर tabColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

rightToLeft

boolean

अगर शीट, एलटीआर शीट के बजाय आरटीएल शीट है, तो वैल्यू True होगी.

dataSourceSheetProperties

object (DataSourceSheetProperties)

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

SheetType

शीट किस तरह की है.

Enums
SHEET_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू, इसका इस्तेमाल न करें.
GRID शीट एक ग्रिड है.
OBJECT शीट में कोई ग्रिड नहीं है. इसके बजाय, इसमें चार्ट या इमेज जैसा कोई ऑब्जेक्ट है.
DATA_SOURCE यह शीट, किसी बाहरी DataSource से कनेक्ट होती है और डेटा की झलक दिखाती है.

GridProperties

ग्रिड की प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
फ़ील्ड
rowCount

integer

ग्रिड में मौजूद लाइनों की संख्या.

columnCount

integer

ग्रिड में कॉलम की संख्या.

frozenRowCount

integer

ग्रिड में फ़्रीज़ की गई पंक्तियों की संख्या.

frozenColumnCount

integer

ग्रिड में फ़्रीज़ किए गए कॉलम की संख्या.

hideGridlines

boolean

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

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

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

DataSourceSheetProperties

DATA_SOURCE शीट की अन्य प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
फ़ील्ड
dataSourceId

string

उस DataSource का आईडी जिससे शीट कनेक्ट की गई है.

columns[]

object (DataSourceColumn)

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

dataExecutionStatus

object (DataExecutionStatus)

डेटा प्रोसेस करने का स्टेटस.

GridData

ग्रिड में मौजूद डेटा और डाइमेंशन के बारे में मेटाडेटा.

JSON के काेड में दिखाना
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
फ़ील्ड
startRow

integer

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

startColumn

integer

यह GridData जिस पहले कॉलम को दिखाता है वह शून्य पर आधारित होता है.

rowData[]

object (RowData)

ग्रिड में मौजूद डेटा. हर लाइन में एक एंट्री होती है. इसकी शुरुआत startRow में मौजूद लाइन से होती है. RowData में मौजूद वैल्यू, startColumn से शुरू होने वाले कॉलम से मेल खाएंगी.

rowMetadata[]

object (DimensionProperties)

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

columnMetadata[]

object (DimensionProperties)

ग्रिड में मौजूद अनुरोध किए गए कॉलम के बारे में मेटाडेटा. यह startColumn में मौजूद कॉलम से शुरू होता है.

RowData

किसी लाइन में मौजूद हर सेल का डेटा.

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

object (CellData)

लाइन में मौजूद वैल्यू, हर कॉलम के हिसाब से एक वैल्यू.

DimensionProperties

किसी डाइमेंशन के बारे में प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
फ़ील्ड
hiddenByFilter

boolean

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

hiddenByUser

boolean

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

pixelSize

integer

पिक्सल में डाइमेंशन की ऊंचाई (अगर पंक्ति है) या चौड़ाई (अगर कॉलम है).

developerMetadata[]

object (DeveloperMetadata)

किसी एक लाइन या कॉलम से जुड़ा डेवलपर मेटाडेटा.

dataSourceColumnReference

object (DataSourceColumnReference)

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

ConditionalFormatRule

कंडिशनल फ़ॉर्मैटिंग के बारे में बताने वाला नियम.

JSON के काेड में दिखाना
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
}
फ़ील्ड
ranges[]

object (GridRange)

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

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

object (BooleanRule)

नियम के मुताबिक, फ़ॉर्मैटिंग "चालू" या "बंद" होती है.

gradientRule

object (GradientRule)

नियम में मौजूद ग्रेडिएंट के आधार पर, फ़ॉर्मैटिंग अलग-अलग होगी.

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

BooleanRule

ऐसा नियम जो शर्त के हिसाब से मेल खा सकता है या नहीं भी खा सकता है.

JSON के काेड में दिखाना
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
फ़ील्ड
condition

object (BooleanCondition)

नियम की शर्त. अगर शर्त पूरी होती है, तो फ़ॉर्मैट लागू होता है.

format

object (CellFormat)

लागू करने के लिए फ़ॉर्मैट. कंडिशनल फ़ॉर्मैटिंग में, फ़ॉर्मैटिंग का सिर्फ़ एक सबसेट लागू किया जा सकता है: bold, italic, strikethrough, foreground color और, background color.

GradientRule

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

JSON के काेड में दिखाना
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
फ़ील्ड
minpoint

object (InterpolationPoint)

इंटरपोलेशन शुरू होने का पॉइंट.

midpoint

object (InterpolationPoint)

इंटरपोलेशन का एक वैकल्पिक पॉइंट.

maxpoint

object (InterpolationPoint)

इंटरपोलेशन का आखिरी पॉइंट.

InterpolationPoint

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

JSON के काेड में दिखाना
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
फ़ील्ड
color
(deprecated)

object (Color)

वह रंग जिसका इस्तेमाल इस इंटरपोलेशन पॉइंट को करना चाहिए. बंद कर दिया गया: colorStyle का इस्तेमाल करें.

colorStyle

object (ColorStyle)

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

type

enum (InterpolationPointType)

वैल्यू की व्याख्या कैसे की जानी चाहिए.

value

string

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

InterpolationPointType

इंटरपोलेशन पॉइंट का टाइप.

Enums
INTERPOLATION_POINT_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू, इसका इस्तेमाल न करें.
MIN इंटरपोलेशन पॉइंट, शर्त के हिसाब से फ़ॉर्मैटिंग की रेंज में मौजूद सेल में सबसे कम वैल्यू का इस्तेमाल करता है.
MAX इंटरपोलेशन पॉइंट, शर्त के हिसाब से फ़ॉर्मैट की गई रेंज में मौजूद सेल की सबसे बड़ी वैल्यू का इस्तेमाल करता है.
NUMBER इंटरपोलेशन पॉइंट, InterpolationPoint.value में दी गई वैल्यू का इस्तेमाल करता है.
PERCENT

इंटरपोलेशन पॉइंट, शर्त के हिसाब से फ़ॉर्मैट की गई रेंज की सभी सेल में दिया गया प्रतिशत होता है. यह इसके बराबर है NUMBER अगर वैल्यू यह थी: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (जहां फ़्लैट करते समय रेंज में मौजूद गड़बड़ियों को अनदेखा किया जाता है).

PERCENTILE इंटरपोलेशन पॉइंट, शर्त के हिसाब से फ़ॉर्मैट की गई रेंज की सभी सेल पर दिया गया पर्सेंटाइल होता है. यह इसके बराबर है NUMBER अगर वैल्यू यह थी: =PERCENTILE(FLATTEN(range), value / 100) (जहां फ़्लैट करते समय रेंज में मौजूद गड़बड़ियों को अनदेखा किया जाता है).

FilterView

फ़िल्टर व्यू. ज़्यादा जानकारी के लिए, फ़िल्टर की मदद से डेटा दिखने की सुविधा मैनेज करना लेख पढ़ें.

JSON के काेड में दिखाना
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
फ़ील्ड
filterViewId

integer

फ़िल्टर व्यू का आईडी.

title

string

फ़िल्टर व्यू का नाम.

range

object (GridRange)

यह फ़िल्टर व्यू जिस रेंज पर लागू होता है.

लिखते समय, सिर्फ़ एक वैल्यू सेट की जा सकती है. जैसे, range, namedRangeId या tableId.

namedRangeId

string

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

लिखते समय, सिर्फ़ एक वैल्यू सेट की जा सकती है. जैसे, range, namedRangeId या tableId.

tableId

string

अगर इस फ़िल्टर व्यू के लिए कोई टेबल इस्तेमाल की गई है, तो वह टेबल.

लिखते समय, सिर्फ़ एक वैल्यू सेट की जा सकती है. जैसे, range, namedRangeId या tableId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

हर कॉलम के हिसाब से वैल्यू दिखाने/छिपाने की शर्तें. मैप की कुंजी, कॉलम इंडेक्स होती है. साथ ही, वैल्यू उस कॉलम के लिए शर्त होती है.

इस फ़ील्ड को filterSpecs के पक्ष में बंद कर दिया गया है.

filterSpecs[]

object (FilterSpec)

हर कॉलम के लिए वैल्यू दिखाने या छिपाने के लिए फ़िल्टर करने की शर्तें.

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

ProtectedRange

सुरक्षित की गई रेंज.

JSON के काेड में दिखाना
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
फ़ील्ड
protectedRangeId

integer

सुरक्षित की गई रेंज का आईडी. इस फ़ील्ड में मौजूद डेटा को सिर्फ़ पढ़ा जा सकता है.

range

object (GridRange)

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

लिखते समय, सिर्फ़ एक range या namedRangeId या tableId सेट किया जा सकता है.

namedRangeId

string

अगर सुरक्षित की गई इस रेंज को नाम वाली किसी रेंज से बैक अप लिया गया है, तो उसका नाम.

लिखते समय, सिर्फ़ एक range या namedRangeId या tableId सेट किया जा सकता है.

tableId

string

अगर सुरक्षित की गई इस रेंज के लिए कोई टेबल इस्तेमाल की गई है, तो उसकी जानकारी.

लिखते समय, सिर्फ़ एक range या namedRangeId या tableId सेट किया जा सकता है.

description

string

सुरक्षित की गई इस रेंज की जानकारी.

warningOnly

boolean

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

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

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object (GridRange)

सुरक्षित की गई शीट में मौजूद असुरक्षित रेंज की सूची. असुरक्षित रेंज सिर्फ़ सुरक्षित की गई शीट पर काम करती हैं.

editors

object (Editors)

उन उपयोगकर्ताओं और ग्रुप के नाम जिनके पास सुरक्षित की गई रेंज में बदलाव करने का ऐक्सेस है. यह फ़ील्ड सिर्फ़ उन लोगों को दिखता है जिनके पास सुरक्षित की गई रेंज और दस्तावेज़ में बदलाव करने का ऐक्सेस है. एडिटर के लिए, warningOnly सुरक्षा की सुविधा उपलब्ध नहीं है.

संपादक

सुरक्षित की गई रेंज के एडिटर.

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

string

सुरक्षित की गई रेंज में बदलाव करने का ऐक्सेस रखने वाले उपयोगकर्ताओं के ईमेल पते.

groups[]

string

उन ग्रुप के ईमेल पते जिनके पास सुरक्षित की गई रेंज में बदलाव करने का ऐक्सेस है.

domainUsersCanEdit

boolean

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

BasicFilter

किसी शीट से जुड़ा डिफ़ॉल्ट फ़िल्टर. ज़्यादा जानकारी के लिए, फ़िल्टर की मदद से डेटा दिखने की सुविधा मैनेज करना लेख पढ़ें.

JSON के काेड में दिखाना
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
फ़ील्ड
range

object (GridRange)

वह रेंज जिस पर फ़िल्टर लागू होता है.

tableId

string

वह टेबल जिससे यह फ़िल्टर जुड़ा है. लिखते समय, सिर्फ़ range या tableId में से किसी एक को सेट किया जा सकता है.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

हर कॉलम के हिसाब से वैल्यू दिखाने/छिपाने की शर्तें. मैप की कुंजी, कॉलम इंडेक्स होती है. साथ ही, वैल्यू उस कॉलम के लिए शर्त होती है.

इस फ़ील्ड को filterSpecs के पक्ष में बंद कर दिया गया है.

filterSpecs[]

object (FilterSpec)

हर कॉलम के लिए फ़िल्टर करने की शर्तें.

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

BandedRange

किसी शीट में बैंड की गई (पंक्ति या कॉलम के लिए अलग-अलग रंगों का विकल्प) रेंज.

JSON के काेड में दिखाना
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
फ़ील्ड
bandedRangeId

integer

बैंड की गई रेंज का आईडी. अगर इसे सेट नहीं किया गया है, तो bandedRangeReference देखें.

bandedRangeReference

string

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

range

object (GridRange)

वह रेंज जिस पर ये प्रॉपर्टी लागू होती हैं.

rowProperties

object (BandingProperties)

लाइन बैंड के लिए प्रॉपर्टी. ये प्रॉपर्टी, रेंज की सभी लाइनों में लाइन-दर-लाइन लागू होती हैं. rowProperties या columnProperties में से कम से कम एक की जानकारी देना ज़रूरी है.

columnProperties

object (BandingProperties)

कॉलम बैंड के लिए प्रॉपर्टी. ये प्रॉपर्टी, रेंज के सभी कॉलम में कॉलम के हिसाब से लागू होती हैं. rowProperties या columnProperties में से कम से कम एक की जानकारी देना ज़रूरी है.

BandingProperties

ऐसी प्रॉपर्टी जो किसी एक डाइमेंशन (लाइन या कॉलम) को रेफ़र करती हैं. अगर BandedRange.row_properties और BandedRange.column_properties, दोनों को सेट किया गया है, तो सेल में रंग भरने के लिए ये नियम लागू होते हैं:

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

JSON के काेड में दिखाना
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
फ़ील्ड
headerColor
(deprecated)

object (Color)

पहली लाइन या कॉलम का रंग. इस फ़ील्ड को सेट करने पर, पहली लाइन या कॉलम में यह रंग भर जाता है. इसके बाद, दूसरी लाइन या कॉलम से शुरू होकर, firstBandColor और secondBandColor रंग बारी-बारी से दिखते हैं. ऐसा न करने पर, पहली लाइन या कॉलम में firstBandColor भर जाता है. इसके बाद, रंग सामान्य तरीके से बदलते रहते हैं. बंद कर दिया गया: headerColorStyle का इस्तेमाल करें.

headerColorStyle

object (ColorStyle)

पहली लाइन या कॉलम का रंग. इस फ़ील्ड को सेट करने पर, पहली लाइन या कॉलम में यह रंग भर जाता है. इसके बाद, दूसरी लाइन या कॉलम से शुरू होकर, firstBandColor और secondBandColor रंग बारी-बारी से दिखते हैं. ऐसा न करने पर, पहली लाइन या कॉलम में firstBandColor भर जाता है. इसके बाद, रंग सामान्य तरीके से बदलते रहते हैं. अगर headerColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

firstBandColor
(deprecated)

object (Color)

बदले जा रहे रंगों में से पहला रंग. (ज़रूरी है) अब सेवा में नहीं है: firstBandColorStyle का इस्तेमाल करें.

firstBandColorStyle

object (ColorStyle)

बदले जा रहे रंगों में से पहला रंग. (ज़रूरी है) अगर firstBandColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

secondBandColor
(deprecated)

object (Color)

यह दूसरा रंग है, जो बारी-बारी से दिखता है. (ज़रूरी है) अब सेवा में नहीं है: secondBandColorStyle का इस्तेमाल करें.

secondBandColorStyle

object (ColorStyle)

यह दूसरा रंग है, जो बारी-बारी से दिखता है. (ज़रूरी है) अगर secondBandColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

footerColor
(deprecated)

object (Color)

आखिरी लाइन या कॉलम का रंग. इस फ़ील्ड के सेट नहीं होने पर, आखिरी लाइन या कॉलम में firstBandColor या secondBandColor में से कोई एक भरा जाता है. यह पिछली लाइन या कॉलम के रंग पर निर्भर करता है. बंद कर दिया गया: footerColorStyle का इस्तेमाल करें.

footerColorStyle

object (ColorStyle)

आखिरी लाइन या कॉलम का रंग. इस फ़ील्ड के सेट नहीं होने पर, आखिरी लाइन या कॉलम में firstBandColor या secondBandColor में से कोई एक भरा जाता है. यह पिछली लाइन या कॉलम के रंग पर निर्भर करता है. अगर footerColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

DimensionGroup

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

JSON के काेड में दिखाना
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
फ़ील्ड
range

object (DimensionRange)

वह रेंज जिसमें यह ग्रुप मौजूद है.

depth

integer

ग्रुप की डेप्थ. इससे पता चलता है कि कितने ग्रुप में ऐसी रेंज है जिसमें इस ग्रुप की पूरी रेंज शामिल है.

collapsed

boolean

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

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

स्लाइसर

शीट में मौजूद स्लाइसर.

JSON के काेड में दिखाना
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
फ़ील्ड
slicerId

integer

स्लाइसर का आईडी.

spec

object (SlicerSpec)

स्लाइसर की खास जानकारी.

position

object (EmbeddedObjectPosition)

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

SlicerSpec

स्लाइसर की खास बातें.

JSON के काेड में दिखाना
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
फ़ील्ड
dataRange

object (GridRange)

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

filterCriteria

object (FilterCriteria)

स्लाइसर के लिए फ़िल्टर करने की शर्तें.

columnIndex

integer

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

applyToPivotTables

boolean

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

title

string

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

textFormat

object (TextFormat)

स्लाइसर में मौजूद टाइटल का टेक्स्ट फ़ॉर्मैट. लिंक फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

backgroundColor
(deprecated)

object (Color)

स्लाइसर के बैकग्राउंड का रंग. बंद कर दिया गया: backgroundColorStyle का इस्तेमाल करें.

backgroundColorStyle

object (ColorStyle)

स्लाइसर के बैकग्राउंड का रंग. अगर backgroundColor भी सेट है, तो इस फ़ील्ड को प्राथमिकता दी जाती है.

horizontalAlignment

enum (HorizontalAlign)

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

टेबल

टेबल.

JSON के काेड में दिखाना
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
फ़ील्ड
tableId

string

टेबल का आईडी.

name

string

टेबल का नाम. यह एक ही स्प्रेडशीट की सभी टेबल के लिए यूनीक होता है.

range

object (GridRange)

टेबल की रेंज.

rowsProperties

object (TableRowsProperties)

टेबल की लाइनों की प्रॉपर्टी.

columnProperties[]

object (TableColumnProperties)

टेबल कॉलम की प्रॉपर्टी.

TableRowsProperties

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

JSON के काेड में दिखाना
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
फ़ील्ड
headerColorStyle

object (ColorStyle)

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

firstBandColorStyle

object (ColorStyle)

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

secondBandColorStyle

object (ColorStyle)

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

footerColorStyle

object (ColorStyle)

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

TableColumnProperties

टेबल का कॉलम.

JSON के काेड में दिखाना
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
फ़ील्ड
columnIndex

integer

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

columnName

string

कॉलम का नाम.

columnType

enum (ColumnType)

कॉलम का टाइप.

dataValidationRule

object (TableColumnDataValidationRule)

कॉलम के डेटा की पुष्टि करने का नियम. इसे सिर्फ़ ड्रॉपडाउन कॉलम टाइप के लिए सेट किया जाता है.

ColumnType

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

Enums
COLUMN_TYPE_UNSPECIFIED कॉलम के टाइप की जानकारी नहीं दी गई है.
DOUBLE संख्या वाला कॉलम टाइप.
CURRENCY मुद्रा कॉलम का टाइप.
PERCENT प्रतिशत कॉलम का टाइप.
DATE तारीख वाले कॉलम का टाइप.
TIME समय कॉलम का टाइप.
DATE_TIME तारीख और समय कॉलम का टाइप.
TEXT टेक्स्ट कॉलम का टाइप.
BOOLEAN बूलियन कॉलम टाइप.
DROPDOWN ड्रॉपडाउन कॉलम का टाइप.
FILES_CHIP फ़ाइल चिप कॉलम टाइप
PEOPLE_CHIP लोगों की जानकारी देने वाला चिप कॉलम टाइप
FINANCE_CHIP फ़ाइनेंस चिप कॉलम टाइप
PLACE_CHIP जगह की जानकारी देने वाला चिप कॉलम टाइप
RATINGS_CHIP रेटिंग चिप कॉलम टाइप

TableColumnDataValidationRule

किसी टेबल के कॉलम के लिए डेटा की पुष्टि करने का नियम.

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

object (BooleanCondition)

वह शर्त जिसके मुताबिक सेल में मौजूद डेटा मेल खाना चाहिए. यह सिर्फ़ तब मान्य होता है, जब [BooleanCondition.type] की वैल्यू ONE_OF_LIST पर सेट हो.

CommentAnchor

स्प्रेडशीट में मौजूद ऐसी जगह जो एक ही anchorId वाले CommentThread से जुड़ी हो. ध्यान दें: एक से ज़्यादा ऐंकर, एक ही जगह के बारे में बता सकते हैं.

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

string

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

range

object (GridRange)

शीट में मौजूद वह कोऑर्डिनेट रेंज जहां यह टिप्पणी पिन की गई है.