REST Resource: spreadsheets

संसाधन: स्प्रेडशीट

स्प्रेडशीट को दिखाने वाला संसाधन.

JSON के काेड में दिखाना 
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
फ़ील्ड
spreadsheetId

string

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

object (SpreadsheetProperties)

स्प्रेडशीट की सामान्य प्रॉपर्टी.
sheets[]

object (Sheet)

स्प्रेडशीट में शामिल शीट.
namedRanges[]

object (NamedRange)

स्प्रेडशीट में तय की गई नाम वाली रेंज.
spreadsheetUrl

string

स्प्रेडशीट का यूआरएल. इस फ़ील्ड में मौजूद डेटा को सिर्फ़ पढ़ा जा सकता है.
developerMetadata[]

object (DeveloperMetadata)

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

object (DataSource)

स्प्रेडशीट से कनेक्ट किए गए बाहरी डेटा सोर्स की सूची.
dataSourceSchedules[]

object (DataSourceRefreshSchedule)

सिर्फ़ आउटपुट के लिए. डेटा सोर्स रीफ़्रेश करने के शेड्यूल की सूची.
comments[]

object (CommentThread)

स्प्रेडशीट से जुड़ी टिप्पणियों की थ्रेड.
commentsViewMode

enum (CommentsViewMode)

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

SpreadsheetProperties

स्प्रेडशीट की प्रॉपर्टी.

JSON के काेड में दिखाना 
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
फ़ील्ड
title

string

स्प्रेडशीट का टाइटल.
locale

string

स्प्रैडशीट का स्थान-भाषा, इनमें से किसी एक फ़ॉर्मैट में:

  • ISO 639-1 भाषा कोड, जैसे कि en

  • अगर ISO 639-1 कोड मौजूद नहीं है, तो ISO 639-2 भाषा कोड, जैसे कि fil

  • आईएसओ भाषा कोड और देश के कोड का कॉम्बिनेशन, जैसे कि en_US

ध्यान दें: इस फ़ील्ड को अपडेट करते समय, सभी स्थान-भाषाएं/भाषाएं काम नहीं करती हैं.
autoRecalc

enum (RecalculationInterval)

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

string

स्प्रेडशीट का टाइम ज़ोन, CLDR फ़ॉर्मैट में. जैसे, America/New_York. अगर टाइम ज़ोन की पहचान नहीं हो पाती है, तो हो सकता है कि यह कस्टम टाइम ज़ोन हो, जैसे कि GMT-07:00.
defaultFormat

object (CellFormat)

स्प्रेडशीट की सभी सेल का डिफ़ॉल्ट फ़ॉर्मैट. अगर सेल का फ़ॉर्मैट इस डिफ़ॉल्ट फ़ॉर्मैट के बराबर है, तो CellData.effectiveFormat सेट नहीं किया जाएगा. इस फ़ील्ड में मौजूद डेटा को सिर्फ़ पढ़ा जा सकता है.
iterativeCalculationSettings

object (IterativeCalculationSettings)

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

object (SpreadsheetTheme)

स्प्रेडशीट पर थीम लागू की गई.
importFunctionsExternalUrlAccessAllowed

boolean

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

RecalculationInterval

रीकैल्क्युलेशन के इंटरवल के संभावित विकल्पों की गिनती.

Enums
RECALCULATION_INTERVAL_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
ON_CHANGE वोलाटाइल फ़ंक्शन, हर बदलाव पर अपडेट होते हैं.
MINUTE वोलाटाइल फ़ंक्शन, हर बदलाव और हर मिनट में अपडेट होते हैं.
HOUR वोलाटाइल फ़ंक्शन, हर बदलाव और हर घंटे अपडेट होते हैं.

IterativeCalculationSettings

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

JSON के काेड में दिखाना 
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
फ़ील्ड
maxIterations

integer

इटरेटिव कैलकुलेशन चालू होने पर, कैलकुलेशन के ज़्यादा से ज़्यादा राउंड पूरे किए जा सकते हैं.
convergenceThreshold

number

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

SpreadsheetTheme

यह स्प्रेडशीट की थीम को दिखाता है

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

string

प्राइमरी फ़ॉन्ट फ़ैमिली का नाम.
themeColors[]

object (ThemeColorPair)

स्प्रेडशीट की थीम के रंग के जोड़े. अपडेट करने के लिए, आपको थीम के कलर के सभी पेयर देने होंगे.

ThemeColorPair

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

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

enum (ThemeColorType)

स्प्रेडशीट की थीम के रंग का टाइप.
color

object (ColorStyle)

थीम के रंग के टाइप से मेल खाने वाला रंग.

NamedRange

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

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

string

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

string

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

object (GridRange)

यह रेंज दिखाता है.

DataSource

