Sheets API v3 से माइग्रेट करें

v3 API

Sheets API v3, अनुमति के एक दायरे के साथ काम करता है:

https://spreadsheets.google.com/feeds

जो

https://www.googleapis.com/auth/spreadsheets

दोनों में से किसी भी स्कोप फ़ॉर्मैट का इस्तेमाल किया जा सकता है.

v4 API

Sheets API v4, स्कोप के इनमें से एक या एक से ज़्यादा सेट का इस्तेमाल करता है:

https://www.googleapis.com/auth/spreadsheets.readonly
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

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

v3 API

Sheets API v3, एंडपॉइंट में सीधे तौर पर दिखाता है कि डेटा दिख रहा है या नहीं. public स्प्रेडशीट को "वेब पर पब्लिश" किया गया है. इसलिए, एपीआई को अनुमति के बिना इसे ऐक्सेस करने की अनुमति है. वहीं, private स्प्रेडशीट को ऐक्सेस करने के लिए पुष्टि करना ज़रूरी है. स्प्रेडशीट आईडी के बाद एंडपॉइंट में, विज़िबिलिटी की जानकारी दी जाती है:

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

v4 API

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

v3 API

Sheets API v3 में, प्रोजेक्शन की सिर्फ़ दो सेटिंग हो सकती हैं. full प्रोजेक्शन, उपलब्ध सभी जानकारी दिखाता है, जबकि basic वर्कशीट, सूची, और सेल फ़ीड के लिए, डेटा का छोटा और तय सबसेट दिखाता है. दिखने की सेटिंग की तरह ही, प्रोजेक्शन की जानकारी भी एपीआई एंडपॉइंट में दी जानी चाहिए (दिखने की सेटिंग के बाद):

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/public/basic

basic प्रोजेक्शन से मिले डेटा का छोटा सबसेट, कोड को ज़्यादा बेहतर बनाने के लिए अहम होता है. हालांकि, इसे पसंद के मुताबिक नहीं बनाया जा सकता.

v4 API

Sheets API v4, पूरा डेटा सेट दिखा सकता है. हालांकि, यह Sheets API v3 की basic विज़िबिलिटी सेटिंग की तरह, तय किए गए सबसेट तय नहीं करता. स्प्रेडशीट कलेक्शन के तरीके, फ़ील्ड क्वेरी पैरामीटर का इस्तेमाल करके, दिखाए जाने वाले डेटा की संख्या को सीमित करते हैं.

उदाहरण के लिए, यहां दी गई क्वेरी से किसी स्प्रेडशीट में मौजूद सभी स्प्रेडशीट के टाइटल ही दिखते हैं:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?fields=sheets.properties.title

v3 API

Sheets API v3 में, नई स्प्रेडशीट बनाने का तरीका नहीं दिया गया है. इसके बजाय, नई स्प्रेडशीट फ़ाइलें बनाने के लिए, Drive API Files.create तरीके का इस्तेमाल किया जा सकता है. इसके लिए, ऐप्लिकेशन को https://www.googleapis.com/auth/drive स्कोप का एलान करना होगा.

v4 API

Drive API Files.create तरीके का इस्तेमाल, Sheets API v4 के साथ भी किया जा सकता है. हालांकि, इसके लिए ऐप्लिकेशन को https://www.googleapis.com/auth/drive स्कोप देना ज़रूरी है.

इसके बराबर के विकल्प के तौर पर, Sheets API v4 में spreadsheets.create तरीका उपलब्ध है. इसकी मदद से, स्प्रेडशीट जोड़ी जा सकती हैं, स्प्रेडशीट और शीट की प्रॉपर्टी सेट की जा सकती हैं, और नाम वाली रेंज जोड़ी जा सकती हैं. उदाहरण के लिए, यह फ़ंक्शन एक नई स्प्रेडशीट बनाता है और उसे "NewTitle" नाम देता है:

POST https://sheets.googleapis.com/v4/spreadsheets

{
 "properties": {"title": "NewTitle"}
}

v3 API

Sheets API v3 फ़ीड की मदद से, ऐप्लिकेशन उन सभी स्प्रेडशीट की सूची पा सकता है जिन्हें पुष्टि किए गए उपयोगकर्ता ऐक्सेस कर सकते हैं. स्प्रेडशीट फ़ीड का एंडपॉइंट यह है:

