प्रोटोकॉल से जुड़ी बुनियादी बातें

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

यह दस्तावेज़ कई Google API में इस्तेमाल किए जाने वाले Google डेटा प्रोटोकॉल की बुनियादी बातों के बारे में बताता है. साथ ही, इसमें क्वेरी के दिखने के तरीके, नतीजे जैसे दिखते हैं वगैरह के उदाहरण शामिल हैं.

Google डेटा प्रोटोकॉल के बारे में ज़्यादा जानकारी के लिए, डेवलपर की गाइड की खास जानकारी देने वाला पेज और प्रोटोकॉल रेफ़रंस देखें.

दर्शक

यह दस्तावेज़ उन सभी लोगों के लिए है जिन्हें Google डेटा एपीआई में इस्तेमाल किए जाने वाले एक्सएमएल फ़ॉर्मैट और प्रोटोकॉल के बारे में सामान्य जानकारी चाहिए.

भले ही आप केवल भाषा-विशिष्ट क्लाइंट लाइब्रेरी का उपयोग करने वाला कोड लिखना चाहें, लेकिन हो सकता है कि क्लाइंट-लाइब्रेरी ऐब्स्ट्रैक्शन लेयर के नीचे क्या हो रहा है, यह समझने के लिए आप यह दस्तावेज़ पढ़ना चाहें.

इस दस्तावेज़ में यह माना गया है कि आप एक्सएमएल, नेमस्पेस, सिंडिकेट किए गए फ़ीड, और एचटीटीपी में मौजूद GET, POST, PUT, और DELETE अनुरोधों के साथ-साथ एचटीटीपी के "रिसॉर्स" का सिद्धांत समझते हैं. उन चीज़ों के बारे में ज़्यादा जानकारी के लिए, इस दस्तावेज़ का अतिरिक्त संसाधन सेक्शन देखें.

यह दस्तावेज़ किसी खास प्रोग्रामिंग भाषा पर निर्भर नहीं है; आपका क्लाइंट ऐसी किसी भी प्रोग्रामिंग भाषा का इस्तेमाल करके सर्वर से इंटरैक्ट कर सकता है जो आपको एचटीटीपी अनुरोध जारी करने और एक्सएमएल-आधारित जवाबों को पार्स करने देती हो.

अगर आप किसी कोड को लिखे बिना इस दस्तावेज़ के उदाहरणों को आज़माना चाहते हैं, तो आप कमांड-लाइन यूटिलिटी cURL या Wget उपयोगी ढूंढ सकते हैं; ज़्यादा जानकारी के लिए, उन यूटिलिटी के लिए मैन्युअल पेज देखें या cURL का इस्तेमाल करने से जुड़े दस्तावेज़ देखें, जो Google डेटा प्रोटोकॉल का इस्तेमाल करने वाली सेवाओं से इंटरैक्ट करते हैं.

उदाहरण

नीचे दिए गए उदाहरण उन एचटीटीपी अनुरोधों को दिखाते हैं जिन्हें आप सीधे Google Data प्रोटोकॉल एपीआई प्रोटोकॉल का इस्तेमाल करके, किसी सामान्य सेवा को भेज सकते हैं. साथ ही, वे आपको मिलने वाले नतीजे भी दिखाते हैं. अलग-अलग प्रोग्रामिंग भाषाओं का इस्तेमाल करके अनुरोध भेजने के तरीके के उदाहरणों के लिए, भाषा के हिसाब से नमूने और क्लाइंट लाइब्रेरी देखें. खास Google सेवाओं के साथ Google डेटा प्रोटोकॉल का इस्तेमाल करने के बारे में जानकारी पाने के लिए, सेवा से जुड़े खास दस्तावेज़ देखें.

फ़ीड या दूसरे रिसॉर्स का अनुरोध करना

मान लें कि /myFeed नाम का कोई फ़ीड है और मान लें कि फ़िलहाल इसमें कोई एंट्री नहीं है. इसे देखने के लिए, सर्वर को यह एचटीटीपी अनुरोध भेजें:

