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

रीफ़्रेश शेड्यूल चालू होने पर True और बंद होने पर False दिखाता है.
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

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