GET https://spreadsheets.google.com/feeds/spreadsheets/private/full

v4 API

Sheets API v4 में यह कार्रवाई उपलब्ध नहीं है. हमारा सुझाव है कि आप अपने ऐप्लिकेशन को माइग्रेट करें, ताकि स्प्रेडशीट चुनने के लिए, Google पिकर के साथ drive.file स्कोप का इस्तेमाल किया जा सके.

जिन मामलों में स्प्रेडशीट की सूची बनाना ज़रूरी है उनमें mimeType क्वेरी का इस्तेमाल करके, Drive API Files.list तरीके से स्प्रेडशीट की सूची बनाई जा सकती है:

GET https://www.googleapis.com/drive/v3/files
             ?q=mimeType='application/vnd.google-apps.spreadsheet'

किसी उपयोगकर्ता की सभी स्प्रेडशीट की सूची बनाने के लिए, Drive API files.list तरीके का इस्तेमाल करने के लिए, सीमित दायरे की ज़रूरत होती है.

v3 API

वर्कशीट फ़ीड को इस एपीआई एंडपॉइंट से ऐक्सेस किया जा सकता है. इसके लिए, सही ऑथराइज़ेशन हेडर का इस्तेमाल करें:

GET https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

इस अनुरोध के जवाब का स्ट्रक्चर इस तरह का होता है. इसमें हर शीट का डेटा, अलग-अलग <entry> में होता है:

<feed xmlns="http://www.w3.org/2005/Atom"
    xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006"
    xmlns:gd="http://schemas.google.com/g/2005"
    gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
  <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <title type="text">Groceries R Us</title>
  <link rel="alternate" type="text/html"
      href="https://spreadsheets.google.com/ccc?key=spreadsheetId"/>
  <link rel="http://schemas.google.com/g/2005#feed"
      type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <author>
    <name>Fitzwilliam Darcy</name>
    <email>fitz@example.com</email>
  </author>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
  <entry gd:etag='"YDwqeyI."'>
    <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId</id>
    <updated>2006-11-17T18:23:45.173Z</updated>
    <title type="text">Sheet1</title>
    <content type="text">Sheet1</content>
    <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
    <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
    <link rel="self" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
    <link rel="edit" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
    <gs:rowCount>100</gs:rowCount>
    <gs:colCount>20</gs:colCount>
  </entry>
</feed>

v4 API

spreadsheets.get के तरीके का इस्तेमाल, शीट की प्रॉपर्टी और अन्य मेटाडेटा हासिल करने के लिए किया जा सकता है. यह Sheets API v3 के मुकाबले ज़्यादा जानकारी देता है. अगर आपको सिर्फ़ शीट प्रॉपर्टी पढ़नी हैं, तो स्प्रेडशीट सेल डेटा को शामिल होने से रोकने के लिए, includeGridData क्वेरी पैरामीटर को false पर सेट करें:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?includeGridData=false

Spreadsheet रिस्पॉन्स में, Sheet ऑब्जेक्ट का कलेक्शन होता है. इन ऑब्जेक्ट के SheetProperties एलिमेंट में, शीट के टाइटल और साइज़ की जानकारी देखी जा सकती है. उदाहरण के लिए:

{
  "spreadsheetId": spreadsheetId,
  "sheets": [
      {"properties": {
          "sheetId": sheetId,
          "title": "Sheet1",
          "index": 0,
          "gridProperties": {
              "rowCount": 100,
              "columnCount": 20,
              "frozenRowCount": 1,
              "frozenColumnCount": 0,
              "hideGridlines": false
          },
          ...
       },
       ...
      },
      ...
  ],
  ...
}

v3 API

Sheets API v3, स्प्रेडशीट में नई वर्कशीट जोड़ सकता है. इसके लिए, यह POST अनुरोध करता है. नई शीट का साइज़ तय किया जा सकता है:

POST https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <title>Expenses</title>
  <gs:rowCount>50</gs:rowCount>
  <gs:colCount>10</gs:colCount>
</entry>

v4 API