GET /myFeed

सर्वर जवाब देता है:

200 OK

<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"C0QBRXcycSp7ImA9WxRVFUk."'>
  <title>Foo</title>
  <updated>2006-01-23T16:25:00-08:00</updated>
  <id>http://www.example.com/myFeed</id>
  <author>
    <name>Jo March</name>
  </author>
  <link href='/myFeed' rel='self'/>
</feed>

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

नई एंट्री शामिल की जा रही है

नई एंट्री बनाने के लिए, एक POST अनुरोध भेजें और नई एंट्री का एक्सएमएल प्रज़ेंटेशन दें:

POST /myFeed

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'>
  <author>
    <name>Elizabeth Bennet</name>
    <email>liz@gmail.com</email>
  </author>
  <title type='text'>Entry 1</title>
  <content type='text'>This is my entry</content>
</entry>

ध्यान दें कि आप मानक एटम <id>, <link> या <updated> एलिमेंट नहीं देते हैं; तो सर्वर आपके POST अनुरोध के जवाब में उन्हें बनाता है. साथ ही, यह भी ध्यान रखें कि किसी फ़ीड का लेखक और लेखक का नाम एक ही हो.

सर्वर जवाब देता है:

201 CREATED

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='"CUUEQX47eCp7ImA9WxRVEkQ."'>
  <id>http://www.example.com/id/1</id>
  <link rel='edit' href='http://example.com/myFeed/1/1/'/>
  <updated>2006-01-23T16:26:03-08:00</updated>
  <author>
    <name>Elizabeth Bennet</name>
    <email>liz@gmail.com</email>
  </author>
  <title type='text'>Entry 1</title>
  <content type='text'>This is my entry</content>
</entry>

स्ट्रिंग खोजना

किसी खास स्ट्रिंग के लिए, फ़ुल-टेक्स्ट खोज करने के लिए, q पैरामीटर के साथ GET अनुरोध भेजें. यह तब काम करता है, जब पूरे टेक्स्ट के साथ खोज करने वाली सेवा काम करती हो. क्वेरी पैरामीटर के बारे में ज़्यादा जानकारी के लिए, प्रोटोकॉल रेफ़रंस दस्तावेज़ में जाकर क्वेरी के अनुरोध देखें.

GET /myFeed?q=This

सर्वर एक ऐसी फ़ीड के साथ जवाब देता है, जिसमें खोज स्ट्रिंग This से मेल खाने वाली सभी प्रविष्टियां मौजूद होती हैं. (इस मामले में सिर्फ़ एक है.)

200 OK

<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"S0wCTlpIIip7ImA0X0QI"'>
  <title>Foo</title>
  <updated>2006-01-23T16:26:03-08:00</updated>
  <id>http://www.example.com/myFeed</id>
  <author>
    <name>Jo March</name>
  </author>
  <link href='/myFeed' rel='self'/>
  <entry gd:etag='"CUUEQX47eCp7ImA9WxRVEkQ."'>
    <id>http://www.example.com/id/1</id>
    <link rel='edit' href='http://example.com/myFeed/1/'/>
    <updated>2006-01-23T16:26:03-08:00</updated>
    <author>
      <name>Elizabeth Bennet</name>
      <email>liz@gmail.com</email>
    </author>
    <title type='text'>Entry 1</title>
    <content type='text'>This is my entry</content>
  </entry>
</feed>

एंट्री अपडेट करना

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

  1. वह एंट्री वापस पाएं जिसे अपडेट करना है.
  2. ज़रूरत के हिसाब से बदलाव करें.
  3. मैसेज के मुख्य हिस्से में अपडेट की गई एंट्री के साथ, एंट्री के बदलाव यूआरआई में PUT अनुरोध भेजें. पिछले यूआरआई में, बदलाव करने वाला यूआरआई <link rel='edit'> एलिमेंट का href एट्रिब्यूट के तौर पर दिखता है.

आपको मूल एंट्री का ETag भी तय करना होगा, ताकि यह पक्का किया जा सके कि आप किसी और के बदलावों को ओवरराइट न करें.

