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

स्प्रेडशीट का टाइम ज़ोन, जैसे कि America/New_York. CLDR फ़ॉर्मैट में. अगर टाइम ज़ोन की पहचान नहीं हो पाई है, तो यह कस्टम टाइम ज़ोन हो सकता है, जैसे कि 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 हिस्से का इस्तेमाल किया जाता है. शीट एडिटर में टाइम इंटरवल का साइज़, डिफ़ॉल्ट तौर पर उसके साइज़ पर सेट होता है.

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 से 9,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)

ज़रूरी नहीं. इंटरवल का खास खत्म होना.

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

तरीके

batchUpdate

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

create

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

get

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

getByDataFilter

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