spreadsheets.batchUpdate के तरीके में, AddSheet का अनुरोध करके नई शीट जोड़ी जा सकती हैं. अनुरोध बॉडी के हिस्से के तौर पर, नई शीट के लिए शीट प्रॉपर्टी तय की जा सकती हैं. हालांकि, सभी प्रॉपर्टी देना ज़रूरी नहीं है. किसी मौजूदा शीट के लिए इस्तेमाल किया गया टाइटल देना गड़बड़ी है.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [{
      "addSheet": {
          "properties": {
            "title": "Expenses",
            "sheetType": "GRID",
            "gridProperties": {
              "rowCount": 50,
              "columnCount": 10
            }
          }
      }
  }],
}

v3 API

वर्कशीट का टाइटल या साइज़ बदलने के लिए, सबसे पहले वर्कशीट फ़ीड पाएं और अपनी पसंद की वर्कशीट एंट्री ढूंढें. इसमें edit यूआरएल होना चाहिए. वर्कशीट का मेटाडेटा अपडेट करें और उसे बदलाव करने के यूआरएल पर, PUT अनुरोध के मुख्य हिस्से के तौर पर भेजें. उदाहरण के लिए:

PUT https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

<entry>
  <id>
    https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId
  </id>
  <updated>2007-07-30T18:51:30.666Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#worksheet"/>
  <title type="text">Expenses</title>
  <content type="text">Expenses</content>
  <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
  <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
  <gs:rowCount>45</gs:rowCount>
  <gs:colCount>15</gs:colCount>
</entry>

v4 API

शीट का साइज़, टाइटल, और अन्य प्रॉपर्टी अपडेट करने के लिए, spreadsheets.batchUpdate के तरीके में updateSheetProperties का अनुरोध करें. POST अनुरोध बॉडी में, बदली जाने वाली प्रॉपर्टी शामिल होनी चाहिए. साथ ही, fields पैरामीटर में उन प्रॉपर्टी की साफ़ तौर पर सूची होनी चाहिए. अगर आपको सभी प्रॉपर्टी अपडेट करनी हैं, तो उन सभी को सूची में शामिल करने के लिए, fields:"*" का इस्तेमाल शॉर्टहैंड के तौर पर करें. उदाहरण के लिए, यहां बताया गया है कि दिए गए आईडी वाली शीट के लिए, शीट का टाइटल और साइज़ प्रॉपर्टी अपडेट की जानी चाहिए:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "updateSheetProperties": {
          "properties": {
            "sheetId": sheetId,
            "title": "Expenses",
            "gridProperties": {
              "rowCount": 45,
              "columnCount": 15,
            }
          },
          "fields": "title,gridProperties(rowCount,columnCount)"
     }
   }
  ],
}

किसी शीट का sheetId पाने के लिए, स्प्रेडशीट के spreadsheets.get तरीके का इस्तेमाल करें.

v3 API

वर्कशीट मिटाने के लिए, वर्कशीट फ़ीड को फिर से पाएं. इसके बाद, टारगेट की गई वर्कशीट एंट्री के edit यूआरएल पर DELETE अनुरोध भेजें.

DELETE https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

v4 API

किसी शीट को मिटाने के लिए, spreadsheets.batchUpdate तरीके में DeleteSheet अनुरोध करें. POST अनुरोध के मुख्य हिस्से में, सिर्फ़ उस शीट का sheetId होना चाहिए जिसे मिटाना है. उदाहरण के लिए:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": sheetId
      }
    }
  ],
}

किसी एक शीट का sheetId पाने के लिए, स्प्रेडशीट spreadsheets.get के तरीके का इस्तेमाल करें.

v3 API

किसी वर्कशीट के लिए, सूची पर आधारित फ़ीड का यूआरएल तय करने के लिए, वर्कशीट फ़ीड को फिर से पाएं और अपनी पसंद की वर्कशीट एंट्री में सूची फ़ीड का यूआरएल ढूंढें.

सूची पर आधारित फ़ीड को वापस पाने के लिए, अनुमति वाले सही हेडर का इस्तेमाल करके, सूची फ़ीड के यूआरएल पर GET अनुरोध भेजें. उदाहरण के लिए:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