नीचे दिए गए उदाहरण में, हम एंट्री के टेक्स्ट को उसकी पुरानी वैल्यू ("यह मेरी एंट्री है") से नई वैल्यू (यह मेरी पहली एंट्री है) से बदल रहे हैं:

PUT /myFeed/1/1/

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='"CUUEQX47eCp7ImA9WxRVEkQ."'>
  <id>http://www.example.com/id/1</id>
  <link rel='edit' href='http://example.com/myFeed/1/'/>
  <updated>2006-01-23T16:28:05-08:00</updated>
  <author>
    <name>Elizabeth Bennet</name>
    <email>liz@gmail.com</email>
  </author>
  <title type='text'>Entry 1</title>
  <content type='text'>This is my first entry.</content>
</entry>

सर्वर जवाब देता है:

200 OK

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='"FkkOQgZGeip7ImA6WhVR"'>
  <id>http://www.example.com/id/1</id>
  <link rel='edit' href='http://example.com/myFeed/1/'/>
  <updated>2006-01-23T16:28:05-08:00</updated>
  <author>
    <name>Elizabeth Bennet</name>
    <email>liz@gmail.com</email>
  </author>
  <title type='text'>Entry 1</title>
  <content type='text'>This is my first entry.</content>
</entry>

ध्यान दें कि ETag बदल गया है. संसाधनों के वर्शन के बारे में ज़्यादा जानकारी के लिए, प्रोटोकॉल रेफ़रंस दस्तावेज़ का संसाधन वर्शन (Eटैग) सेक्शन देखें.

संदर्भ में नई एंट्री देखने के लिए, पूरे रिसॉर्स का फिर से अनुरोध करें:

GET /myFeed

सर्वर जवाब देता है:

200 OK

<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"D08FQn8-eil7ImA9WxZbFEw."'>
  <title>Foo</title>
  <updated>2006-01-23T16:28:05-08:00</updated>
  <id>http://www.example.com/myFeed</id>
  <author>
    <name>Jo March</name>
  </author>
  <link href='/myFeed' rel='self'/>
  <entry gd:etag='"FkkOQgZGeip7ImA6WhVR"'>
    <id>http://www.example.com/id/1</id>
    <link rel='edit' href='http://example.com/myFeed/1/'/>
    <updated>2006-01-23T16:28:05-08:00</updated>
    <author>
      <name>Elizabeth Bennet</name>
      <email>liz@gmail.com</email>
    </author>
    <title type='text'>Entry 1</title>
    <content type='text'>This is my first entry.</content>
  </entry>
</feed>

ध्यान दें: अगर आपका फ़ायरवॉल PUT को अनुमति नहीं देता है, तो एचटीटीपी POST करें और तरीका ओवरराइड करने के लिए यहां दिया गया तरीका अपनाएं:

X-HTTP-Method-Override: PUT

कोई प्रविष्टि हटाना

किसी मौजूदा एंट्री को मिटाने के लिए, उस एंट्री में बदलाव करने वाले यूआरआई (जैसा कि पिछले उदाहरण में सर्वर से मिला है) का इस्तेमाल करके DELETE का अनुरोध भेजें.

अगर आपका फ़ायरवॉल DELETE की अनुमति नहीं देता है, तो एचटीटीपी POST करें और तरीके को बदलें हेडर को इस तरह सेट करें:

X-HTTP-Method-Override: DELETE

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

If-Match: *

नीचे दिए गए उदाहरण में कोई एंट्री मिटा दी जाती है (अगर हेडर सही तरीके से सेट किए गए हैं):

DELETE /myFeed/1/

सर्वर जवाब देता है:

200 OK

फ़ीड में अब कोई एंट्री नहीं है, यह देखने के लिए GET फिर से करें:

GET /myFeed

सर्वर उस फ़ीड के साथ जवाब देता है जिसमें मेटाडेटा के अलावा कुछ और नहीं होता है:

200 OK

