Google Sites के क्लासिक वर्शन के लिए उपलब्ध API की मदद से, आपके ऐप्लिकेशन किसी Google साइट के कॉन्टेंट को ऐक्सेस, पब्लिश, और उसमें बदलाव कर सकते हैं. इसके अतिरिक्त, आपका ऐप्लिकेशन हाल की गतिविधि की सूची का अनुरोध कर सकता है, संशोधन इतिहास ला सकता है और अटैचमेंट और फ़ाइलें अपलोड/डाउनलोड कर सकता है.
ऑडियंस
इस दस्तावेज़ में यह माना गया है कि आपको Google Data API प्रोटोकॉल के बारे में सामान्य जानकारी है.
यह दस्तावेज़ उन प्रोग्रामर के लिए है जो Google Sites के साथ इंटरैक्ट करने वाले क्लाइंट ऐप्लिकेशन लिखना चाहते हैं. इसमें, रॉ एक्सएमएल/एचटीटीपी का इस्तेमाल करके, डेटा एपीआई के बुनियादी इंटरैक्शन के उदाहरणों की एक सीरीज़ दी गई है. साथ ही, इन उदाहरणों के बारे में जानकारी भी दी गई है. इस दस्तावेज़ को पढ़ने के बाद, क्लाइंट लाइब्रेरी का इस्तेमाल करके एपीआई के साथ इंटरैक्ट करने के बारे में ज़्यादा जानें. इसके लिए, बाईं ओर मौजूद नेविगेशन बार में मौजूद अन्य गाइड में, भाषा के हिसाब से दिए गए उदाहरण पढ़ें.
इस गाइड में मौजूद कॉन्टेंट के रेफ़रंस के लिए, रेफ़रंस गाइड देखें.
अनुमति के अनुरोध
जब आपका ऐप्लिकेशन उपयोगकर्ता के निजी डेटा को ऐक्सेस करने का अनुरोध करता है, तो उसमें अनुमति वाला टोकन होना ज़रूरी है. इस टोकन से Google आपके ऐप्लिकेशन की पहचान भी करता है.
अनुमति देने के प्रोटोकॉल के बारे में जानकारी
अनुरोधों को अनुमति देने के लिए, आपके ऐप्लिकेशन में OAuth 2.0 का इस्तेमाल किया जाना चाहिए. अनुमति देने वाले दूसरे प्रोटोकॉल इस्तेमाल नहीं किए जा सकते. अगर आपका ऐप्लिकेशन Google से साइन इन करने की सुविधा इस्तेमाल करता है, तो अनुमति देने से जुड़े कुछ पहलुओं को Google आपके लिए खुद मैनेज करता है.
OAuth 2.0 से अनुरोधों को अनुमति देना
Google Sites Data API को उपयोगकर्ता के निजी डेटा के लिए किए गए अनुरोधों के लिए, अनुमति किसी ऐसे उपयोगकर्ता को देनी चाहिए जिसके पास ऐसा करने का अधिकार हो.
OAuth 2.0 के लिए अनुमति देने की प्रक्रिया या "तरीका" अलग-अलग हो सकता है. यह इस बात पर निर्भर करता है कि ऐप्लिकेशन किस तरह का है. सभी तरह के ऐप्लिकेशन के लिए नीचे दी गई सामान्य प्रक्रिया लागू होती है:
- ऐप्लिकेशन बनाने के बाद, उसे Google API (एपीआई) कंसोल का इस्तेमाल करके, रजिस्टर किया जाता है. इसके बाद, Google आपको क्लाइंट आईडी और क्लाइंट सीक्रेट जैसी जानकारी देगा.
- Google API कंसोल में, Google Sites Data API को चालू करें. (अगर एपीआई को 'API कंसोल' की सूची में नहीं जोड़ा गया है, तो यह चरण छोड़ दें.)
- जब आपके ऐप्लिकेशन को उपयोगकर्ता के डेटा को ऐक्सेस करने की ज़रूरत होती है, तब वह Google से, डेटा के खास लिंक का अनुरोध करता है.
- Google, उपयोगकर्ता को सहमति वाली स्क्रीन दिखाता है, जिसमें उनसे आपके ऐप्लिकेशन को उनके कुछ डेटा को ऐक्सेस करने की अनुमति मांगी जाती है.
- अगर उपयोगकर्ता इसकी अनुमति दे देता है, तो Google आपके ऐप्लिकेशन को कुछ समय के लिए इस्तेमाल किए जा सकने वाला ऐक्सेस टोकन देता है.
- आपका ऐप्लिकेशन, ऐक्सेस टोकन से उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध करता है.
- अगर Google को पता चलता है कि आपका अनुरोध और टोकन मान्य है, तो वह आपके ऐप्लिकेशन को अनुरोध किए गए डेटा का ऐक्सेस दे देता है.
कुछ तरीकों में दूसरे चरण भी शामिल हो सकते हैं, जैसे कि रिफ़्रेश टोकन इस्तेमाल करके, नया ऐक्सेस टोकन पाना. अलग-अलग तरह के ऐप्लिकेशन के लिए डेटा ऐक्सेस करने के तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, Google का OAuth 2.0 दस्तावेज़ पढ़ें.
यहां Google Sites Data API के लिए, OAuth 2.0 का इस्तेमाल करके अनुमति के लिए अनुरोध करने के बारे में जानकारी दी गई है:
https://sites.google.com/feeds/
OAuth 2.0 का इस्तेमाल करके, डेटा ऐक्सेस करने का अनुरोध करने के लिए, आपके ऐप्लिकेशन को अनुरोध के तरीके की जानकारी देनी होगी. साथ ही, वह जानकारी भी देनी होगी जो आपको ऐप्लिकेशन रजिस्टर करते समय, Google से मिली थी, जैसे कि क्लाइंट आईडी और क्लाइंट सीक्रेट.
वर्शन तय करना
Google Sites Data API को किए जाने वाले हर अनुरोध में, 1.4 वर्शन का इस्तेमाल किया जाना चाहिए. वर्शन नंबर बताने के लिए,
GData-Version
एचटीटीपी हेडर का इस्तेमाल करें:
GData-Version: 1.4
इसके अलावा, अगर आपके पास एचटीटीपी हेडर सेट करने का विकल्प नहीं है, तो यूआरएल में v=1.4
को क्वेरी पैरामीटर के तौर पर सेट किया जा सकता है. हालांकि, जहां भी हो सके वहां एचटीटीपी हेडर का इस्तेमाल करना बेहतर होता है.
ध्यान दें: क्लाइंट लाइब्रेरी, सही वर्शन हेडर अपने-आप उपलब्ध कराती हैं. इसलिए, क्लाइंट लाइब्रेरी का इस्तेमाल करते समय v=1.4
क्वेरी पैरामीटर का इस्तेमाल न करें.
साइट फ़ीड
साइट फ़ीड का इस्तेमाल उन Google साइटों की सूची बनाने के लिए किया जा सकता है जिनका मालिकाना हक किसी उपयोगकर्ता के पास है या जिनके पास उसे देखने की अनुमतियां हैं. साथ ही, किसी मौजूदा साइट के टाइटल में भी बदलाव किया जा सकता है. G Suite डोमेन के लिए, इसका इस्तेमाल पूरी साइट बनाने या कॉपी करने के लिए भी किया जा सकता है.
लिस्टिंग से जुड़ी साइटें
उपयोगकर्ता के पास जिन साइटों का ऐक्सेस है उनकी सूची बनाने के लिए, इस यूआरएल पर पुष्टि किया गया GET
अनुरोध भेजें:
https://sites.google.com/feeds/site/domainName
फ़ीड पैरामीटर | ब्यौरा |
---|---|
domainName | 'site ' या G Suite से होस्ट किए जा रहे आपके डोमेन का डोमेन नेम (उदाहरण के लिए, example.com ). |
इस जवाब में एक फ़ीड शामिल होगा, जिसमें साइटों की सूची होगी:
GET /feeds/site/domainName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> HTTP/1.1 200 OK <feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0"> <id>https://sites.google.com/feeds/site/site</id> <updated>2009-12-02T17:47:34.406Z</updated> <title>Site</title> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/site/site"/> <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/feeds/site/domainName"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName"/> <link rel="next" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/?start-index=2"/> <generator version="1" uri="http://sites.google.com/">Google Sites</generator> <openSearch:startIndex>1</openSearch:startIndex> <entry gd:etag="W/"CkUAQH4_eil7I2A9WxNaFk4.""> <id>https://sites.google.com/feeds/site/site/myTestSite</id> <updated>2009-12-01T01:17:21.042Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-01T01:17:21.042Z</app:edited> <title>myTestSite</title> <summary/> <link rel="alternate" type="text/html" href="http://sites.google.com/site/myTestSite/"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/myTestSite"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myTestSite"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myTestSite"/> <sites:siteName>myTestSite</sites:siteName> <sites:theme>default</sites:theme> </entry> <entry gd:etag="W/"DkQGQHczfA9WxNaFk4.""> <id>https://sites.google.com/feeds/site/domainName/myOtherTestSite</id> <updated>2009-12-01T02:25:21.987Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-01T02:25:21.987Z</app:edited> <title>myOtherTestSite</title> <summary>A new site to hold memories</summary> <category scheme="http://schemas.google.com/sites/2008#tag" term="Memories Site"/> <link rel="alternate" type="text/html" href="http://sites.google.com/site/myOtherTestSite"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/myOtherTestSite"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <sites:siteName>myOtherTestSite</sites:siteName> <sites:theme>iceberg</sites:theme> </entry> ... </feed>
साइटों की सूची अंग्रेज़ी वर्णमाला के क्रम में दी जाती है.
नई साइटें बनाना
ध्यान दें: यह सुविधा सिर्फ़ G Suite डोमेन के लिए उपलब्ध है.
साइट फ़ीड में एचटीटीपी POST
बनाकर, नई साइटों का प्रावधान किया जा सकता है. उदाहरण के लिए:
POST /feeds/site/example.com HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008"> <title>Source Site</title> <summary>A new site to hold memories</summary> <sites:theme>slate</sites:theme> </entry>
ऊपर दिया गया अनुरोध, G Suite डोमेन example.com
के तहत 'स्लेट' थीम के साथ एक नई Google साइट बनाएगा.
यह साइट का यूआरएल होगा: http://sites.google.com/a/example.com/source-site/.
अगर साइट बन जाती है, तो सर्वर 201 Created
के साथ जवाब देगा.
रिस्पॉन्स एंट्री में, सर्वर से जोड़े गए एलिमेंट शामिल होंगे. जैसे, साइट का लिंक, साइट के ACL फ़ीड का लिंक, साइट का नाम, टाइटल, और खास जानकारी.
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0" gd:etag="W/"DEECR38l7I2A9WxNaF0Q.""> <id>https://sites.google.com/feeds/site/example.com/source-site</id> <updated>2009-12-02T23:31:06.184Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T23:31:06.184Z</app:edited> <title>New Test Site</title> <summary>A new site to hold memories</summary> <link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/source-site/"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/source-site"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/source-site"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/source-site"/> <sites:siteName>source-site</sites:siteName> <sites:theme>slate</sites:theme> </entry>
साइट कॉपी करना
ध्यान दें: यह सुविधा सिर्फ़ G Suite डोमेन के लिए उपलब्ध है.
किसी मौजूदा साइट की डुप्लीकेट कॉपी बनाने का तरीका, नई साइट बनाने जैसा ही है. हालांकि, POST
अनुरोध की ऐटम एंट्री में, <link>
के साथ rel='source'
शामिल करें. rel='source'
, कॉपी की जाने वाली साइट के साइट फ़ीड पर ले जाता है. कॉपी की गई किसी भी साइट पर यह लिंक दिखेगा. किसी साइट की डुप्लीकेट कॉपी बनाने का उदाहरण यहां दिया गया है:
POST /feeds/site/example.com HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom"> <link rel="http://schemas.google.com/sites/2008#source" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/source-site"/> <title>Copy of New Test Site</title> <summary>A newer site to hold memories</summary> </entry>
ऊपर दिया गया अनुरोध, http://sites.google.com/a/example.com/source-site/ पर मौजूद साइट को कॉपी करेगा.
अहम पॉइंट:
- सिर्फ़ उन साइटों और साइट टेंप्लेट को कॉपी किया जा सकता है जिनका मालिकाना हक, पुष्टि किए गए उपयोगकर्ता के पास है.
- साइट टेंप्लेट को भी कॉपी किया जा सकता है. अगर Google Sites के सेटिंग पेज में "इस साइट को टेंप्लेट के रूप में पब्लिश करें" सेटिंग पर सही का निशान लगा है, तो उस साइट को टेंप्लेट माना जाता है.
- अगर सोर्स साइट पर आपको मालिक के तौर पर शामिल किया गया है, तो आपके पास किसी दूसरे डोमेन से साइट को कॉपी करने का विकल्प होगा.
किसी साइट का मेटाडेटा अपडेट करना
किसी साइट का शीर्षक या खास जानकारी अपडेट करने के लिए, साइट में जोड़ी गई एंट्री के edit
लिंक पर एचटीटीपी PUT
भेजें.
उदाहरण के लिए, नीचे दिए गए उदाहरण में, पिछली साइट का टाइटल New Test Site2
और उसका ब्यौरा Newer description
पर अपडेट हो जाएगा.
PUT /feeds/site/example.com/source-site HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0" gd:etag="W/"DEECR38l7I2A9WxNaF0Q.""> <id>https://sites.google.com/feeds/site/example.com/source-site</id> <updated>2009-12-02T23:31:06.184Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T23:31:06.184Z</app:edited> <title>New Test Site2</title> <summary>Newer description</summary> <category scheme="http://schemas.google.com/sites/2008#tag" term="Category"/> <link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/source-site/"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/source-site"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/source-site"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/source-site"/> <sites:siteName>source-site</sites:siteName> </entry>
कैटगरी जोड़ना
ध्यान दें: यह सुविधा सिर्फ़ G Suite डोमेन के लिए उपलब्ध है.
'आपके डोमेन के लिए G Suite' की साइटों में कैटगरी का मेटाडेटा शामिल होता है. यह आपके डोमेन में साइटों को कैटगरी में बांटने के लिए काम का होता है. कैटगरी का मेटा डेटा जोड़ने या अपडेट करने के लिए, अपनी साइट एंट्री के edit
लिंक पर एक एचटीटीपी PUT
भेजें. इस लिंक में, category
टैग शामिल होता है. नीचे दिए गए उदाहरण में बोल्ड लाइन देखें:
PUT /feeds/site/example.com/source-site HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0" gd:etag="W/"DEECR38l7I2A9WxNaF0Q.""> <id>https://sites.google.com/feeds/site/example.com/source-site</id> <updated>2009-12-02T23:31:06.184Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T23:31:06.184Z</app:edited> <title>My Team website</title> <summary>This site contains contact information and a summary of major efforts our team owns</summary> <category scheme="http://schemas.google.com/sites/2008#tag" term="Team Site"/> <link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/my-team-site/"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/my-team-site"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/my-team-site"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/my-team-site"/> <sites:siteName>my-team-site</sites:siteName> </entry>
यह उदाहरण एक मौजूदा साइट में बदलाव करता है और "टीम साइट" की कैटगरी जोड़ता है.
अतिरिक्त <category>
टैग जोड़कर, कई कैटगरी भी जोड़ी जा सकती हैं. इस उदाहरण में बोल्ड लाइन देखें:
PUT /feeds/site/example.com/my-team-site HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0" gd:etag="W/"DEECR38l7I2A9WxNaF0Q.""> <id>https://sites.google.com/feeds/site/example.com/my-team-site</id> <updated>2009-12-02T23:31:06.184Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T23:31:06.184Z</app:edited> <title>My Team website</title> <summary>This site contains contact information and a summary of major efforts our team owns</summary> <category scheme="http://schemas.google.com/sites/2008#tag" term="Team Site/"> <category scheme="http://schemas.google.com/sites/2008#tag" term="Legal Department/"> <link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/my-team-site/"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/my-team-site"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/my-team-site"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/my-team-site"/> <sites:siteName>my-team-site</sites:siteName> </entry>
इस उदाहरण में दो कैटगरी जोड़ी गई हैं: "टीम साइट" और "कानूनी विभाग"
वेब पता मैपिंग
वेब पते की मैपिंग की सुविधा से, Sites के उपयोगकर्ता अपने डोमेन को Google साइट से मैप कर सकते हैं. उदाहरण के लिए, http://sites.google.com/a/domain.com/mysite
के बजाय http://www.mydomainsite.com
का इस्तेमाल किया जा सकता है. आपकी साइट को होस्ट करने की जगह के आधार पर, साइट के वेब पते की मैपिंग में मैन्युअल तरीके से बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, हमारे सहायता केंद्र का लेख पढ़ें.
किसी साइट की वेब पता मैपिंग फ़ेच करना
किसी साइट के वेब पते की मैपिंग दिखाने के लिए, with-mappings=true
पैरामीटर की मदद से साइट एंट्री/फ़ीड फ़ेच करें:
GET /feeds/site/domainName?with-mappings=true HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> HTTP/1.1 200 OK <feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0"> ... <entry gd:etag="W/"DkQGQHczfA9WxNaFk4.""> <id>https://sites.google.com/feeds/site/domainName/myOtherTestSite</id> <updated>2009-12-01T02:25:21.987Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-01T02:25:21.987Z</app:edited> <title>myOtherTestSite</title> <summary>A new site to hold memories</summary> <link rel="alternate" type="text/html" href="http://sites.google.com/site/myOtherTestSite"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/myOtherTestSite"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <link rel='webAddressMapping' href='http://www.mysitemapping.com'> <link rel='webAddressMapping' href='http://www.mysitemapping2.com'> <link rel='webAddressMapping' href='http://www.myothermapping.org'> </entry> ... </feed>
मौजूदा मैपिंग, rel='webAddressMapping' के साथ link
के तौर पर दिखेंगी. उदाहरण के लिए, ऊपर दिए गए उदाहरण में, साइट http://sites.google.com/site/myOtherTestSite
पर ले जाने वाले तीन webAddressMapping
हैं.
वेब पते की मैपिंग में बदलाव करना
ध्यान दें: वेब पता मैपिंग के साथ काम करते समय, सभी GET/POST/PUT ऑपरेशन में with-mappings=true
पैरामीटर की जानकारी होनी चाहिए. अगर पैरामीटर मौजूद नहीं है, तो webAddressMapping
s को साइट एंट्री (GET) में नहीं दिखाया जाएगा. साथ ही, किसी एंट्री से मैपिंग को अपडेट/हटाने (PUT) के दौरान भी इन पर ध्यान नहीं दिया जाएगा.
मैपिंग जोड़ने, अपडेट करने या मिटाने के लिए, नई साइटें बनाते या साइट का मेटाडेटा अपडेट करते समय, बस इस लिंक की जानकारी दें, उसमें बदलाव करें या उसे हटाएं. साइट फ़ीड के यूआरआई में with-mappings=true
पैरामीटर शामिल करना ज़रूरी है.
ध्यान दें: पते के मैपिंग को अपडेट करने के लिए, आपके पास साइट एडमिन या G Suite की होस्ट की गई साइट के मामले में डोमेन एडमिन की भूमिका होनी चाहिए.
उदाहरण के लिए, नीचे दिया गया अनुरोध, http://www.mysitemapping.com
मैपिंग को http://www.my-new-sitemapping.com
पर अपडेट करता है और एंट्री से लिंक को हटाकर http://www.mysitemapping2.com
को हटा देता है:
PUT /feeds/site/domainName?with-mappings=true HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry gd:etag="W/"DkQGQHczfA9WxNaFk4.""> <id>https://sites.google.com/feeds/site/domainName/myOtherTestSite</id> <updated>2009-12-01T02:25:21.987Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-01T02:25:21.987Z</app:edited> <title>myOtherTestSite</title> <summary>A new site to hold memories</summary> <link rel="alternate" type="text/html" href="http://sites.google.com/site/myOtherTestSite"/> <link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/myOtherTestSite"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/domainName/myOtherTestSite"/> <link rel='webAddressMapping' href='www.my-new-sitemapping.com'> <!-- missing mapping2 will be deleted --> <link rel='webAddressMapping' href='http://www.myothermapping.org'> </entry>
ध्यान दें, साइट बनाते/कॉपी करते समय भी वेब पते की मैपिंग की जा सकती है.
गतिविधि फ़ीड
गतिविधि फ़ीड फ़ेच करके, किसी साइट की हाल की गतिविधि (बदलाव) को फ़ेच किया जा सकता है. गतिविधि फ़ीड की हर एंट्री में, साइट में किए गए बदलाव की जानकारी शामिल होती है.
गतिविधि फ़ीड से जुड़ी क्वेरी करने के लिए, गतिविधि फ़ीड के यूआरएल पर एचटीटीपी GET
भेजें:
https://sites.google.com/feeds/activity/domainName/siteName
फ़ीड पैरामीटर | ब्यौरा |
---|---|
domainName | 'site ' या G Suite से होस्ट किए जा रहे आपके डोमेन का डोमेन नेम (उदाहरण के लिए, example.com ). |
siteName | आपकी साइट का वेबस्पेस नाम. यह साइट के यूआरएल (जैसे, myCoolSite ) में दिखता है. |
अनुरोध और जवाब का उदाहरण:
GET /feeds/activity/site/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"> <id>https://sites.google.com/feeds/activity/site/siteName</id> <updated>2009-09-10T05:24:23.120Z</updated> <title>Activity</title> <link rel="alternate" type="text/html" href="http://sites.google.com/site/siteName/system/app/pages/recentChanges"/> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/activity/site/siteName"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/activity/site/siteName"/> <generator version="1" uri="http://sites.google.com">Google Sites</generator> <openSearch:startIndex>1</openSearch:startIndex> <entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CU4GQ3szfSl7ImA9WxNRFUg.""> <id>https://sites.google.com/feeds/activity/site/siteName/940375996952876062</id> <updated>2009-09-10T03:38:42.585Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#deletion" label="deletion"/> <title>home</title> <summary type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">User deleted <a href="http://sites.google.com/site/siteName/home">home</a> </div> </summary> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/site/siteName/5409745539831916487"/> <link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="https://sites.google.com/feeds/content/site/siteName/5409745539831916487"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/activity/site/siteName/940375996952876062"/> <author> <name>User</name> <email>user@gmail.com</email> </author> </entry> <entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CU8DQn45fyl7ImA9WxNRFUg.""> <id>https://sites.google.com/feeds/activity/site/siteName/7165439066235480082</id> <updated>2009-09-10T03:37:53.027Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#edit" label="edit"/> <title>home</title> <summary type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">User2 edited <a href="http://sites.google.com/site/siteName/home">home</a> </div> </summary> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/site/siteName/5409745539831916487"/> <link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="https://sites.google.com/feeds/content/site/siteName/5409745539831916487"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/activity/site/siteName/7165439066235480082"/> <author> <name>User</name> <email>user@gmail.com</email> </author> </entry> <entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CU8AR3s4cSl7ImA9WxNRFUg.""> <id>https://sites.google.com/feeds/activity/site/siteName/127448462987345884</id> <updated>2009-09-10T03:37:26.539Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#creation" label="creation"/> <title>home</title> <summary type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">User3 created <a href="http://sites.google.com/site/siteName/home">home</a> </div> </summary> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/site/siteName/5409745539831916487"/> <link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="https://sites.google.com/feeds/content/site/siteName/5409745539831916487"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/activity/site/siteName/127448462987345884"/> <author> <name>User3</name> <email>user3@gmail.com</email> </author> </entry> </feed>
ध्यान दें: इस फ़ीड को ऐक्सेस करने के लिए, यह ज़रूरी है कि आप साइट के सहयोगी या मालिक हों.
आपके क्लाइंट को सही Authorization
हेडर भेजना होगा और अनुरोधों को अनुमति देने में मिले टोकन का रेफ़रंस देना होगा.
बदलाव वाला फ़ीड
किसी भी कॉन्टेंट एंट्री के बदलाव का इतिहास फ़ेच करने के लिए, एंट्री के बदलाव के लिंक पर एचटीटीपी GET
भेजें:
https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID
फ़ीड पैरामीटर | ब्यौरा |
---|---|
domainName | 'site ' या G Suite से होस्ट किए जा रहे आपके डोमेन का डोमेन नेम (उदाहरण के लिए, example.com ). |
siteName | आपकी साइट का वेबस्पेस नाम. यह साइट के यूआरएल (जैसे, myCoolSite ) में दिखता है. |
किसी पेज/टिप्पणी/अटैचमेंट/सूची में बदलाव करने का लिंक ढूंढने के लिए, सबसे पहले कॉन्टेंट फ़ीड के CONTENT_ENTRY_ID का इस्तेमाल करके, एंट्री को वापस पाएं. वापस लाई गई एंट्री में, बदलाव वाले फ़ीड के लिए <atom:link>
शामिल होगा.
उदाहरण के लिए:
<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID"/>
अनुरोध और जवाब का उदाहरण:
GET /feeds/revision/domainName/siteName/CONTENT_ENTRY_ID HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0"> <id>https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID</id> <updated>2009-09-10T04:33:35.337Z</updated> <title>Revisions</title> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID"/> <generator version="1" uri="http://sites.google.com">Google Sites</generator> <openSearch:startIndex>1</openSearch:startIndex> <entry gd:etag="W/"CU4GQmA9WxNRFUg.""> <id>https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID/2</id> <updated>2009-09-10T03:38:42.045Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>Home</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">Latest content here</div> </content> <link rel="alternate" type="text/html" href="http://sites.google.com/domainName/siteName/CONTENT_ENTRY_ID/system/app/pages/admin/compare?wuid=wuid%3Agx%3A4f67c7&rev1=2"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID/2"/> <author> <name>User</name> <email>user@gmail.com</email> </author> <sites:pageName>home</sites:pageName> <sites:revision>2</sites:revision> </entry> <entry gd:etag="W/"CU8DQ388eSl7ImA9WxNRFUg.""> <id>https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID/1</id> <updated>2009-09-10T03:37:52.171Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>Home</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">Older content here</div> </content> <link rel="alternate" type="text/html" href="http://sites.google.com/domainName/siteName/CONTENT_ENTRY_ID/system/app/pages/admin/compare?wuid=wuid%3Agx%3A4bc7&rev1=1"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/CONTENT_ENTRY_ID/1"/> <author> <name>User</name> <email>user@gmail.com</email> </author> <sites:pageName>home</sites:pageName> <sites:revision>1</sites:revision> </entry> </feed>
ध्यान दें: इस फ़ीड को ऐक्सेस करने के लिए, यह ज़रूरी है कि आप साइट के सहयोगी या मालिक हों.
आपके क्लाइंट को सही Authorization
हेडर भेजना होगा और अनुरोधों को अनुमति देने में मिले टोकन का रेफ़रंस देना होगा.
कॉन्टेंट फ़ीड
कॉन्टेंट वापस लाया जा रहा है
कॉन्टेंट फ़ीड में, साइट के मौजूदा कॉन्टेंट की सूची होती है. पुष्टि किया गया GET
अनुरोध, इस यूआरएल पर भेजें:
https://sites.google.com/feeds/content/domainName/siteName
फ़ीड पैरामीटर | ब्यौरा |
---|---|
domainName | 'site ' या G Suite से होस्ट किए जा रहे आपके डोमेन का डोमेन नेम (उदाहरण के लिए, example.com ). |
siteName | आपकी साइट का वेबस्पेस नाम. यह साइट के यूआरएल (जैसे, myCoolSite ) में दिखता है. |
इससे एक फ़ीड बनता है, जिसमें साइट पर कॉन्टेंट की एंट्री के पहले पेज की सूची होती है. फ़ीड की हर एंट्री एक अलग तरह की कॉन्टेंट एंट्री को दिखाएगी, जैसे कि webpage
, filecabinet
, attachment
, comment
वगैरह. <category scheme="http://schemas.google.com/g/2005#kind">
एलिमेंट से यह तय होता है कि एंट्री किस तरह की है. kind
वैल्यू की सूची देखने के लिए, रेफ़रंस गाइड देखें.
ध्यान दें: साइट की शेयर करने की अनुमतियों के आधार पर, हो सकता है कि इस फ़ीड के लिए पुष्टि करने की ज़रूरत पड़े या न पड़े.
अगर साइट सार्वजनिक नहीं है, तो आपके क्लाइंट को सही Authorization
हेडर भेजना होगा (जैसा कि ऊपर दिए गए उदाहरण में देखा गया है) और अनुरोधों को अनुमति देने में मिले टोकन का रेफ़रंस देना होगा.
GET /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0"> <id>https://sites.google.com/feeds/content/domainName/siteName</id> <updated>2009-08-31T01:39:20.286Z</updated> <title>Content</title> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName"/> <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName"/> <link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/batch""/> <link rel="next" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/?start-index=2"/> <generator version="1" uri="http://sites.google.com">Google Sites</generator> <openSearch:startIndex>1</openSearch:startIndex> <entry gd:etag="W/"Ck8GQXk7fil7ImA9WxNSFk0.""> <id>https://sites.google.com/feeds/content/domainName/siteName/7322156894</id> <updated>2009-08-30T02:53:40.706Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-08-30T02:53:40.706Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>Subpage</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">Page html content here</div> </content> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/6492205817"/> <link rel="alternate" type="text" href="http://sites.google.com/site/siteName/subpage"/> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/7322156894"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/7322156894"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/7322156894"/> <author> <name>User</name> <email>user@gmail.com</email> </author> <sites:pageName>subpage</sites:pageName> <sites:revision>5</sites:revision> </entry> <entry gd:etag="W/"CkMBQH08fCl7ImA9WxNSFk0.""> <id>https://sites.google.com/feeds/content/domainName/siteName/5930635231</id> <updated>2009-08-30T02:47:31.374Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-08-30T02:47:31.374Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listitem" label="listpage"/> <title/> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/5930635231"/> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/5930635231"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/5930635231"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/5930635231"/> <author> <name>User</name> <email>user@gmail.com</email> </author> <sites:revision>1</sites:revision> <gs:field index="A" name="Issue/Feature">Implement cool feature X</gs:field> <gs:field index="B" name="Priority">P2</gs:field> <gs:field index="C" name="Owner"/> <gs:field index="D" name="Resolved"/> </entry> <entry gd:etag="W/"AkYHQ3ozcCl7ImA9WxJaE08.""> <id>https://sites.google.com/feeds/content/domainName/siteName/1265948545471894517</id> <updated>2009-08-03T19:35:32.488Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-08-03T19:35:32.488Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#filecabinet" label="filecabinet"/> <title>files</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">Page html content here</div> </content> <link rel="alternate" type="text" href="https://sites.google.com/domainName/siteName/files"/> <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="https://sites.google.com/feeds/revision/domainName/siteName/12671894517"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/12671894517"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/12671894517"/> <author> <name>User</name> <email>user@gmail.com</email> </author> <gd:feedLink href="httpn://sites.google.com/feeds/content/domainName/siteName?parent=12671894517"/> <sites:pageName>files</sites:pageName> <sites:revision>1</sites:revision> </entry> ... </feed>
ध्यान दें: यह सिर्फ़ पहले कुछ नतीजे हैं. पूरे कॉन्टेंट फ़ीड पर जाने के लिए, फ़ीड के 'अगला' लिंक पर जाएं:
<link rel="next" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/?start-index=2"/>
ऐटम के सामान्य एलिमेंट की जानकारी के लिए, Google डेटा प्रोटोकॉल का संदर्भ देखें.
क्लासिक Sites API में जिन एलिमेंट का इस्तेमाल किया जाता है उनके बारे में यहां बताया गया है. कुछ तरह की एंट्री में अतिरिक्त प्रॉपर्टी होंगी (जो यहां दी गई सूची में नहीं हैं), जबकि अन्य में नहीं होंगी. उदाहरण के लिए, listitem
एंट्री में <gs:field>
एलिमेंट हो सकते हैं, जबकि webpage
एंट्री में नहीं.
एलिमेंट | ब्यौरा |
---|---|
<content ...> | अंदरूनी टेक्स्ट, पेज का एचटीएमएल मुख्य हिस्सा होता है. कुछ एंट्री (जैसे, अटैचमेंट) के लिए, इस एलिमेंट में फ़ाइल की जानकारी देने वाला src एट्रिब्यूट होगा. |
<link rel="alternate" ...> | Google Sites में मौजूद पेज या आइटम से लिंक करें. |
<link rel="http://schemas.google.com/sites/2008#revision" ...> | href एट्रिब्यूट, एंट्री के रिविज़न फ़ीड पर ले जाता है. |
<link rel="http://schemas.google.com/sites/2008#parent" ...> | href एट्रिब्यूट, एंट्री की पैरंट एंट्री पर ले जाता है. |
<link rel="http://schemas.google.com/sites/2008#template" ...> | href एट्रिब्यूट, एंट्री के टेंप्लेट पेज पर ले जाता है. |
<category scheme="http://schemas.google.com/g/2005#kind" ...> | label , एंट्री का टाइप है. |
<category term="http://schemas.google.com/g/2005#template" ...> | label=template , जिसका मतलब है कि एंट्री एक टेंप्लेट है. |
<gd:feedLink> | href एट्रिब्यूट, एंट्री के पैरंट के चाइल्ड पर ले जाता है. |
<sites:pageName> | पेज का वेबस्पेस नेम, जो पेज के यूआरएल में मौजूद नाम से मेल खाता है. |
<sites:revision> | मौजूदा संशोधन नंबर. |
कॉन्टेंट फ़ीड क्वेरी के उदाहरण
Google Data API के स्टैंडर्ड क्वेरी पैरामीटर और Sites API के क्लासिक वर्शन के लिए खास तौर पर बनाए गए पैरामीटर का इस्तेमाल करके, कॉन्टेंट फ़ीड को खोजा जा सकता है. ज़्यादा जानकारी और इस्तेमाल किए जा सकने वाले पैरामीटर की पूरी सूची के लिए, रेफ़रंस गाइड देखें.
खास एंट्री टाइप को फिर से पाना
सिर्फ़ किसी खास तरह की एंट्री फ़ेच करने के लिए, kind
पैरामीटर का इस्तेमाल करें. इस उदाहरण में सिर्फ़ webpage
एंट्री दिखती हैं:
GET /feeds/content/domainName/siteName?kind=webpage
एक से ज़्यादा तरह की एंट्री दिखाने के लिए, हर kind
को ',' से अलग करें. इस उदाहरण में, filecabinet
और listpage
की एंट्री दिखेंगी:
GET /feeds/content/domainName/siteName?kind=filecabinet,listpage
इसके अलावा, kind
पैरामीटर के बजाय, Google डेटा /-/category
क्वेरी के लिए स्टैंडर्ड फ़ॉर्मैट का इस्तेमाल किया जा सकता है:
GET /feeds/content/domainName/siteName/-/filecabinet|listpage
पेज टेंप्लेट वापस लाना
इस उदाहरण में सिर्फ़ template
पेज दिखते हैं:
GET /feeds/content/domainName/siteName/-/template
सभी तरह की एंट्री दिखाने और template
पेजों को शामिल करने के लिए, इनका इस्तेमाल करें:
GET /feeds/content/domainName/siteName/-/template|-template
पाथ के हिसाब से पेज वापस पाना
अगर आपको Google साइट में किसी पेज का रिलेटिव पाथ पता है, तो उस पेज को फ़ेच करने के लिए path
पैरामीटर का इस्तेमाल किया जा सकता है.
इस उदाहरण में, http://sites.google.com/site/siteName/path/to/the/page
पर मौजूद पेज दिखेगा:
GET /feeds/content/domainName/siteName?path=/path/to/the/page
किसी पेरंट पेज के तहत मौजूद सभी एंट्री को वापस पाना
अगर आपको किसी पेज का एंट्री आईडी पता है, तो इसकी सभी चाइल्ड एंट्री (अगर कोई हो) फ़ेच करने के लिए, parent
पैरामीटर का इस्तेमाल करें:
GET /feeds/content/domainName/siteName?parent=CONTENT_ENTRY_ID
ड्राफ़्ट या मिटाई गई एंट्री शामिल करना
ड्राफ़्ट या मिटाई गई एंट्री शामिल करने के लिए, include-drafts
या include-deleted
पैरामीटर का इस्तेमाल करें.
इस उदाहरण में, कॉन्टेंट फ़ीड में ड्राफ़्ट की गई एंट्री शामिल हैं:
GET /feeds/content/domainName/siteName?include-drafts=true
पूरे टेक्स्ट की खोज
किसी साइट के पूरे कॉन्टेंट में खोजने के लिए, पूरे टेक्स्ट वाली खोज जारी करने के लिए q
पैरामीटर का इस्तेमाल करें:
GET /feeds/content/domainName/siteName?q=Text%20I%20am%20looking%20for
कॉन्टेंट बनाना
कॉन्टेंट फ़ीड में एचटीटीपी POST
भेजकर, नया कॉन्टेंट (वेबपेज, सूची वाले पेज, फ़ाइल कैबिनेट पेज, सूचना वाले पेज वगैरह) बनाया जा सकता है:
https://sites.google.com/feeds/content/domainName/siteName
इस्तेमाल किए जा सकने वाले एंट्री टाइप की सूची देखने के लिए, रेफ़रंस गाइड में kind
पैरामीटर देखें.
नए आइटम / पेज बनाना
इस उदाहरण में, साइट के टॉप-लेवल के नीचे एक नया webpage
बनाया गया है. इसमें पेज के मुख्य हिस्से के लिए कुछ एक्सएमएलटी शामिल है और हेडिंग का टाइटल 'नया वेबपेज टाइटल' पर सेट किया गया है:
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 328 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>New Webpage Title</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">HTML body goes here</div> </content> </entry>
कामयाब होने पर, सर्वर 201 Created
और एंट्री की कॉपी के साथ जवाब देता है.
कस्टम यूआरएल पाथ में आइटम/पेज बनाना
डिफ़ॉल्ट रूप से, पिछला उदाहरण यूआरएल http://sites.google.com/domainName/siteName/new-webpage-title
के तहत बनेगा और इसका पेज हेडिंग 'नया वेबपेज टाइटल' होगा. इसका मतलब है कि यूआरएल के लिए <atom:title>
को new-webpage-title
में बदल दिया जाता है.
किसी पेज के यूआरएल पाथ को अपनी पसंद के मुताबिक बनाने के लिए, <sites:pageName>
एलिमेंट को सेट किया जा सकता है.
इस उदाहरण में, 'फ़ाइल स्टोरेज' पेज हेडिंग के साथ एक नया filecabinet
बनाया गया है. हालांकि, <sites:pageName>
एलिमेंट की जानकारी देकर, पेज को यूआरएल http://sites.google.com/domainName/siteName/files
के तहत बनाया गया है.
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 393 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#filecabinet" label="filecabinet"/> <title>File Storage</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">A list of files is below.</div> </content> <sites:pageName>files</sites:pageName> </entry>
किसी पेज के यूआरएल पाथ को नाम देने के लिए, सर्वर इन प्राथमिकता नियमों का इस्तेमाल करता है:
<sites:pageName>
, अगर मौजूद है.a-z, A-Z, 0-9, -, _
को पूरा करना ज़रूरी है.<atom:title>
, अगर pageName मौजूद नहीं है, तो इसकी वैल्यू शून्य नहीं होनी चाहिए. नॉर्मलाइज़ेशन के लिए, खाली सफ़ेद जगह में काट-छांट करके उसे छोटा करके '-' किया जाता है. साथ ही,a-z, A-Z, 0-9, -, _
से मेल न खाने वाले वर्णों को हटाया जाता है.
उदाहरण के लिए, सर्वर 'Custom_Page2' को स्वीकार कर लेगा.
सबपेज बनाना
किसी पेज के तहत सबपेज (चाइल्ड पेज) बनाने के लिए, अपनी नई Atom एंट्री में <link rel="http://schemas.google.com/sites/2008#parent">
शामिल करें. लिंक के href
एट्रिब्यूट को पैरंट एंट्री के सेल्फ़ लिंक पर सेट करें.
इस उदाहरण में, 'सूचना' हेडिंग वाला नया announcement
बनाया गया है. यह सूचना, एंट्री आईडी PARENT_ENTRY_ID
वाले पैरंट पेज के तहत है. पेज के मुख्य हिस्से के लिए XHTML कॉन्टेंट भी शामिल किया गया है:
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 470 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#announcement" label="announcement"/> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/PARENT_ENTRY_ID"/> <title>announcement</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">This weekend. My place.</div> </content> </entry>
पेज टेंप्लेट
पेज के टेंप्लेट बनाना
पेज टेंप्लेट बनाने की प्रोसेस, नए आइटम/पेज बनाने और सबपेज बनाने की प्रोसेस जैसी ही है. अंतर यह है कि इसमें category
को टर्म और लेबल के साथ जोड़ा जाता है, जो क्रमशः 'http://schemas.google.com/g/2005#template' और 'टेंप्लेट' पर सेट होता है.
इस उदाहरण में, नया webpage
टेंप्लेट बनाया गया है.
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 464 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <category scheme="http://schemas.google.com/g/2005#labels" term="http://schemas.google.com/g/2005#template" label="template"/> <title>Webpage Template</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">This weekend. My place.</div> </content> </entry>
किसी टेंप्लेट से पेज बनाना
पेज टेंप्लेट बनाने की तरह ही, किसी टेंप्लेट से नया पेज बनाया जा सकता है. इसके लिए, <link>
को rel='http://schemas.google.com/sites/2008#template' के साथ शामिल करें. यह एट्रिब्यूट, पेज टेंप्लेट के सेल्फ़ लिंक पर ले जाता है.
इस उदाहरण में, किसी मौजूदा पेज टेंप्लेट से नया filecabinet
पेज बनाया गया है. इस टेंप्लेट में फ़ाइल कैबिनेट की जानकारी दी गई है.
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 464 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#filecabinet" label="filecabinet"/> <title>File Cabinet Page From Template</title> <link rel='http://schemas.google.com/sites/2008#template' type='application/atom+xml' href='https://sites.google.com/feeds/content/domainName/siteName/ENTRY_ID'/> </entry>
ध्यान दें: <category>
तय करने वाले टेंप्लेट के बावजूद, आपकी एंट्री में एक टेंप्लेट
शामिल करना ज़रूरी है. यह भी ध्यान रखें कि अगर आपने <content>
एलिमेंट शामिल किया है, तो सर्वर उसे अस्वीकार कर देगा.
फ़ाइलें अपलोड करना
Google Sites की तरह ही, एपीआई की मदद से फ़ाइल केबिनेट पेजों और पैरंट पेजों पर अटैचमेंट अपलोड किए जा सकते हैं.
किसी अभिभावक के लिए अटैचमेंट अपलोड करने के लिए, कॉन्टेंट फ़ीड के यूआरएल पर एचटीटीपी POST
अनुरोध भेजें:
https://sites.google.com/feeds/content/domainName/siteName
POST
का मुख्य हिस्सा, MIME मल्टीपार्ट अनुरोध होना चाहिए, ताकि फ़ाइल के कॉन्टेंट को अटैचमेंट के मेटाडेटा वाले <atom:entry>
के साथ जोड़ा जा सके. <atom:entry>
में पैरंट एंट्री के सेल्फ़ लिंक का रेफ़रंस दिया जाना चाहिए, ताकि यह बताया जा सके कि अटैचमेंट कहां बनाया जाएगा.
ज़्यादा जानकारी के लिए, सबपेज बनाना लेख पढ़ें.
अटैचमेंट अपलोड हो रहे हैं
PARENT_ENTRY_ID
आईडी वाले फ़ाइल कैबिनेट में PDF फ़ाइल अपलोड करने का एक उदाहरण यहां दिया गया है. इस अटैचमेंट को 'PDF फ़ाइल' शीर्षक और 'HR पैकेट' के साथ (ज़रूरी नहीं) ब्यौरे के साथ बनाया जाएगा.
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 7221984 Content-Type: multipart/related; boundary=END_OF_PART --END_OF_PART Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#attachment" label="attachment"/> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/PARENT_ENTRY_ID"/> <title>PDF File</title> <summary>HR packet</summary> </entry> --END_OF_PART Content-Type: application/pdf ... pdf contents here ... --END_OF_PART--
अगर अपलोड हो जाता है, तो सर्वर 201 Created
और नई बनाई गई अटैचमेंट एंट्री की कॉपी के साथ जवाब देगा.
किसी फ़ोल्डर में अटैचमेंट अपलोड करना
filecabinet
में मौजूद किसी फ़ोल्डर में अटैचमेंट अपलोड करने के लिए, फ़ोल्डर के नाम पर सेट किए गए 'टर्म' एट्रिब्यूट के साथ कैटगरी शामिल करें:
<category scheme="http://schemas.google.com/sites/2008#folder" term="FolderName">
वेब अटैचमेंट
वेब अटैचमेंट, अटैचमेंट के खास तरह के होते हैं. मूल रूप से, वे वेब पर मौजूद ऐसी अन्य फ़ाइलों के लिंक होते हैं जिन्हें फ़ाइल कैबिनेट लिस्टिंग में जोड़ा जा सकता है. यह सुविधा, Google Sites के यूज़र इंटरफ़ेस (यूआई) में 'यूआरएल से फ़ाइल जोड़ें' अपलोड करने के तरीके से मिलती-जुलती है.
ध्यान दें: वेब अटैचमेंट सिर्फ़ फ़ाइल कैबिनेट में बनाए जा सकते हैं. इन्हें दूसरे तरह के पेजों पर अपलोड नहीं किया जा सकता.
इस उदाहरण में, आईडी FILECABINET_ENTRY_ID
से रेफ़र की गई फ़ाइल कैबिनेट के तहत webattachment
बनाया गया है.
इसका टाइटल और (ज़रूरी नहीं) ब्यौरा, क्रमशः 'GoogleLogo' और 'nice colors' पर सेट है.
POST /feeds/content/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Type: application/atom+xml Content-Length: 531 <entry xmlns="http://www.w3.org/2005/Atom"> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webattachment" label="webattachment"/> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/FILECABINET_ENTRY_ID"/> <title>GoogleLogo</title> <summary>nice colors</summary> <content type="image/gif" src="http://www.google.com/images/logo.gif"></content> </entry>
POST
, उपयोगकर्ता के फ़ाइल कैबिनेट में एक लिंक बनाता है, जो 'http://www.google.com/images/logo.gif' पर मौजूद इमेज पर ले जाता है.
कॉन्टेंट अपडेट करना
किसी भी पेज के मेटाडेटा (टाइटल, pageName वगैरह) और पेज के कॉन्टेंट में बदलाव करने के लिए, edit
लिंक पर एक ही PUT
अनुरोध किया जा सकता है.
अनुरोध के मुख्य हिस्से में, अपडेट किए गए पेज के बारे में जानकारी देने वाली ऐटम एंट्री होनी चाहिए. इस नियम का अपवाद अटैचमेंट एंट्री है. इसमें एंट्री का इस्तेमाल सिर्फ़ अटैचमेंट के मेटाडेटा को अपडेट करने के लिए किया जा सकता है.
अटैच की गई फ़ाइल का कॉन्टेंट बदलने के लिए, रॉ डेटा को PUT
अटैचमेंट के edit-media
लिंक के अनुरोध के मुख्य हिस्से के तौर पर शामिल करें. MIME मल्टीपार्ट अनुरोध का इस्तेमाल करके, मेटाडेटा और अटैच की गई फ़ाइल के कॉन्टेंट, दोनों को एक साथ अपडेट किया जा सकता है.
यह बताने के लिए कि आपका अपडेट, किसी दूसरे क्लाइंट के बदलावों को ओवरराइट नहीं करता, ओरिजनल एंट्री की ETag वैल्यू शामिल करें. ऐसा करने के लिए, एचटीटीपी If-Match
हेडर में ETag की वैल्यू दें या अपडेट की गई एंट्री में मूल एंट्री का gd:etag
एट्रिब्यूट शामिल करें. ओरिजनल एंट्री की ETag वैल्यू पता करने के लिए, <entry>
एलिमेंट के gd:etag
एट्रिब्यूट की जांच करें.
मीडिया एंट्री के लिए, मीडिया का ETag, edit-media
लिंक के gd:etag
एट्रिब्यूट में उपलब्ध हो सकता है.
अगर आपको एंट्री को अपडेट करना है, भले ही आपने उसे वापस पाने के बाद किसी और ने अपडेट किया हो, तो If-Match: *
का इस्तेमाल करें और ETag शामिल न करें. ई-टैग के बारे में ज़्यादा जानकारी के लिए, Google Data API की रेफ़रंस गाइड देखें.
किसी आइटम का मेटाडेटा या एचटीएमएल कॉन्टेंट अपडेट करना
किसी एंट्री के मेटाडेटा या एचटीएमएल कॉन्टेंट को अपडेट करने के लिए, एंट्री के edit
लिंक पर एक एचटीटीपी PUT
भेजें.
listpage
एंट्री (जिसे इसके आईडी ENTRY_ID
से दिखाया जाता है) को इन बदलावों के साथ अपडेट करने का एक उदाहरण नीचे दिया गया है:
- इसके टाइटल में बदलाव करके, 'अपडेट किया गया कॉन्टेंट' किया गया
- अपडेट किया गया एचटीएमएल कॉन्टेंट
- सूची के पहले कॉलम का टाइटल, 'मालिक' पर अपडेट कर दिया गया है
- पेज के यूआरएल पाथ में
<sites:pageName>
एलिमेंट की मदद से बदलाव किया गया है
PUT /feeds/content/domainName/siteName/ENTRY_ID Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 816 Content-Type: application/atom+xml <entry xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CEEBRn0ymA9WxJWEUw.""> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listpage" label="listpage"/> <title>Updated Title</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">Updated Content</div> </content> <gs:worksheet name="listpage"/> <gs:header row="1"/> <gs:data startRow="2"> <gs:column index="A" name="Owner"/> <gs:column index="B" name="Decription"/> <gs:column index="C" name="Completed"/> </gs:data> <sites:pageName>newPagePath</sites:pageName> </entry>
ध्यान दें: सर्वर से मिली एंट्री में, ऊपर दिए गए उदाहरण से ज़्यादा एलिमेंट होंगे.
अटैचमेंट का कॉन्टेंट बदलना
यहां अटैचमेंट के कॉन्टेंट को बदलने का उदाहरण दिया गया है. हालांकि, इसके मेटाडेटा में कोई बदलाव नहीं किया गया है. अनुरोध में नया कॉन्टेंट शामिल होने की वजह से, अटैचमेंट एंट्री के edit-media
लिंक का इस्तेमाल किया जाता है.
PUT /feeds/media/content/domainName/siteName/ATTACHMENT_ENTRY_ID Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Length: 70581 Content-Type: application/msword ... doc contents here ...
अटैचमेंट का मेटाडेटा और कॉन्टेंट अपडेट करना
नीचे किसी अटैचमेंट के मेटाडेटा और उसके कॉन्टेंट को एक साथ अपडेट करने का एक उदाहरण दिया गया है. अटैचमेंट का नाम 'नया टाइटल' पर अपडेट हो जाएगा और उसके कॉन्टेंट को .zip फ़ाइल के कॉन्टेंट से बदल दिया जाएगा. अनुरोध में नई फ़ाइल का कॉन्टेंट शामिल होने की वजह से, अटैचमेंट एंट्री के edit-media
लिंक का इस्तेमाल किया जाता है.
ध्यान दें कि मेटाडेटा के लिए ETag शामिल करने पर, मीडिया कॉन्टेंट के लिए भी If-Match
अपने-आप जुड़ जाता है. इसकी वजह यह है कि मीडिया कॉन्टेंट में किसी भी तरह का बदलाव करने पर, मेटाडेटा का ETag बदल जाता है.
PUT /feeds/media/content/domainName/siteName/ATTACHMENT_ENTRY_ID Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> Content-Type: multipart/related; boundary="END_OF_PART" --END_OF_PART Content-Type: application/atom+xml <?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="BxAaTxRZAyp7ImBq"> <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="https://sites.google.com/feeds/content/domainName/siteName/ATTACHMENT_ENTRY_ID"/> <title>New Title</title> </entry> --END_OF_PART Content-Type: application/zip ... zip contents here ... --END_OF_PART
कॉन्टेंट मिटाना
Google साइट से किसी आइटम को हटाने के लिए, पहले एंट्री को वापस पाएं. इसके बाद, एंट्री के edit
यूआरएल पर DELETE
अनुरोध भेजें. यह वही यूआरएल है जिसका इस्तेमाल किसी आइटम के मेटाडेटा या एचटीएमएल कॉन्टेंट को अपडेट करते समय किया जाता है.
DELETE /feeds/content/domainName/siteName/ENTRY_ID Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> If-Match: <ETag or * here>
अगर एंट्री मिट जाती है, तो सर्वर एचटीटीपी 200 OK
के साथ जवाब देता है.
अगर आपको यह पक्का करना है कि आपने वह एंट्री मिटाई न हो जिसे वापस पाने के बाद किसी दूसरे क्लाइंट ने बदल दिया है, तो एक ऐसा एचटीटीपी If-Match
हेडर शामिल करें जिसमें ओरिजनल एंट्री की ETag वैल्यू शामिल हो. <entry>
एलिमेंट के gd:etag
एट्रिब्यूट की जांच करके, मूल एंट्री की ETag वैल्यू का पता लगाया जा सकता है.
अगर आपको प्रविष्टि मिटानी है, भले ही आपने उसे वापस पाने के बाद किसी और ने अपडेट किया हो, तो If-Match: *
का इस्तेमाल करें और ETag शामिल न करें. (इस मामले में, आपको एंट्री मिटाने से पहले उसे वापस पाने की ज़रूरत नहीं है.)
ईटीएग के बारे में ज़्यादा जानकारी के लिए, Google Data API की रेफ़रंस गाइड देखें.
अटैचमेंट डाउनलोड किए जा रहे हैं
अटैचमेंट की एंट्री मिलने के बाद, फ़ाइल को डाउनलोड किया जा सकता है. इसके लिए, एंट्री के <content>
src लिंक पर पुष्टि किया गया एचटीटीपी GET
भेजें. PDF के कॉन्टेंट के लिंक का उदाहरण:
<content type="application/pdf" src="http://502377765-a-google-com-s-sites.googlegroups.com/feeds/media/content/domainName/siteName/678942036"/>
एसीएल फ़ीड
शेयर करने की अनुमतियों (एसीएल) के बारे में खास जानकारी
ACL फ़ीड की हर ACL एंट्री किसी खास इकाई की ऐक्सेस भूमिका दिखाती है. इसमें उपयोगकर्ता, उपयोगकर्ताओं का ग्रुप, डोमेन या डिफ़ॉल्ट ऐक्सेस (जो एक सार्वजनिक साइट है) शामिल है. एंट्री सिर्फ़ उन इकाइयों के लिए दिखाई जाएंगी जिनके पास साफ़ तौर पर ऐक्सेस है. हर ई-मेल पते के लिए, Google Sites के यूज़र इंटरफ़ेस (यूआई) की शेयरिंग स्क्रीन में "ऐक्सेस वाले लोग" पैनल में एक एंट्री दिखेगी. इसलिए, डोमेन एडमिन नहीं दिखाए जाएंगे, भले ही उनके पास किसी साइट का इंप्लिसिट ऐक्सेस हो.
भूमिकाएं
भूमिका एलिमेंट, किसी इकाई के ऐक्सेस लेवल को दिखाता है. gAcl:role
एलिमेंट की चार वैल्यू हो सकती हैं:
- रीडर — दर्शक (रीड ओनली ऐक्सेस के बराबर).
- लेखक — एक सहयोगी (पढ़ने/लिखने का ऐक्सेस) के बराबर है.
- मालिक — आम तौर पर, साइट एडमिन (रीड/राइट ऐक्सेस के बराबर).
स्कोप
स्कोप एलिमेंट, उस इकाई के बारे में बताता है जिसके पास यह ऐक्सेस लेवल है. gAcl:scope
एलिमेंट पांच तरह के हो सकते हैं:
- user — ईमेल पते की वैल्यू, जैसे कि "user@gmail.com".
- group — Google ग्रुप का ईमेल पता, जैसे कि "group@domain.com".
- domain — G Suite डोमेन नेम, जैसे कि "domain.com".
- न्योता — वह उपयोगकर्ता जिसे साइट का न्योता भेजा गया है, लेकिन उसे अब तक साइट के लिए एसीएल में नहीं जोड़ा गया है. (अगर gdata 1.3 या इससे पहले के वर्शन के बारे में बताया गया है, तो उपलब्ध नहीं होता.)
- डिफ़ॉल्ट — "डिफ़ॉल्ट" टाइप का सिर्फ़ एक स्कोप हो सकता है, जिसकी कोई वैल्यू नहीं होती (उदाहरण के लिए,
<gAcl:scope type="default">
). यह स्कोप, किसी सार्वजनिक साइट पर डिफ़ॉल्ट रूप से किसी भी उपयोगकर्ता के पास मौजूद ऐक्सेस को कंट्रोल करता है.
ध्यान दें: डोमेन में gAcl:role
वैल्यू को "मालिक" के ऐक्सेस पर सेट नहीं किया जा सकता. ये वैल्यू सिर्फ़ पाठक या लेखक हो सकते हैं.
"न्योता" स्कोप के बारे में जानकारी.
एपीआई, न्योते का दायरा तब दिखाता है, जब ACL में एक या उससे ज़्यादा ऐसे उपयोगकर्ता जोड़े जाते हैं जिनके पास पहले से कोई Google खाता नहीं है. एपीआई, एम्बेड किए गए टोकन के साथ एक यूआरएल दिखाता है. न्योता स्वीकार करने के लिए, आपको न्योता पाने वाले उपयोगकर्ताओं को यह यूआरएल देना होगा.
न्योता भेजने के इस तरीके से, Google के अलावा अन्य प्लैटफ़ॉर्म का इस्तेमाल करने वाले लोगों को न्योता भेजा जा सकता है. इसके लिए, यह जानना ज़रूरी नहीं है कि वे किस ईमेल पते का इस्तेमाल करना चाहते हैं. जब तक उपयोगकर्ता, एम्बेड किए गए टोकन वाले न्योते के यूआरएल पर क्लिक करते हैं, तब तक वे किसी भी ईमेल पते का इस्तेमाल करके, ऐक्सेस के लिए साइन अप कर सकते हैं. इसके अलावा, न्योता स्वीकार करने के लिए एक से ज़्यादा उपयोगकर्ता इस यूआरएल का इस्तेमाल कर सकते हैं. इसलिए, किसी एक उपयोगकर्ता या उपयोगकर्ताओं के ग्रुप को न्योता भेजते समय यह यूआरएल काम आ सकता है.
ध्यान दें: "न्योता" स्कोप सिर्फ़ gdata के 1.4 और उसके बाद के वर्शन में उपलब्ध है. अगर आपने साफ़ तौर पर 1.3 या उससे पहले के वर्शन का इस्तेमाल करने की जानकारी दी है, तो यह तरीका काम नहीं करेगा.
एसीएल फ़ीड को वापस लाना
एसीएल फ़ीड का इस्तेमाल, किसी साइट की शेयर करने की अनुमतियों को कंट्रोल करने के लिए किया जा सकता है. इसे इस यूआरआई से ऐक्सेस किया जा सकता है:
https://sites.google.com/feeds/acl/site/domainName/siteName
फ़ीड पैरामीटर | ब्यौरा |
---|---|
domainName | 'site ' या G Suite से होस्ट किए जा रहे आपके डोमेन का डोमेन नेम (उदाहरण के लिए, example.com ). |
siteName | आपकी साइट का वेबस्पेस नाम; जो साइट के यूआरएल में मिला है (जैसे, myCoolSite ). |
ध्यान दें कि साइट फ़ीड की हर एंट्री में, इस फ़ीड का लिंक होता है:
<link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName"/>
किसी साइट की शेयर करने की अनुमतियां वापस पाने के लिए, एसीएल फ़ीड यूआरआई पर एचटीटीपी GET
भेजें:
GET /feeds/acl/site/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here>
सर्वर, 200 OK
और एसीएल एंट्री के फ़ीड के साथ जवाब देगा:
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0"> <id>https://sites.google.com/feeds/acl/site/domainName/siteName</id> <updated>2009-12-03T22:01:05.963Z</updated> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <title>Acl</title> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName"/> <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName"/> <generator version="1" uri="http://sites.google.com">Google Sites</generator> <openSearch:startIndex>1</openSearch:startIndex> <entry> <id>https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserA%40gmail.com</id> <updated>2009-12-03T22:01:05.963Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-03T22:01:05.963Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserA%40google.com"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserA%40google.com"/> <gAcl:scope type="user" value="userA@google.com"/> <gAcl:role value="owner"/> </entry> <entry> <id>https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserB%40gmail.com</id> <updated>2009-12-03T22:01:05.963Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-03T22:01:05.963Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserB%40gmail.com"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserB%40gmail.com"/> <gAcl:scope type="user" value="userB@gmail.com"/> <gAcl:role value="writer"/> </entry> <entry> <id>https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserC%40gmail.com</id> <updated>2009-12-03T22:01:05.963Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-03T22:01:05.963Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserC%40gmail.com"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3AuserC%40gmail.com"/> <gAcl:scope type="user" value="userC@gmail.com"/> <gAcl:role value="reader"/> </entry> ... </feed>
साइट शेयर करना
ACL फ़ीड, GET
, POST
, और PUT
अनुरोध स्वीकार करता है. ACL फ़ीड में नई भूमिका शामिल करने के लिए, साइट के ACL फ़ीड में एक POST
अनुरोध जारी करें.
ध्यान दें: शेयर करने के लिए कुछ एसीएल सिर्फ़ तब लागू हो सकते हैं, जब डोमेन को ऐसी अनुमतियों की अनुमति देने के लिए कॉन्फ़िगर किया गया हो. उदाहरण के लिए, अगर G Suite डोमेन के लिए, डोमेन से बाहर शेयर करने की सुविधा चालू है वगैरह.
इस उदाहरण में, साइट पर एक नया सहयोगी (लेखक) जोड़ा गया है:
POST /feeds/acl/site/domainName/siteName HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl='http://schemas.google.com/acl/2007'> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/acl/2007#accessRule'/> <gAcl:role value='writer'/> <gAcl:scope type='user' value='new_writer@example.com'/> </entry>
डेटा डालने के बाद, 201 Created
और नई एंट्री दिखती है:
<entry> <id>https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com</id> <updated>2009-12-03T22:01:05.963Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-03T22:01:05.963Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com"/> <gAcl:role value='writer'/> <gAcl:scope type='user' value='new_writer@example.com'/> </entry>
"न्योता" स्कोप की मदद से उपयोगकर्ताओं को न्योता भेजना
अगर आपने ऐसे उपयोगकर्ताओं को जोड़ा है जिनके पास Google खाते नहीं हैं, तो एपीआई एक यूआरएल दिखाता है. आपको यह यूआरएल उन उपयोगकर्ताओं को देना होगा जिन्हें न्योता भेजना है. यूआरएल पर क्लिक करने के बाद, वह मौजूदा खाते से साइन इन करके या नया खाता बनाकर, साइट को ऐक्सेस कर सकेगा.
न्योता भेजने पर, आपको 201 Created
और एक नई एंट्री दिखेगी. इसमें वह यूआरएल शामिल होगा जिसे आपको उपयोगकर्ता को भेजना होगा:
<entry> <id>https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_invite%40example.com</id> <updated>2009-12-03T22:01:05.963Z</updated> <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-03T22:01:05.963Z</app:edited> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/> <link rel="http://schemas.google.com/sites/2008#invite" type="text/html"href="domainName/siteName?invite=inviteToken"/> <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_invite%40example.com"/> <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_invite%40example.com"/> <gAcl:role value='writer'/> <gAcl:scope type='invite' value='new_invite%40example.com'/> </entry>
ग्रुप और डोमेन लेवल पर शेयर करना
किसी एक उपयोगकर्ता के साथ साइट शेयर करने की तरह ही, किसी Google ग्रुप या G Suite डोमेन के साथ भी साइट शेयर की जा सकती है. scope
की ज़रूरी वैल्यू यहां दी गई हैं.
किसी ग्रुप के ईमेल पते पर शेयर करने के लिए:
<gAcl:scope type="group" value="group@example.com"/>
पूरे डोमेन के साथ शेयर करना:
<gAcl:scope type="domain" value="example.com"/>
डोमेन लेवल पर शेयर करने की सुविधा, सिर्फ़ G Suite डोमेन के लिए उपलब्ध है. साथ ही, यह सिर्फ़ उस डोमेन के लिए उपलब्ध है जिस पर साइट होस्ट की गई है. उदाहरण के लिए, http://sites.google.com/a/domain1.com/siteA, पूरी साइट को सिर्फ़ domain1.com के साथ शेयर कर सकता है, domain2.com के साथ नहीं. G Suite डोमेन पर होस्ट नहीं की गई साइटें (जैसे, http://sites.google.com/site/siteB), डोमेन को न्योता नहीं दे सकतीं.
शेयर करने की अनुमतियों में बदलाव करना
एसीएल एंट्री को अपडेट करने के लिए, ज़रूरत के हिसाब से एंट्री में बदलाव करें और एंट्री के edit
लिंक पर एचटीटीपी PUT
अनुरोध जारी करें. यह लिंक सिर्फ़ एक <link>
एलिमेंट होता है, जिसका 'rel' एट्रिब्यूट 'बदलाव करें' पर सेट है. पिछले उदाहरण के लिए, वह लिंक यह है:
<link rel='edit' type='application/atom+xml' href='https://sites.google.com/feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com'/>
नीचे दिया गया स्निपेट, new_writer@gmail.com
की भूमिका को 'रीडर' में बदल देता है:
PUT /feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gAcl='http://schemas.google.com/acl/2007'> <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/acl/2007#accessRule'/> <gAcl:role value='reader'/> <gAcl:scope type='user' value='new_writer@gmail.com'/> </entry>
शेयर करने की अनुमतियां हटाना
इस उपयोगकर्ता की अनुमतियां हटाने के लिए, उसी edit
लिंक पर DELETE
अनुरोध जारी करें जिसका इस्तेमाल PUT
अनुरोध के लिए किया गया था:
DELETE /feeds/acl/site/domainName/siteName/user%3Anew_writer%40example.com HTTP/1.1 Host: sites.google.com GData-Version: 1.4 Authorization: <your authorization header here>
सर्वर 200 OK
के साथ जवाब देगा.
खास विषय
किसी फ़ीड या एंट्री को फिर से खोजना
अगर आपको पहले से मौजूद किसी फ़ीड या एंट्री को फिर से फ़ेच करना है, तो सर्वर को सिर्फ़ तब सूची या एंट्री भेजने के लिए कहें, जब पिछली बार फ़ेच करने के बाद उसमें बदलाव हुआ हो. इससे आपकी प्रोसेसिंग बेहतर हो सकती है.
इस तरह की शर्तों के साथ डेटा वापस पाने के लिए, एचटीटीपी GET
अनुरोध भेजें. इसमें एचटीटीपी If-None-Match
हेडर शामिल होना चाहिए. हेडर में, सूची या एंट्री का ETag डालें. यह आपको <feed>
एलिमेंट या <entry>
एलिमेंट के gd:etag
एट्रिब्यूट में मिलेगा.
साइट फ़ीड का इस्तेमाल करने का उदाहरण:
GET /feeds/site/domainName/myOtherTestSite/ GData-Version: 1.4 If-None-Match: W/"Ck8GQXk7fil7ImA9WxNSFk0."
जब सर्वर को यह अनुरोध मिलता है, तो वह यह जांच करता है कि आपने जिस आइटम का अनुरोध किया है उसका ETag, आपके दिए गए ETag से मेल खाता है या नहीं. अगर ईटैग मैच करते हैं, तो इसका मतलब है कि आइटम में कोई बदलाव नहीं हुआ है. साथ ही, सर्वर एचटीटीपी 304 Not Modified
स्टेटस कोड या एचटीटीपी 412 Precodition Failed
स्टेटस कोड दिखाता है. इन दोनों स्थिति कोड से पता चलता है कि आपने जो आइटम पहले ही वापस पा लिया है वह अप-टू-डेट है.
अगर ETag मेल नहीं खाते हैं, तो इसका मतलब है कि आखिरी बार अनुरोध करने के बाद, आइटम में बदलाव किया गया है. ऐसे में, सर्वर आइटम को दिखाता है.
ई-टैग के बारे में ज़्यादा जानकारी के लिए, Google Data API से जुड़ी रेफ़रंस गाइड देखें.
एक साथ कई फ़ाइलें प्रोसेस करना
बैच रिक्वेस्ट से आपके क्लाइंट को हर ऑपरेशन को अलग-अलग सबमिट करने के बजाय एक ही अनुरोध में कई ऑपरेशन करने की सुविधा मिलती है.
सर्वर, अनुरोध किए गए ज़्यादा से ज़्यादा बदलाव करेगा और स्थिति की जानकारी दिखाएगा. इस जानकारी का इस्तेमाल करके, हर कार्रवाई के पूरा होने या न होने का आकलन किया जा सकता है. Google Data API में बैच प्रोसेसिंग के बारे में ज़्यादा जानकारी के लिए, Google Data API की मदद से बैच प्रोसेसिंग देखें
बैच फ़ीड में मौजूद हर ऑपरेशन में <id> एलिमेंट होता है. हालांकि, शामिल करने के ऑपरेशन में यह एलिमेंट नहीं होता.
यह एलिमेंट, अनुरोध वाले उस यूआरएल जैसा ही होता है जिसका इस्तेमाल आम तौर पर, कॉन्टेंट फ़ीड को अपडेट करने, मिटाने या उससे क्वेरी करने के लिए किया जाता है.
उदाहरण के लिए, अगर आपको किसी बदलाव को अपडेट करना है, तो <id> को उस एंट्री के edit
लिंक पर सेट करें.
इसका इस्तेमाल, टारगेट एंट्री की पहचान करने के लिए किया जाता है. नई एंट्री में <id> एलिमेंट नहीं हैं, क्योंकि वे अभी तक नहीं बनाई गई हैं. इसके बजाय, आपके पास <batch:id> में स्ट्रिंग वैल्यू तय करने का विकल्प है. इसे सर्वर के रिस्पॉन्स में दिखाया जाएगा और इसका इस्तेमाल, इससे जुड़ी एंट्री को खोजने के लिए किया जाएगा.
बैच में अनुरोध करने के लिए, बैच फ़ीड बनाएं और फ़ीड के बैच के लिंक पर एक एचटीटीपी POST
भेजें:
<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="https://sites.google.com/feeds/content/site/siteName/batch"/>
यहां दिए गए उदाहरण में, वेबपेज की एंट्री के लिए क्वेरी करने, उसे डालने, अपडेट करने, और मिटाने का तरीका बताया गया है:
POST /feeds/content/site/siteName/batch HTTP/1.1 Host: sites.google.com Accept: */* If-Match: * GData-Version: 1.4 Authorization: <your authorization header here> <feed xmlns="http://www.w3.org/2005/Atom" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gd="http://schemas.google.com/g/2005" xmlns:batch='http://schemas.google.com/gdata/batch'> <entry> <id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID1</id> <batch:operation type="query"/> </entry> <entry> <batch:id>1</batch:id> <batch:operation type='insert'/> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>New Webpage1</title> <content type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml">HTML body goes here</div> </content> </entry> <entry gd:etag=""YDgpeyI.""> <id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID2</id> <batch:operation type='update'/> <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/> <title>Updated Title for Webpage2</title> ... <batch:operaation type="update"/> </entry> <entry gd:etag=""YassseyI.""> <id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID3</id> <batch:operation type='delete'/> </entry> </feed>
दिखाए गए फ़ीड में, हर कार्रवाई के लिए एक नतीजा होगा:
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006"
xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch"
xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
<id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID1</id>
<updated>2009-11-10T22:44:08.369Z</updated>
<title>Batch Feed</title>
<entry gd:etag=""YDgpsdfeyI."">
<id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID1</id>
<published>2009-08-31T04:42:45.251Z</published>
<updated>2009-10-25T22:46:13.729Z</updated>
<app:edited xmlns:app="http://www.w3.org/2007/app">2009-10-25T22:46:13.671Z</app:edited>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/sites/2008#webpage" label="webpage"/>
<title>Page Title</title>
...
<batch:status code="200" reason="Success"/>
<batch:operation type="query"/>
</entry>
<entry gd:etag=""YDsseyI."">
<id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID4</id>
<published>2009-11-10T22:44:08.531Z</published>
<updated>2009-11-10T22:44:08.560Z</updated>
<app:edited xmlns:app="http://www.w3.org/2007/app">2009-11-10T22:44:08.531Z</app:edited>
<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage" label="webpage"/>
<title>New Webpage1</title>
<content type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
<table cellspacing="0" class="sites-layout-name-one-column sites-layout-hbox">
<tbody>
<tr>
<td class="sites-layout-tile sites-tile-name-content-1">
<div>HTML body goes here</div>
</td>
</tr>
</tbody>
</table>
</div>
</content>
...
<batch:id>1</batch:id>
<batch:status code="201" reason="Created"/>
<batch:operation type="insert"/>
</entry>
<entry gd:etag=""YDkpeyI."">
<id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID2</id>
<updated>2009-11-10T22:44:09.296Z</updated>
<title>Updated Title for Webpage2</title>
...
<sites:pageName>updated-title-for-webpage2</sites:pageName>
<sites:revision>5</sites:revision>
<batch:status code="200" reason="Success"/>
<batch:operation type="update"/>
</entry>
<entry>
<id>https://sites.google.com/feeds/content/site/siteName/ENTRY_ID3</id>
<title>Deleted</title>
<content>Deleted</content>
<batch:status code="200" reason="Success"/>
<batch:operation type="delete"/>
</entry>
</feed>