स्प्रेडशीट में मौजूद बाहरी डेटा सोर्स के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
फ़ील्ड
dataSourceId

string

स्प्रेडशीट के स्कोप वाला यूनीक आईडी, जो डेटा सोर्स की पहचान करता है. उदाहरण: 1080547365.
spec

object (DataSourceSpec)

इस स्प्रेडशीट से कनेक्ट किए गए डेटा सोर्स के लिए DataSourceSpec.
calculatedColumns[]

object (DataSourceColumn)

डेटा सोर्स में मौजूद सभी कैलकुलेटेड कॉलम.
sheetId

integer

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

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

DataSourceSpec

इससे डेटा सोर्स की जानकारी मिलती है. उदाहरण के लिए, BigQuery के लिए यह BigQuery सोर्स के बारे में जानकारी देता है.

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

  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
}
फ़ील्ड
parameters[]

object (DataSourceParameter)

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

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

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

BigQueryDataSourceSpec

यह किसी शीट से कनेक्ट किए गए BigQuery डेटा सोर्स की जानकारी है.

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

  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
}
फ़ील्ड
projectId

string

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

object (BigQueryQuerySpec)

BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

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

BigQueryQuerySpec

यह BigQuery की कस्टम क्वेरी के बारे में बताता है.

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

string

रॉ क्वेरी स्ट्रिंग.

BigQueryTableSpec

यह BigQuery टेबल की परिभाषा के बारे में बताता है. सिर्फ़ नेटिव टेबल इस्तेमाल की जा सकती हैं.

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

string

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

string

BigQuery टेबल का आईडी.
datasetId

string

BigQuery डेटासेट आईडी.

LookerDataSourceSpec

Looker डेटा सोर्स की जानकारी.

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

string

Looker इंस्टेंस का यूआरएल.
model

string

Looker मॉडल का नाम.
explore

string

Looker मॉडल एक्सप्लोर का नाम.

DataSourceParameter

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

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

  "name": string

  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
}
फ़ील्ड
पैरामीटर आइडेंटिफ़ायर. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
name

string

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

string

NamedRange का आईडी. इसका साइज़ 1x1 होना चाहिए.
range

object (GridRange)

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

DataSourceRefreshSchedule

डेटा सोर्स को रीफ़्रेश करने का शेड्यूल.

स्प्रेडशीट में मौजूद डेटा सोर्स को एक तय समय अंतराल में रीफ़्रेश किया जाता है. Sheets एडिटर में, 'शेड्यूल किया गया रीफ़्रेश' बटन पर क्लिक करके, शुरू होने का समय तय किया जा सकता है. हालांकि, रीफ़्रेश होने का समय चार घंटे पर सेट होता है. उदाहरण के लिए, अगर आपने डेटा रीफ़्रेश होने का समय सुबह 8 बजे सेट किया है , तो डेटा हर दिन सुबह 8 बजे से दोपहर 12 बजे के बीच रीफ़्रेश होगा.

JSON के काेड में दिखाना 
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
}
फ़ील्ड
enabled

boolean

अगर रीफ़्रेश करने का शेड्यूल चालू है, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी.
refreshScope

enum (DataSourceRefreshScope)

रीफ़्रेश का स्कोप. ALL_DATA_SOURCES होना चाहिए.
nextRun

object (Interval)

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

object (DataSourceRefreshDailySchedule)

रोज़ाना रीफ़्रेश करने का शेड्यूल.
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

हर हफ़्ते रीफ़्रेश करने का शेड्यूल.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

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

DataSourceRefreshScope

डेटा सोर्स रीफ़्रेश करने के स्कोप.

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

DataSourceRefreshDailySchedule

किसी तय समयावधि में, हर दिन डेटा रीफ़्रेश करने का शेड्यूल.

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

object (TimeOfDay)

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

TimeOfDay

यह दिन के समय को दिखाता है. तारीख और टाइम ज़ोन की जानकारी अहम नहीं है या इसे कहीं और बताया गया है. कोई एपीआई, लीप सेकंड की अनुमति दे सकता है. इससे मिलते-जुलते टाइप google.type.Date और google.protobuf.Timestamp हैं.

JSON के काेड में दिखाना 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
फ़ील्ड
hours

integer

दिन के घंटे, 24 घंटे वाले फ़ॉर्मैट में. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 23 से कम या इसके बराबर होनी चाहिए. कारोबार के बंद होने के समय जैसे मामलों के लिए, कोई एपीआई "24:00:00" वैल्यू को अनुमति दे सकता है.
minutes

integer

घंटे के मिनट. वैल्यू, 0 से ज़्यादा या इसके बराबर और 59 से कम या इसके बराबर होनी चाहिए.
seconds

integer