<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
  <title>Foo</title>
  <updated>2006-01-23T16:30:11-08:00</updated>
  <id>http://www.example.com/myFeed</id>
  <author>
    <name>Jo March</name>
  </author>
  <link href='/myFeed' rel='self'/>
</feed>

अगर इसे मिटाया नहीं जाता है, तो सर्वर गड़बड़ी कोड के साथ जवाब देता है. ज़्यादा जानकारी के लिए, प्रोटोकॉल रेफ़रंस दस्तावेज़ में एचटीटीपी स्टेटस कोड देखें.

आंशिक फ़ीड या एंट्री का अनुरोध करना (प्रयोग के तौर पर)

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

पार्शियल रिस्पॉन्स का अनुरोध करने के लिए, fields क्वेरी पैरामीटर का इस्तेमाल करें, ताकि यह बताया जा सके कि आपको किन एलिमेंट या एट्रिब्यूट को लौटाना है. ज़्यादा जानकारी के लिए, प्रोटोकॉल रेफ़रंस दस्तावेज़ में पार्शियल रिस्पॉन्स देखें.

नीचे दिए गए उदाहरण में, सिर्फ़ फ़ीड आईडी से जुड़ी जानकारी मांगी गई है. साथ ही, हर फ़ीड एंट्री के लेखक और शीर्षक के बारे में भी बताया गया है.

GET /myFeed?fields=id,entry(author)

सर्वर जवाब देता है:

200 OK

<?xml version='1.0' encoding='utf-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
  xmlns:gd='http://schemas.google.com/g/2005'>
  <id>http://www.example.com/myFeed</id>
  <entry>
    <author>
      <name>Elizabeth Bennet</name>
      <email>liz@gmail.com</email>
    </author>
    <title type='text'>Entry 1</title>
  </entry>
  <entry>
    <author>
      <name>Elizabeth Bennet</name>
      <email>liz@gmail.com</email>
    </author>
    <title type='text'>Entry 2</title>
  </entry>
</feed>

fields पैरामीटर का इस्तेमाल, ऐसे किसी भी अनुरोध के साथ किया जा सकता है जिससे डेटा मिलता है. GET के अलावा, इसमें POST और PUT के साथ-साथ PATCH भी शामिल है. इसका इस्तेमाल आंशिक अपडेट के अनुरोध करने के लिए किया जाता है.

ध्यान दें: fields क्वेरी पैरामीटर सिर्फ़ अनुरोध के जवाब में भेजे गए डेटा को कंट्रोल करता है. इससे उस डेटा पर कोई असर नहीं पड़ता जो आपको PUT, POST या PATCH अनुरोध के मुख्य हिस्से में उपलब्ध कराना है.

POST और PUT के उदाहरण नीचे दिखाए गए हैं.

  • आंशिक जवाब के लिए POST अनुरोध करते समय भी आपको वही डेटा देना होगा जो नई एंट्री शामिल करना में बताया गया है. यहां दिए गए उदाहरण में, कुछ हद तक जवाब दिया गया है. इसमें सिर्फ़ बनाई गई, नई एंट्री का शीर्षक शामिल है: 
    POST /myFeed?fields=title
      
...data...

    सर्वर जवाब देता है:

    200 OK

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'>
  <title type='text'>Entry 1</title>
</entry>
  • आंशिक जवाब के लिए PUT का अनुरोध करने पर भी, आपको पूरे संसाधन को दिखाने का बदला हुआ वर्शन देना होगा, जैसा कि एंट्री अपडेट करना में बताया गया है. नीचे दिए गए उदाहरण में आंशिक जवाब का अनुरोध किया गया है, जिसमें बदलाव की गई एंट्री का सिर्फ़ नया ETag मान शामिल है: 
    PUT /myFeed/1/1?fields=@gd:etag
  
...data...

    सर्वर जवाब देता है:

    200 OK

<?xml version='1.0' encoding='utf-8'?>
<entry xmlns='http://www.w3.org/2005/Atom'
  gd:etag='"FkkOQgZGeip7ImA6WhVR"'/>