इस अनुरोध के जवाब में, कुछ और चीज़ों के साथ-साथ, खास पंक्तियों से जुड़ी एंट्री भी शामिल होती हैं. अलग-अलग सेल का रेफ़रंस, शीट के हेडर में दिए गए नामों से मिलता है. उदाहरण के लिए, यहां एक पंक्ति वाली एंट्री दी गई है:

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
      term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>10</gsx:hours>
  <gsx:items>2</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

डिफ़ॉल्ट रूप से, सूची फ़ीड में दिखाई गई पंक्तियां, पंक्ति के क्रम में दिखती हैं. Sheets API v3, उस क्रम को बदलने के लिए क्वेरी पैरामीटर उपलब्ध कराता है.

उलटा क्रम:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full?reverse=true

किसी खास कॉलम के हिसाब से क्रम में लगाने के लिए:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?orderby=column:lastname

Sheets API v3 की मदद से, स्ट्रक्चर्ड क्वेरी (कॉलम हेडर के ज़रिए रेफ़रंस) का इस्तेमाल करके, चुनिंदा पंक्तियों को फ़िल्टर भी किया जा सकता है:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?sq=age>25%20and%20height<175

v4 API

Sheets API v4 की मदद से, रेंज के हिसाब से पंक्तियां हासिल की जा सकती हैं. इसके लिए, spreadsheets.values.get या spreadsheets.values.batchGet तरीकों का इस्तेमाल करें. उदाहरण के लिए, यह फ़ंक्शन "Sheet1" में सभी पंक्तियां दिखाता है:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1

इस अनुरोध के जवाब का स्ट्रक्चर इस तरह का होता है:

{
  "range": "Sheet1",
  "majorDimension": "ROWS",
  "values": [["Name", "Hours", "Items", "IPM"],
             ["Bingley", "10", "2", "0.0033"],
             ["Darcy", "14", "6", "0.0071"]]
}

पूरी पंक्तियों, कॉलम या शीट को वापस लाने पर, आखिर में मौजूद खाली सेल को जवाब में शामिल नहीं किया जाता.

Sheets API v4 में, Sheets API v3 के ज़रिए दिए गए पंक्ति के क्रम के क्वेरी पैरामीटर के बराबर पैरामीटर नहीं हैं. उलटे क्रम में लगाना आसान है; बस, दिखाए गए values कलेक्शन को उलटे क्रम में प्रोसेस करें. कॉलम के हिसाब से क्रम से लगाने की सुविधा, डेटा पढ़ने के लिए काम नहीं करती. हालांकि, SortRange का इस्तेमाल करके, शीट में डेटा को क्रम से लगाया जा सकता है और फिर उसे पढ़ा जा सकता है.

फ़िलहाल, Sheets API v4 में Sheets API v3 की स्ट्रक्चर्ड क्वेरी के बराबर कोई क्वेरी नहीं है. हालांकि, अपने ऐप्लिकेशन में ज़रूरी डेटा को ढूंढा जा सकता है और ज़रूरत के हिसाब से उसे क्रम में लगाया जा सकता है.

v3 API

किसी वर्कशीट के लिए, सूची पर आधारित फ़ीड का यूआरएल तय करने के लिए, वर्कशीट फ़ीड को फिर से पाएं और अपनी पसंद की वर्कशीट एंट्री में पोस्ट का यूआरएल ढूंढें.

डेटा की लाइन जोड़ने के लिए, पोस्ट यूआरएल पर POST अनुरोध भेजें. इसके लिए, अनुमति देने वाले सही हेडर का इस्तेमाल करें. उदाहरण के लिए:

POST https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

POST अनुरोध के मुख्य हिस्से में, जोड़ी जाने वाली लाइन के डेटा के लिए एक एंट्री होनी चाहिए. इसमें कॉलम हेडर से रेफ़र की गई अलग-अलग सेल होनी चाहिए:

<entry xmlns="http://www.w3.org/2005/Atom"
       xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
  <gsx:hours>2</gsx:hours>
  <gsx:ipm>0.5</gsx:ipm>
  <gsx:items>60</gsx:items>
  <gsx:name>Elizabeth</gsx:name>
</entry>

नई पंक्तियां, चुनी गई शीट के आखिर में जोड़ दी जाती हैं.

v4 API

