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)
    }
  ]
}
फ़ील्ड
spreadsheetId

string

स्प्रेडशीट का आईडी. यह फ़ील्ड रीड-ओनली है.
properties

object (SpreadsheetProperties)

स्प्रेडशीट की सभी प्रॉपर्टी.
sheets[]

object (Sheet)

स्प्रेडशीट का हिस्सा बनने वाली शीट.
namedRanges[]

object (NamedRange)

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

string

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

object (DeveloperMetadata)

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

object (DataSource)

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

object (DataSourceRefreshSchedule)

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

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

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

  • आईएसओ भाषा कोड और देश कोड का कॉम्बिनेशन, जैसे कि 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

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

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)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
फ़ील्ड
parameters[]

object (DataSourceParameter)

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

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][].

BigQueryDataSourceSpec

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

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

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
फ़ील्ड
projectId

string

BigQuery की सुविधा वाले Google Cloud प्रोजेक्ट का आईडी, जिसमें बिलिंग खाता जुड़ा हो. डेटा सोर्स के लिए की गई किसी भी क्वेरी पर, प्रोजेक्ट से शुल्क लिया जाता है.
यूनियन फ़ील्ड spec. असल जानकारी. spec इनमें से कोई एक हो सकता है:
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 के काेड में दिखाना 
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
फ़ील्ड
यूनियन फ़ील्ड identifier. पैरामीटर आइडेंटिफ़ायर. identifier इनमें से सिर्फ़ एक हो सकता है:
name

string

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

string

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

object (GridRange)

वह रेंज जिसमें पैरामीटर की वैल्यू होती है. इसका साइज़ 1x1 होना चाहिए.

DataSourceRefreshSchedule

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

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

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

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
फ़ील्ड
enabled

boolean

अगर रीफ़्रेश शेड्यूल चालू है, तो 'सही' और नहीं होने पर 'गलत' दिखाता है.
refreshScope

enum (DataSourceRefreshScope)

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

object (Interval)

सिर्फ़ आउटपुट के लिए. अगले रन का समय अंतराल.
यूनियन फ़ील्ड schedule_config. शेड्यूल कॉन्फ़िगरेशन schedule_config, इनमें से कोई एक हो सकता है:
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 से 999,999,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)

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

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

तरीके

batchUpdate

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

create

 एक स्प्रेडशीट बनाता है, जिसमें नई स्प्रेडशीट दिखाई जाती है.

get

 दिए गए आईडी पर मौजूद स्प्रेडशीट दिखाता है.

getByDataFilter

 दिए गए आईडी पर मौजूद स्प्रेडशीट दिखाता है.