एक मिनट के कुछ सेकंड. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 59 से कम या इसके बराबर होनी चाहिए. अगर कोई एपीआई लीप-सेकंड की अनुमति देता है, तो वह वैल्यू 60 की अनुमति दे सकता है.
nanos

integer

सेकंड के हिस्से, नैनोसेकंड में. यह वैल्यू 0 से ज़्यादा या इसके बराबर और 99,99,99,999 से कम या इसके बराबर होनी चाहिए.

DataSourceRefreshWeeklySchedule

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

JSON के काेड में दिखाना 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
फ़ील्ड
startTime

object (TimeOfDay)

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

enum (DayOfWeek)

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

DayOfWeek

यह हफ़्ते के किसी दिन को दिखाता है.

Enums
DAY_OF_WEEK_UNSPECIFIED हफ़्ते का दिन नहीं बताया गया है.
MONDAY सोमवार
TUESDAY मंगलवार
WEDNESDAY बुधवार
THURSDAY गुरुवार
FRIDAY शुक्रवार
SATURDAY शनिवार
SUNDAY रविवार

DataSourceRefreshMonthlySchedule

महीने के किसी खास दिन पर, तय समय अंतराल में डेटा रीफ़्रेश करने के लिए, हर महीने का शेड्यूल.

JSON के काेड में दिखाना 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
फ़ील्ड
startTime

object (TimeOfDay)

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

integer

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

इंटरवल

यह टाइम इंटरवल को दिखाता है. इसे टाइमस्टैंप के तौर पर कोड किया जाता है. इसमें टाइमस्टैंप के शुरू होने का समय (शामिल है) और टाइमस्टैंप के खत्म होने का समय (शामिल नहीं है) होता है.

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

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

string (Timestamp format)

ज़रूरी नहीं. समय अंतराल शुरू होने का समय शामिल है.

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

string (Timestamp format)

ज़रूरी नहीं. इंटरवल खत्म होने का समय (अलग से उपलब्ध).

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

CommentThread

यह स्प्रेडशीट में मौजूद किसी टिप्पणी की थ्रेड को दिखाता है.

JSON के काेड में दिखाना 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
फ़ील्ड
commentId

string

टिप्पणी थ्रेड का यूनीक आईडी.
anchorId

string

शीट में मौजूद उस 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,
  "fromImportedSpreadsheet": boolean,
  "fromCopiedSpreadsheet": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
फ़ील्ड
postId

string

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

string

पोस्ट का कॉन्टेंट.

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

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

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

string

सिर्फ़ आउटपुट के लिए. पोस्ट का कॉन्टेंट, एचटीएमएल के तौर पर.
author

object (PostAuthor)

सिर्फ़ आउटपुट के लिए. पोस्ट बनाने वाला उपयोगकर्ता.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पोस्ट बनाने का समय.
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पोस्ट को आखिरी बार अपडेट किए जाने का समय.
deleted

boolean

सिर्फ़ आउटपुट के लिए. क्या पोस्ट मिटा दी गई है. अगर true, content, और author फ़ील्ड खाली होंगे.
fromImportedSpreadsheet

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पोस्ट, कॉपी की गई स्प्रेडशीट से है या नहीं. इस फ़ील्ड को कॉल करने वाले लोग सीधे तौर पर सेट नहीं कर सकते.
assigneeEmail

string

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

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

  • पैरंट थ्रेड एक CommentThread है, जिसके headPost को किसी को असाइन नहीं किया गया है.

  • commentAction को RESOLVE या REOPEN के तौर पर दिखाया गया हो.

  • assigneeEmail में UTF-8 कोड यूनिट की संख्या 2048 से ज़्यादा है.
commentAction

enum (CommentActionType)

पोस्ट बनाते समय की गई कार्रवाई.

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 इस पोस्ट से थ्रेड फिर से खुल जाती है.

स्थिति

टिप्पणी थ्रेड के स्टेटस के विकल्प.

Enums
STATUS_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
OPEN टिप्पणी की थ्रेड खुली है.
RESOLVED टिप्पणी की थ्रेड हल हो गई है.

CommentsViewMode

स्प्रेडशीट पर लागू किया गया टिप्पणियां देखने का मोड. इससे पता चलता है कि टिप्पणियां शामिल हैं या नहीं. यह सुविधा, टिप्पणियों और टिप्पणी ऐंकर के साथ या उनके बिना स्प्रेडशीट को पढ़ने के विकल्प देती है.

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 गड़बड़ी का मैसेज दिखेगा. ऐसा तब होगा, जब उपयोगकर्ता के पास टिप्पणियां देखने की अनुमति नहीं होगी.

तरीके

batchUpdate

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

create

 यह फ़ंक्शन एक स्प्रेडशीट बनाता है और नई बनाई गई स्प्रेडशीट दिखाता है.

get

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

getByDataFilter

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