REST Resource: spreadsheets

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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

जेएसओएन के काेड में दिखाना
{
  "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-2 भाषा कोड, जैसे कि fil, अगर कोई 639-1 कोड मौजूद नहीं है

  • ISO भाषा कोड और देश कोड का संयोजन, जैसे 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

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

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

integer

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

convergenceThreshold

number

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

SpreadsheetTheme

स्प्रेडशीट थीम के बारे में बताता है

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

string

मुख्य फ़ॉन्ट फ़ैमिली का नाम.

themeColors[]

object (ThemeColorPair)

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

ThemeColorPair

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

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

enum (ThemeColorType)

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

color

object (ColorStyle)

थीम के रंग के टाइप के हिसाब से कंक्रीट का रंग.

NamedRange

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

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

string

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

name

string

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

range

object (GridRange)

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

DataSource

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

जेएसओएन के काेड में दिखाना
{
  "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 सोर्स के बारे में जानकारी तय करता है.

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

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

object (DataSourceParameter)

डेटा सोर्स के पैरामीटर, जिनका इस्तेमाल डेटा सोर्स की क्वेरी करते समय किया जाता है.

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

object (BigQueryDataSourceSpec)

एक BigQueryDataSourceSpec.

BigQueryDataSourceSpec

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

जेएसओएन के काेड में दिखाना
{
  "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 क्वेरी के बारे में बताता है.

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

string

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

BigQueryTableSpec

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

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

string

उस BigQuery प्रोजेक्ट का आईडी जिससे टेबल संबंधित है. अगर इसके बारे में नहीं बताया गया है, तो projectId माना जाता है.

tableId

string

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

datasetId

string

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

DataSourceParameter

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

जेएसओएन के काेड में दिखाना
{

  // 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 बजे के बीच रीफ़्रेश होगी.

जेएसओएन के काेड में दिखाना
{
  "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

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

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

object (TimeOfDay)

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

TimeOfDay

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

जेएसओएन के काेड में दिखाना
{
  "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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

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

object (TimeOfDay)

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

daysOfMonth[]

integer

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

इंटरवल

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

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

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

string (Timestamp format)

ज़रूरी नहीं. इंटरवल की इनक्लूसिव शुरुआत.

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

endTime

string (Timestamp format)

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

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

तरीके

batchUpdate

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

create

नई स्प्रेडशीट दिखाने वाली स्प्रेडशीट बनाता है.

get

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

getByDataFilter

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