Sheets API v4 की मदद से, spreadsheets.values.append तरीके का इस्तेमाल करके पंक्तियां जोड़ी जा सकती हैं. नीचे दिए गए उदाहरण में, स्प्रेडशीट की "शीट1" में मौजूद आखिरी टेबल के नीचे, डेटा की नई लाइन लिखी गई है.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/append/Sheet1

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

इसके अलावा, Sheets API v4 की मदद से, spreadsheets.batchUpdate में AppendCells रिक्वेस्ट का इस्तेमाल करके, खास प्रॉपर्टी और फ़ॉर्मैटिंग वाली सेल जोड़ी जा सकती हैं.

v3 API

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

एंट्री अपडेट होने के बाद, उस पंक्ति की एंट्री को अनुरोध के मुख्य हिस्से के तौर पर इस्तेमाल करके, PUT अनुरोध भेजें. इसके लिए, अनुमति देने वाले सही हेडर का इस्तेमाल करें. यह अनुरोध, उस पंक्ति की एंट्री में दिए गए edit यूआरएल पर भेजें. उदाहरण के लिए:

PUT https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>20</gsx:hours>
  <gsx:items>4</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

v4 API

Sheets API v4 की मदद से, किसी पंक्ति में बदलाव किया जा सकता है. इसके लिए, उस पंक्ति के A1 नोटेशन का इस्तेमाल करें जिसमें बदलाव करना है. साथ ही, उस पंक्ति को बदलने के लिए, spreadsheets.values.update अनुरोध करें. तय की गई रेंज में सिर्फ़ पंक्ति की पहली सेल का रेफ़रंस होना चाहिए. एपीआई, अनुरोध के साथ दी गई वैल्यू के आधार पर, अपडेट करने के लिए सेल का पता लगाता है. अगर आपने एक से ज़्यादा सेल की रेंज दी है, तो आपने जो वैल्यू दी है वे उस रेंज में होनी चाहिए. ऐसा न होने पर, एपीआई गड़बड़ी का मैसेज दिखाता है.

अनुरोध और अनुरोध के मुख्य हिस्से के इस उदाहरण में, "शीट1" की चौथी पंक्ति में डेटा जोड़ा गया है:

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1!A4

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

spreadsheet.values.batchUpdate के तरीके से भी पंक्ति का डेटा अपडेट किया जा सकता है. अगर आपको एक से ज़्यादा पंक्तियों या सेल में अपडेट करने हैं, तो इस तरीके का इस्तेमाल करना ज़्यादा बेहतर होगा.

इसके अलावा, Sheets API v4 की मदद से, spreadsheets.batchUpdate में UpdateCells या RepeatCell रिक्वेस्ट का इस्तेमाल करके, सेल की प्रॉपर्टी और फ़ॉर्मैटिंग में भी बदलाव किया जा सकता है.

v3 API

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

DELETE https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

अगर आपको यह पक्का करना है कि आपने ऐसी कोई पंक्ति मिटाई हो जिसे वापस पाने के बाद, किसी दूसरे क्लाइंट ने बदल दिया हो, तो एचटीटीपी If-Match हेडर शामिल करें. इसमें मूल पंक्ति की ETag वैल्यू शामिल होती है. एंट्री एलिमेंट के gd:etag एट्रिब्यूट की जांच करके, ओरिजनल पंक्ति की ETag वैल्यू का पता लगाया जा सकता है.

अगर आपको लाइन मिटानी है, भले ही आपने उसे वापस पाने के बाद किसी और ने अपडेट किया हो, तो If-Match: * का इस्तेमाल करें और ETag शामिल न करें. (इस मामले में, आपको लाइन को मिटाने से पहले उसे वापस लाने की ज़रूरत नहीं है.)

v4 API

Sheets API v4 की मदद से पंक्तियां मिटाने के लिए, DeleteDimension अनुरोध का इस्तेमाल करके, spreadsheet.batchUpdate तरीके का कॉल किया जाता है. इस अनुरोध का इस्तेमाल कॉलम हटाने के लिए भी किया जा सकता है. साथ ही, डेवलपर सिर्फ़ पंक्ति या कॉलम का कुछ हिस्सा हटा सकते हैं. उदाहरण के लिए, यह फ़ंक्शन दिए गए आईडी वाली शीट की छठी पंक्ति को हटा देता है. पंक्ति के इंडेक्स शून्य से शुरू होते हैं. इसमें startIndex शामिल होता है और endIndex शामिल नहीं होता:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": sheetId,
          "dimension": "ROWS",
          "startIndex": 5,
          "endIndex": 6
        }
      }
    }
  ],
}