खास फ़ील्ड (प्रयोग के तौर पर) अपडेट किए जा रहे हैं

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

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

ध्यान दें: PUT की तरह ही, आपको ओरिजनल एंट्री का ETag भी तय करना होगा, ताकि यह पक्का किया जा सके कि आप किसी और के बदलावों से ज़्यादा न निकल जाएं.

PATCH और उसके सिमेंटिक के बारे में ज़्यादा जानने के लिए, प्रोटोकॉल रेफ़रंस दस्तावेज़ में पूरा अपडेट देखें.

यह उदाहरण, कुछ हद तक अपडेट करने का अनुरोध दिखाता है. इससे एंट्री के शीर्षक में बदलाव होता है:

PATCH /myFeed/1/1/

<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag="EksPTg1Bfyp7IWA6WhJT"
    gd:fields='title'>
  <title>New Title</title>
</entry>

जब सर्वर को PATCH अनुरोध मिलता है, तो वह पहले एंट्री के gd:fields एट्रिब्यूट (अगर मौजूद हो) के हिसाब से फ़ील्ड को हटाता है. इसके बाद, वह अनुरोध के मुख्य हिस्से में दिए गए डेटा को टारगेट रिसॉर्स के साथ मर्ज कर देता है. इस उदाहरण में, शीर्षक एलिमेंट को पहले टारगेट रिसॉर्स से हटा दिया जाता है. इसके बाद, नई शीर्षक वैल्यू को मर्ज किया जाता है. प्रभावी रूप से, यह अनुरोध पुराने शीर्षक को नए शीर्षक से बदल देता है.

हालांकि, ध्यान रखें कि PATCH के सिमैंटिक एलिमेंट का कुछ हिस्सा, मौजूदा संसाधन में मर्ज होता है. आपको किसी फ़ील्ड की वैल्यू अपडेट करने के लिए, हमेशा उसे हटाने की ज़रूरत नहीं होती.

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

दोहराए जाने वाले और दोहराए जाने वाले फ़ील्ड को मर्ज करने के तरीके के बीच का अंतर, अगले उदाहरण में दिखता है. इससे, दोनों एट्रिब्यूट को हटाने के लिए, पहले gd:fields एट्रिब्यूट का इस्तेमाल किए बिना, एंट्री में एक नया शीर्षक और लेखक जोड़ दिए जाते हैं.

PATCH /myFeed/1/1/

<entry xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:edtag="EksPTg1Bfyp7IWA6WhJT">
  <title>A new title</title>
  <author>
    <name>Fitzwilliam Darcy</name>
    <email>darcy@gmail.com</email>
  </author>
</entry>

आंशिक एंट्री के लिए gd:fields एट्रिब्यूट मौजूद नहीं है. इसलिए, कोई भी फ़ील्ड नहीं हटाया जाता. हालांकि, <title> और <author> एलिमेंट की नई वैल्यू, टारगेट रिसॉर्स के साथ मर्ज कर दी जाती हैं:

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

    ध्यान दें: सभी एपीआई, ऐटम स्टैंडर्ड के मुताबिक नहीं होते हैं. उदाहरण के लिए, कुछ एपीआई हर एंट्री में सिर्फ़ एक <author> एलिमेंट इस्तेमाल करने की अनुमति देते हैं. वहीं, कुछ अन्य एपीआई, फ़ीड लेवल से एंट्री लेखक को इनहेरिट करते हैं. इस वजह से, फ़ील्ड सिर्फ़ पढ़ने के लिए उपलब्ध होता है.

जब सर्वर मान्य PATCH अनुरोध को प्रोसेस कर लेता है, तब वह अपडेट की गई एंट्री को पूरी तरह से दिखाने के साथ, एक एचटीटीपी 200 स्टेटस कोड दिखाता है.

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

अतिरिक्त रिसॉर्स

आपको तीसरे पक्ष के ये दस्तावेज़ उपयोगी लग सकते हैं:

वापस सबसे ऊपर जाएं