spreadsheet.get तरीके का इस्तेमाल करके, किसी शीट का sheetId वापस पाया जा सकता है.

v3 API

किसी वर्कशीट के लिए, सेल पर आधारित फ़ीड का यूआरएल तय करने के लिए, वर्कशीट फ़ीड की जांच करें और अपनी पसंद की वर्कशीट एंट्री में सेल फ़ीड का यूआरएल ढूंढें.

सेल पर आधारित फ़ीड को वापस पाने के लिए, सेल फ़ीड के यूआरएल पर GET अनुरोध भेजें. इसके लिए, सही ऑथराइज़ेशन हेडर का इस्तेमाल करें. उदाहरण के लिए:

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full

सेल का रेफ़रंस, पंक्ति और कॉलम नंबर का इस्तेमाल करके दिया जाता है. किसी खास रेंज को फ़ेच करने के लिए, max-row, min-row, max-col, और min-col क्वेरी पैरामीटर का इस्तेमाल किया जा सकता है. उदाहरण के लिए, यह फ़ॉर्मूला कॉलम 4 (D) की सभी सेल को पंक्ति 2 से शुरू करके दिखाता है:

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full
             ?min-row=2&min-col=4&max-col=4

Sheets API v3, वापस लाई गई सेल का inputValue दिखाता है. यह वह वैल्यू होती है जिसे उपयोगकर्ता, सेल में बदलाव करने के लिए Google Sheets के यूज़र इंटरफ़ेस में टाइप करता है. inputValue, कोई लिटरल वैल्यू या फ़ॉर्मूला हो सकता है. एपीआई कभी-कभी numericValue भी दिखाता है. उदाहरण के लिए, जब किसी फ़ॉर्मूला से संख्या मिलती है. उदाहरण के लिए, जवाब में सेल की ऐसी एंट्री शामिल हो सकती हैं जिनका स्ट्रक्चर नीचे दिए गए स्ट्रक्चर से मिलता-जुलता हो:

<entry gd:etag='"ImB5CBYSRCp7"'>
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4</id>
  <updated>2006-11-17T18:27:32.543Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#cell"/>
  <title type="text">D4</title>
  <content type="text">5</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4/srevc"/>
  <gs:cell row="4" col="4" inputValue="=FLOOR(C4/(B4*60),.0001)"
    numericValue="5.0">5</gs:cell>
</entry>

v4 API

अपनी पसंद की रेंज के लिए, spreadsheets.values.get या spreadsheets.values.batchGet का इस्तेमाल करके सेल का डेटा पाएं. उदाहरण के लिए, यह फ़ंक्शन "Sheet2" के कॉलम D में मौजूद सेल दिखाता है. यह सेल, पंक्ति 2 से शुरू होकर कॉलम के हिसाब से क्रम में होती हैं. साथ ही, इसमें डाले गए फ़ॉर्मूले भी उसी क्रम में दिखते हैं. हालांकि, आखिर में मौजूद खाली सेल नहीं दिखती हैं:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet2!D2:D?majorDimension=COLUMNS&valueRenderOption=FORMULA

इस अनुरोध का जवाब, इस तरह के स्ट्रक्चर में होता है:

{
  "spreadsheetId": spreadsheetId,
  "valueRanges": [
      {"range": "Sheet2!D2:D",
       "majorDimension": "COLUMNS",
       "values": [["Widget", 234, "=FLOOR(C4/(B4*60),.0001)", "=D4\*1000"]]
      }]
}

अगर आपको सेल डेटा की कई रेंज वापस लानी हैं, तो spreadsheet.values.batchGet का इस्तेमाल करना ज़्यादा बेहतर होता है. अगर आपको फ़ॉर्मैटिंग जैसी सेल प्रॉपर्टी ऐक्सेस करनी हैं, तो spreadsheet.get का इस्तेमाल करना ज़रूरी है.

v3 API

किसी एक सेल के कॉन्टेंट में बदलाव करने के लिए, सबसे पहले सेल फ़ीड में सेल की एंट्री ढूंढें. एंट्री में बदलाव करने का यूआरएल मौजूद है. सेल में अपनी पसंद का कॉन्टेंट दिखाने के लिए, एंट्री को अपडेट करें. इसके बाद, बदली गई सेल एंट्री को अनुरोध के मुख्य हिस्से के तौर पर इस्तेमाल करके, बदलाव करने के लिए यूआरएल पर PUT अनुरोध करें. उदाहरण के लिए, यहां दिए गए अपडेट से सेल D2 (R2C4) में SUM फ़ॉर्मूला शामिल हो जाता है:

PUT https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full//R2C4/srevc

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4"/>
  <gs:cell row="2" col="4" inputValue="=SUM(A1:B6)"/>
</entry>

v4 API

Sheets API v4 में किसी एक सेल में बदलाव करने के लिए, spreadsheets.values.update का इस्तेमाल किया जा सकता है. इस तरीके के लिए, ValueInputOption क्वेरी पैरामीटर की ज़रूरत होती है. इससे यह तय होता है कि इनपुट डेटा को Sheets के यूज़र इंटरफ़ेस (यूआई) (USER_ENTERED) में डाले गए डेटा के तौर पर माना जाए या उसे बिना पार्स किए, जैसा है वैसा ही इस्तेमाल किया जाए (RAW). उदाहरण के लिए, यह फ़ॉर्मूला सेल D2 को अपडेट करता है:

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/D2?valueInputOption=USER_ENTERED

{"values": [["=SUM(A1:B6)"]]}

अगर एक से ज़्यादा सेल में बदलाव किए जा रहे हैं, तो एक अनुरोध में उन्हें लागू करने के लिए, spreadsheets.values.batchUpdate तरीके का इस्तेमाल करें.

v3 API

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

POST https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/batch

<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:batch="http://schemas.google.com/gdata/batch"
      xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full</id>
  <entry>
    <batch:id>request1</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4/version"/>
    <gs:cell row="2" col="4" inputValue="newData"/>
  </entry>
  ...
  <entry>
    <batch:id>request2</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5/version"/>
    <gs:cell row="5" col="2" inputValue="moreInfo"/>
  </entry>
</feed>

batch:id फ़ील्ड में, बैच में मौजूद अनुरोध की खास तौर पर पहचान होनी चाहिए. सेल में बदलाव करने के लिए, batch:operation फ़ील्ड का नाम update होना चाहिए. gs:cell, पंक्ति और कॉलम की संख्या के हिसाब से सेल की पहचान करता है और उसमें डालने के लिए नया डेटा उपलब्ध कराता है. id में, अपडेट की जाने वाली सेल का पूरा यूआरएल होता है. link में href एट्रिब्यूट होना चाहिए, जिसमें सेल के आईडी का पूरा पाथ शामिल हो. हर एंट्री के लिए, इन सभी फ़ील्ड में जानकारी डालना ज़रूरी है.

v4 API

Sheets API v4, spreadsheets.values.batchUpdate के ज़रिए, सेल की वैल्यू में एक साथ बदलाव करने की सुविधा देता है.

एक से ज़्यादा सेल में बदलाव करने के लिए, अनुरोध के मुख्य हिस्से में डेटा में किए गए बदलावों के साथ POST अनुरोध करें. उदाहरण के लिए:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values:batchUpdate

{
  "valueInputOption": "USER_ENTERED"
  "data": [
       {"range": "D4",
        "majorDimension": "ROWS",
        "values": [["newData"]]
       },
       {"range": "B5",
        "majorDimension": "ROWS",
        "values": [["moreInfo"]]
       }
  ]
}

अगर आपने रेंज के तौर पर एक सेल तय की है, तो दी गई सभी वैल्यू, शीट में उस सेल से शुरू होकर ऊपर बाईं ओर के कोऑर्डिनेट के तौर पर लिखी जाती हैं. अगर आपने एक से ज़्यादा सेल वाली रेंज दी है, तो दी गई वैल्यू उस रेंज में पूरी तरह से फ़िट होनी चाहिए. ऐसा न होने पर, एपीआई गड़बड़ी का मैसेज दिखाता है.