कॉमन एलिमेंट: "Kinds"

सुविधा के बारे में जानकारी

यह अक्सर ऐसी सेवाओं के लिए उपयोगी होता है जो किसी खास तरह के आइटम के बारे में लगातार जानकारी देने के लिए, Google के डेटा एपीआई का इस्तेमाल करती हैं.

उदाहरण के लिए, Google डेटा एपीआई (या "GData") की कई सेवाएं, किसी व्यक्ति या संगठन की संपर्क जानकारी दे सकती हैं. ऐसी सभी सेवाओं के लिए, संपर्क जानकारी वाले एलिमेंट का एक ही सेट इस्तेमाल करना सही होता है.

किसी संपर्क के ऐसे एलिमेंट को एक साथ "काइंड" कहा जाता है जो मिलकर संपर्क के बारे में जानकारी देता है. संपर्क के कुछ एलिमेंट सामान्य ऐटम या आरएसएस एलिमेंट होते हैं. बाकी एलिमेंट, Google की तरफ़ से "Google डेटा नेमस्पेस" नाम के नेमस्पेस में तय किए जाते हैं. आम तौर पर, Google डेटा नेमस्पेस को एक्सएमएल कोड में, gd: उपनाम का इस्तेमाल करके रेफ़र किया जाता है; उदाहरण के लिए, टेलीफ़ोन या फ़ैक्स नंबर वाला एलिमेंट <gd:phoneNumber> है. Google डेटा नेमस्पेस के लिए स्कीमा यूआरएल, http://schemas.google.com/g/2005 है.

Google दूसरे तरह के इवेंट भी तय करता है: इवेंट (स्टैंडर्ड किए गए एलिमेंट का ऐसा संग्रह जो एक कैलेंडर इवेंट को एक साथ दिखाते हैं) और मैसेज (किसी ईमेल मैसेज, चर्चा समूह में पोस्ट करने या दूसरे मैसेज का प्रतिनिधित्व करने वाले एलिमेंट का संग्रह).

Google डेटा नेमस्पेस के कुछ एलिमेंट कई तरह के होते हैं. उदाहरण के लिए, <gd:who> एलिमेंट, किसी व्यक्ति (<gd:who> में बताए गए) को <gd:who> एलिमेंट वाली एंट्री से जोड़ता है. इस एलिमेंट का इस्तेमाल इवेंट टाइप में, आयोजकों, मेहमानों, वगैरह को तय करने के लिए किया जाता है. इसका इस्तेमाल मैसेज के प्रकार में, मैसेज भेजने वाले और भेजने वाले की जानकारी देने के लिए भी किया जाता है.

जब Google डेटा API फ़ीड में किसी प्रविष्टि में किसी खास प्रकार का उपयोग किया जाता है, तो उसमें <atom:category> होता है, जिसकी scheme विशेषता "http://schemas.google.com/g/2005#kind" पर सेट होती है और उसकी term विशेषता स्कीमा URL के नाम के बाद प्रकार के नाम पर सेट की जाती है. उदाहरण के लिए, संपर्क एंट्री में यह एलिमेंट शामिल होता है:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/g/2005#contact"/>

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

यह दस्तावेज़ कुछ सामान्य प्रकारों और उनमें शामिल एलिमेंट के बारे में जानकारी देता है.

डॉक्यूमेंट नहीं किए गए एलिमेंट

हम <atom:entry> के स्टैंडर्ड एलिमेंट के बारे में, उनके टाइप के बारे में जानकारी शामिल नहीं करते. उदाहरण के लिए, <atom:id>, <atom:published>, और <atom:updated> सभी के स्टैंडर्ड मतलब तब होते हैं, जब वे टाइप में दिखते हैं.

हम ऐटम के ऐसे स्टैंडर्ड एलिमेंट के बारे में भी जानकारी शामिल नहीं करते जो किसी खास संदर्भ में मायने नहीं रखते. उदाहरण के लिए, संपर्क के तौर पर <atom:summary> का इस्तेमाल नहीं किया जाता. हालांकि, एंट्री में <atom:author> का इस्तेमाल करना ज़रूरी है (बशर्ते, पैरंट फ़ीड में इसके बारे में बताया न गया हो), तो इसका मतलब 'संपर्क का प्रकार' से नहीं है.

प्रकार बनाए जा रहे हैं

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

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

विस्तार

इस दस्तावेज़ में दी गई जानकारी में सभी संभावित प्रॉपर्टी और एट्रिब्यूट टाइप की वैल्यू शामिल नहीं की गई हैं. सेवाएं कई तरह की हो सकती हैं. इसलिए, हो सकता है कि किसी खास सेवा में ऐसी प्रॉपर्टी और वैल्यू का इस्तेमाल किया जाए जो इस दस्तावेज़ में शामिल नहीं हैं.

टाइपोग्राफ़िक परंपराएं

इस दस्तावेज़ में दी गई टेबल में, हम ज़रूरी और वैकल्पिक एलिमेंट के लिए इन तरीकों का इस्तेमाल करते हैं:

ElementName ज़रूरी एलिमेंट
ElementName? वैकल्पिक एलिमेंट
ElementName* वैकल्पिक एलिमेंट, एक से ज़्यादा इंस्टेंस की अनुमति है

एलिमेंट और एट्रिब्यूट, स्टैंडर्ड XPath नोटेशन में दिखाए जाते हैं.

संपर्क का प्रकार

संपर्क को दर्शाता है: कोई व्यक्ति, क्लब या रेस्टोरेंट जैसे स्थान या संगठन.

कैटगरी एलिमेंट: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>

प्रॉपर्टी

प्रॉपर्टी ब्यौरा
atom:category* श्रेणियां. @label एट्रिब्यूट वाले इंस्टेंस को टैग माना जाता है. @scheme एट्रिब्यूट का इस्तेमाल करने से जुड़ी जानकारी के लिए, इस सेक्शन की शुरुआत में नोट देखें.
atom:content संपर्क के बारे में नोट.
atom:link* इससे जुड़ी जानकारी के लिंक. खास तौर पर, संपर्क की जानकारी देने वाले एचटीएमएल पेज से atom:link[@rel='alternate'] लिंक.
atom:title संपर्क का नाम.
gd:email* ईमेल पते.
gd:im* IM पते.
gd:phoneNumber* फ़ोन और फ़ैक्स नंबर.
gd:postalAddress* डाक पते.
gd:organization* चैनल मैनेज करना.
gd:extendedProperty* एक्सटेंडेड प्रॉपर्टी.
gContact:groupMembershipInfo* ग्रुप की सदस्यता की जानकारी.
gd:deleted* संपर्क जानकारी मिटाई गई.

उदाहरण

<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gd='http://schemas.google.com/g/2005'>
  <category scheme='http://schemas.google.com/g/2005#kind' 
      term='http://schemas.google.com/contact/2008#contact'/>
  <title>Elizabeth Bennet</title>
  <content>My good friend, Liz.  A little quick to judge sometimes, but nice girl.</content>
  <gd:email rel='http://schemas.google.com/g/2005#work' primary='true' address='liz@gmail.com'/>
  <gd:email rel='http://schemas.google.com/g/2005#home' address='liz@example.org'/>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work' primary='true'>
    (206)555-1212
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    (206)555-1213
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#mobile'>
    (206) 555-1212
  </gd:phoneNumber>
  <gd:im rel='http://schemas.google.com/g/2005#home' 
      protocol='http://schemas.google.com/g/2005#GOOGLE_TALK' 
      address='liz@gmail.com'/>
  <gd:postalAddress rel='http://schemas.google.com/g/2005#work' primary='true'>
    1600 Amphitheatre Pkwy 
    Mountain View, CA 94043
  </gd:postalAddress>
  <gd:postalAddress rel='http://schemas.google.com/g/2005#home'>
    800 Main Street
    Mountain View, CA 94041
  </gd:postalAddress>
  <gd:organization>
    <gd:orgName>Google, Inc.</gd:orgName>
    <gd:orgTitle>Tech Writer</gd:orgTitle>
  </gd:organization>
</entry>

इवेंट किस तरह का है

कैलेंडर इवेंट दिखाता है. इवेंट की जगह को <gd:where> एलिमेंट में एम्बेड किए गए (या इससे लिंक किए गए) संपर्क के टाइप से दिखाया जाता है; इवेंट के प्लानर और मेहमानों को <gd:who> एलिमेंट में एम्बेड किए गए (या लिंक किए गए) संपर्क के टाइप के तौर पर दिखाया जाता है.

कैटगरी एलिमेंट: <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>

प्रॉपर्टी

प्रॉपर्टी ब्यौरा
atom:author वह व्यक्ति जिसने यह इवेंट बनाया है.
atom:category* श्रेणियां. @label एट्रिब्यूट वाले इंस्टेंस को टैग माना जाता है. @scheme एट्रिब्यूट का इस्तेमाल करने से जुड़ी जानकारी के लिए, इस सेक्शन की शुरुआत में नोट देखें.
atom:content इवेंट की ज़्यादा जानकारी.
atom:link* लिंक. खास तौर पर, atom:link[@rel='alternate'] से उस एचटीएमएल पेज का लिंक मिलता है जिसमें इवेंट के बारे में जानकारी होती है.
atom:title इवेंट के लिए छोटा शीर्षक.
gd:comments? टिप्पणियां फ़ीड.
gd:eventStatus? विस्तार योग्य enum नीचे दर्ज किया गया है.
gd:recurrence? बार-बार होने का नियम.
gd:transparency? आरएफ़सी 2445 में बताई गई TRANSP प्रॉपर्टी के मुताबिक, एक्सटेंडेड enum दस्तावेज़ नीचे दिया गया है.
gd:visibility? विस्तार योग्य enum नीचे दर्ज किया गया है.
gd:when* ईवेंट समय. startTime और endTime, दोनों एट्रिब्यूट को सेट करना ज़रूरी है. हालांकि, पूरे दिन के इवेंट के लिए, ये एट्रिब्यूट सिर्फ़ तारीख के साथ सेट किए जाते हैं, समय की नहीं.
gd:when/gd:reminder* इवेंट के रिमाइंडर.
gd:where* इवेंट या आस-पास की ज़रूरी चीज़ों, जैसे कि पार्किंग की जगह. अगर फ़ीड लेवल पर <gd:where> एलिमेंट तय किया गया है, लेकिन एंट्री लेवल पर कोई <gd:where> एलिमेंट नहीं है, तो एंट्री फ़ीड लेवल <gd:where> वैल्यू इनहेरिट करती है.
gd:who* इवेंट से जुड़े लोग: आयोजक, मेहमान, स्पीकर, कलाकार वगैरह.
gd:who/gd:attendeeStatus? स्वीकार करने की स्थिति.
gd:who/gd:attendeeType? मेहमान का टाइप: required या optional.

gd:re के लिए rel मान

rel मान ब्यौरा
http://schemas.google.com/g/2005#event या मौजूद नहीं है. वह जगह जहां इवेंट होता है.
http://schemas.google.com/g/2005#event.alternate दूसरी जगह. उदाहरण के लिए, किसी रिमोट साइट पर मुख्य साइट के वीडियोकॉन्फ़्रेंस लिंक का इस्तेमाल किया गया हो.
http://schemas.google.com/g/2005#event.parking आस-पास मौजूद पार्किंग की जगह.

gd:eventStatus मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event.canceled इवेंट रद्द कर दिया गया है.
http://schemas.google.com/g/2005#event.confirmed इवेंट प्लान किया गया है.
http://schemas.google.com/g/2005#event.tentative इवेंट को सिर्फ़ अस्थायी तौर पर शेड्यूल किया गया है.

gd:दृश्यता मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event.confidential कुछ पाठकों को इवेंट देखने दें.
http://schemas.google.com/g/2005#event.default जिस कैलेंडर पर इवेंट दिखता है, उसके मालिक की पसंद से व्यवहार को इनहेरिट करें.
http://schemas.google.com/g/2005#event.private कम से कम पाठकों को इवेंट देखने की अनुमति दें.
http://schemas.google.com/g/2005#event.public ज़्यादातर पाठकों को इवेंट देखने की अनुमति दें.

gd:पारदर्शिता मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event.opaque यह बताता है कि इवेंट कैलेंडर पर समय लेता है; खाली/व्यस्त खोज में इवेंट समय को व्यस्त के रूप में चिह्नित किया जाएगा.
http://schemas.google.com/g/2005#event.transparent यह बताता है कि इवेंट कैलेंडर पर किसी भी समय इस्तेमाल नहीं होता. इवेंट को खाली/व्यस्त खोज के तौर पर मार्क नहीं किया जाएगा.

उदाहरण

मीटिंग:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
  <id>http://mycal.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
  <published>2005-01-18T21:00:00Z</published>
  <updated>2006-01-01T00:00:00Z</updated>
  <title>Discuss BazMat API</title>
  <content>We will discuss integrating GData with BazMat.</content>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <gd:when startTime='2005-01-18T21:00:00Z' endTime='2005-01-18T22:00:00Z'>
    <gd:reminder minutes='15'/>
  </gd:when>
  <gd:where valueString='Building 41, Room X'/>
  <gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
  <gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
  <gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>

ऑनलाइन इवेंट:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
  <id>http://mycal.example.com/feeds/jo/home/full/982307e797979879a</id>
  <published>2005-01-18T21:00:00Z</published>
  <updated>2006-01-01T00:00:00Z</updated>
  <title>Online Chess Tournament</title>
  <content/>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <gd:when startTime='2006-01-24T19:00:00-08:00' endTime='2006-01-24T20:00:00-08:00'>
    <gd:reminder minutes='15'/>
  </gd:when>
  <gd:where>
    <gd:entryLink>
      <entry>
        <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
        <id>http://contacts.example.com/jo/GamePhannz</id>
        <published>2005-01-18T21:00:00Z</published>
        <updated>2006-01-01T00:00:00Z</updated>
        <title>GamePhannz Online Game Server</title>
        <link rel="http://schemas.google.com/g/2005#onlineLocation" type="text/html" href="http://gamephannz.example.com/chess/138fd87e"/>
        <content/>
      </entry>
    </gd:entryLink>
  </gd:where>
  <gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
  <gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
  <gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>

मैसेज किस तरह का है

मैसेज दिखाता है, जैसे कि ईमेल, चर्चा समूह में पोस्ट करना या टिप्पणी.

कैटगरी एलिमेंट: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>

प्रॉपर्टी

प्रॉपर्टी ब्यौरा
atom:category* श्रेणियां. @label एट्रिब्यूट वाले इंस्टेंस को टैग माना जाता है. @scheme एट्रिब्यूट का इस्तेमाल करने से जुड़ी जानकारी के लिए, इस सेक्शन की शुरुआत में नोट देखें. @term एट्रिब्यूट का इस्तेमाल करने के बारे में जानकारी के लिए, यह टेबल देखें.
atom:content मैसेज का मुख्य हिस्सा.
atom:link* संदेश अटैचमेंट में जाते हैं. खास तौर से, अटैचमेंट अपलोड करने के लिए, <link rel="enclosure"> का इस्तेमाल करें और अटैचमेंट का कॉन्टेंट, ऐटम मीडिया कलेक्शन में रखें.
atom:title मैसेज का विषय.
gd:geoPt? वह भौगोलिक जगह जहां से मैसेज पोस्ट किया गया था.
gd:rating? क्वालिटी रेटिंग (ऐप्लिकेशन में दी गई जानकारी के हिसाब से).
gd:who* इस मैसेज से जुड़े लोग. सटीक सिमेंटिक @rel वैल्यू पर निर्भर करता है. नीचे दी गई टेबल देखें.

कैटगरी @term की वैल्यू

नीचे दी गई सभी कैटगरी, http://schemas.google.com/g/2005 स्कीम में हैं.

टर्म ब्यौरा
http://schemas.google.com/g/2005#message.chat यह मैसेज, चैट सेशन की ट्रांसक्रिप्ट है.
http://schemas.google.com/g/2005#message.inbox मैसेज को इनबॉक्स से जुड़े होने के तौर पर मार्क किया गया है.
http://schemas.google.com/g/2005#message.sent मैसेज को भेजा गया के तौर पर मार्क किया गया है.
http://schemas.google.com/g/2005#message.spam इस मैसेज को स्पैम माना जाएगा.
http://schemas.google.com/g/2005#message.starred मैसेज पर स्टार का निशान लगाया गया है.
http://schemas.google.com/g/2005#message.unread मैसेज नहीं पढ़ा गया है.

gd:who के लिए rel मान

प्रॉपर्टी ब्यौरा
http://schemas.google.com/g/2005#message.bcc ईमेल की गुप्त कॉपी.
http://schemas.google.com/g/2005#message.cc ईमेल की कॉपी भेज सकता है.
http://schemas.google.com/g/2005#message.from ईमेल (ईमेल या IM) भेजने वाला.
http://schemas.google.com/g/2005#message.reply-to जवाब देने वाले मैसेज का इंटेंट.
http://schemas.google.com/g/2005#message.to ईमेल पाने वाले का मुख्य व्यक्ति.

उदाहरण

ईमेल मैसेज:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message.sent"/>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <id>http://mymail.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
  <published>2006-01-18T21:00:00Z</published>
  <updated>2006-01-18T21:00:00Z</updated>
  <title>Re: Info?</title>
  <content>Hi, Fritz -- The information you're looking for is on p. 47.</content>
  <gd:who rel="http://schemas.google.com/g/2005#message.from">
    <gd:entryLink href="http://contacts.example.com/jo/Jo"/>
  </gd:who>
  <gd:who rel="http://schemas.google.com/g/2005#message.to">
    <gd:entryLink href="http://contacts.example.com/fritzb/FritzB"/>
  </gd:who>
</entry>

Google डेटा नेमस्पेस एलिमेंट रेफ़रंस

इस दस्तावेज़ के बाकी हिस्से में उन चीज़ों से जुड़ी पहचान सामग्री है जिनका इस्तेमाल किया जाता है.

Enums

कुछ एक्सटेंशन एलिमेंट में ऐसी प्रॉपर्टी डालने की ज़रूरत होती है जिनकी वैल्यू एक गिनती वाले सेट से आती है. इस तरह की प्रॉपर्टी का सामान्य रूप यह है:

<gd:propertyName value="propertyValue">

अगर प्रॉपर्टी की वैल्यू, Google डेटा नेमस्पेस से मिलती है, तो यह http://schemas.google.com/g/2005#{kind}.{value} रूप में होती है. उदाहरण के लिए: http://schemas.google.com/g/2005#event.tentative. अगर वैल्यू स्पेस मौजूद है, तो वैल्यू यूआरआई के रूप में भी हो सकती हैं. एक्सटेंडेड वैल्यू यूआरआई के लिए सुझाया गया फ़ॉर्म {schema यूआरआई}#{value} है. उदाहरण के लिए: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

सभी तरह के Google के लिए इस्तेमाल की जाने वाली सामान्य प्रॉपर्टी. ध्यान दें कि स्कीमा में anyAttribute और anyElement की मौजूदगी, सामान्य प्रॉपर्टी का इस्तेमाल करने वाले सभी Google डेटा नेमस्पेस को किसी भी नेमस्पेस में बढ़ाने की अनुमति देती है. खास तौर पर, किसी भी gd एलिमेंट या किसी भी gd एलिमेंट में कोई एटम/आरएसएस एलिमेंट नेस्ट करना कानूनी है. इसे सावधानी से इस्तेमाल करना चाहिए. ज़्यादातर मामलों में, इस तरह के इस्तेमाल को gd एलिमेंट वाले अश्लील डोमेन के तौर पर पेश किया जाना चाहिए.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@xml:base uri नेस्ट किए गए रिलेटिव यूआरआई के आधार की जानकारी देने के लिए स्टैंडर्ड एक्सएमएल कंस्ट्रक्शन.
@xml:lang text नेस्ट की गई स्ट्रिंग की भाषा.

स्कीमा

namespace gd = "http://schemas.google.com/g/2005"

gdCommonProperties = {
   atomCommonAttributes,
   anyAttribute*,
   (anyElement*)
}

gd:टिप्पणियां

इसमें होने वाली एंट्री के लिए टिप्पणी फ़ीड होती है (जैसे, कैलेंडर इवेंट).

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@rel? string टिप्पणियों में किस तरह की चीज़ें शामिल हैं. फ़िलहाल, सामान्य टिप्पणियों और समीक्षाओं के बीच अंतर होता है.
gd:feedLink? feedLink टिप्पणियां फ़ीड. इस फ़ीड को मैसेज के प्रकार में लागू करना चाहिए.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#regular या मौजूद नहीं है सामान्य टिप्पणियां (उपयोगकर्ताओं से).
http://schemas.google.com/g/2005#reviews पेशेवर समीक्षाएं.

उदाहरण

टिप्पणी फ़ीड:

<gd:comments>
  <gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
    <feed>
      <id>http://example.com/Jo/posts/MyFirstPost/comments</id>
      <title>My first post: comments</title>
      ...
      <entry>
         ...
         <content>Good post.</content>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>
</gd:comments>

समीक्षा फ़ीड:

<gd:comments rel="http://schemas.google.com/g/2005#reviews">
  <gd:feedLink href="http://example.com/restaurants/SanFrancisco/432432/reviews" countHint="25">
    <feed>
      <id>http://example.com/restaurants/SanFrancisco/432432/reviews</id>
      <title>La Folie reviews</title>
      ...
      <entry>
         ...
         <content>Good food.</content>
         <gd:rating value="5" min="1" max="5"/>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>
</gd:comments>

स्कीमा

start = comments

comments =
   element gd:comments {
      gdCommonProperties,
      attribute rel { xs:string }?,
      (feedLink?)
   }

gd:हटाया गया

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

प्रॉपर्टी

कोई नहीं.

स्कीमा

start = deleted

deleted =
   element gd:deleted

gd:ईमेल

शामिल इकाई (जो आम तौर पर किसी व्यक्ति या जगह को दिखाने वाली इकाई होती है) से जुड़ा ईमेल पता.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@address xs:string ईमेल पता.
@label? xs:string इस ईमेल पते को नाम देने के लिए इस्तेमाल किया गया एक सामान्य स्ट्रिंग मान. इसकी मदद से, यूज़र इंटरफ़ेस (यूआई) को "ऑफ़िस", "निजी", "पसंदीदा" वगैरह का लेबल दिखाने की अनुमति मिलती है.
@rel? xs:string एक प्रोग्रामेटिक मान जो ईमेल के प्रकार की पहचान करता है; विवरण के लिए नीचे देखें.
@primary? xs:boolean जब एक संपर्क प्रकार में कई ईमेल एक्सटेंशन दिखाई देते हैं, तो यह बताता है कि कौन सा प्राथमिक है. ज़्यादा से ज़्यादा एक ईमेल प्राथमिक हो सकता है. डिफ़ॉल्ट वैल्यू "false" है.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other ऐसा ईमेल पता जो न तो घर हो और न ही ऑफ़िस. असल टाइप दिखाने के लिए, label का इस्तेमाल किया जा सकता है.
http://schemas.google.com/g/2005#work

उदाहरण

<gd:email address="foo@bar.example.com"/>
<gd:email label="Personal" rel="http://schemas.google.com/g/2005#home" address="fubar@gmail.com" primary="true"/>

स्कीमा

start = email

email =
   element gd:email {
      attribute address { xs:string },
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:enterLink

तार्किक रूप से नेस्ट की गई एंट्री दिखाता है. उदाहरण के लिए, किसी संपर्क को दिखाने वाले <gd:who> को किसी संपर्क फ़ीड से नेस्ट की गई एंट्री मिल सकती है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@href? xs:string एंट्री यूआरआई के बारे में बताता है. अगर नेस्ट की गई एंट्री एम्बेड की गई है और लिंक नहीं की गई है, तो इस एट्रिब्यूट को हटाया जा सकता है.
@readOnly? xs:boolean इससे पता चलता है कि शामिल की गई एंट्री सिर्फ़ पढ़ने के लिए है या नहीं. डिफ़ॉल्ट वैल्यू "false" है.
@rel? xs:string यह लिंक संबंध के बारे में बताता है; इससे सेवा एक ही इकाई के लिए कई तरह के एंट्री लिंक दे पाती है. <atom:link> एलिमेंट के rel एट्रिब्यूट के जैसा सिमेंटिक और अनुमति वाली वैल्यू शामिल हैं.
atom:entry? atomEntry एंट्री का कॉन्टेंट.

ज़रूरी शर्तें

  • @href या <atom:entry> में से कोई एक या दोनों मौजूद होने चाहिए.
  • अगर atom:entry मौजूद नहीं है, तो क्लाइंट @href में एंट्री यूआरआई से कॉन्टेंट फ़ेच कर सकता है. अगर atom:entry मौजूद है, तो कॉन्टेंट वही होना चाहिए जो एंट्री बनाते समय @href से लिया जाएगा.
  • जब PUT या POST में <gd:entryLink> और @href एट्रिब्यूट शामिल होता है, तो लिंक बनाने के लिए एट्रिब्यूट की वैल्यू का इस्तेमाल किया जाता है. अगर atom:entry एलिमेंट भी मौजूद है, तो उसे अनदेखा कर दिया जाता है. अगर @href एट्रिब्यूट तय नहीं किया गया हो, तो atom:entry एलिमेंट को एम्बेड की गई एंट्री के तौर पर स्टोर किया जाता है या किसी दूसरी फ़ीड में स्टोर करके लिंक किया जाता है. ध्यान दें, हो सकता है कि कुछ सेवाएं इन सभी विकल्पों के साथ काम न करें.

उदाहरण

<gd:who> में मौजूद संपर्क जानकारी:

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo">
    <entry>
      <category scheme="http://schemas.google.com/g/2005#kind"
        term="http://schemas.google.com/g/2005#contact"/>
      <id>http://gmail.com/jo/contacts/Jo</id>
      <category term="user-tag" label="Google"/>
      <title>Jo March</title>
      <gd:email address="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

केवल बाहरी संदर्भ (केवल पढ़ने के लिए प्रविष्टि):

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo" readOnly="true"/>
</gd:who>

स्कीमा

start = entryLink

entryLink =
   element gd:entryLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      (atomEntry?)
   }

gd:extendedProperty

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

ध्यान दें कि anyForeignElement की मदद से, फ़ीड को gd:extendedProperty एलिमेंट में मान्य एक्सएमएल फ़ाइल को एम्बेड करने की सुविधा मिलती है. हालांकि, ऐसा सिर्फ़ value एट्रिब्यूट के साथ किया जा सकता है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@name xs:string इससे प्रॉपर्टी के नाम के बारे में पता चलता है. इसे यूआरआई के तौर पर दिखाया जाता है. आम तौर पर, एक्सटेंडेड प्रॉपर्टी यूआरआई {scheme}#{local-name} कन्वेंशन का पालन करते हैं.
@value? xs:string प्रॉपर्टी की वैल्यू.

उदाहरण

कैलेंडर इवेंट के लिए बाहरी आइडेंटिफ़ायर:

<gd:extendedProperty name="http://www.example.com/schemas/2007#mycal.id"
  value="1234"></gd:extendedProperty> 

संपर्क की जानकारी के लिए अतिरिक्त एक्सएमएल फ़ाइल

<gd:extendedProperty name="com.google">
  <some_xml>value</some_xml>
</gd:extendedProperty>

स्कीमा

start = extendedProperty

extendedProperty =
   element gd:extendedProperty {
      attribute name { xs:string },
      attribute value { xs:string } ?,
      (anyForeignElement*)
   }

gd:feedLink

तार्किक रूप से नेस्ट किए गए फ़ीड के बारे में बताता है. जैसे, कैलेंडर फ़ीड में, नेस्ट की गई फ़ीड हो सकती है, जो एंट्री पर की गई सभी टिप्पणियों को दिखाती हो.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@countHint? xs:unsignedInt फ़ीड में एंट्री की संख्या के बारे में संकेत. लागू होने के आधार पर, हो सकता है कि यह संख्या सटीक न हो.
@href? xs:string फ़ीड यूआरआई के बारे में बताता है. अगर नेस्ट किए गए फ़ीड को एम्बेड किया गया है और उसे लिंक नहीं किया गया है, तो इस एट्रिब्यूट को हटाया जा सकता है.
@readOnly? xs:boolean इससे पता चलता है कि शामिल फ़ीड सिर्फ़ पढ़ने के लिए है या नहीं.
@rel? xs:string लिंक संबंध तय करता है; सेवा किसी एक इकाई के लिए कई तरह के फ़ीड लिंक देने की सुविधा देती है. <atom:link> एलिमेंट के rel एट्रिब्यूट के जैसा सिमेंटिक और अनुमति वाली वैल्यू शामिल हैं.
atom:feed? atomFeed फ़ीड का कॉन्टेंट

ज़रूरी शर्तें

  • @href या <atom:feed> में से कोई एक या दोनों मौजूद होने चाहिए.
  • अगर atom:feed मौजूद नहीं है, तो क्लाइंट @href में यूआरआई से कॉन्टेंट फ़ेच कर सकता है. अगर वह मौजूद है, तो सामग्री वही होनी चाहिए जो फ़ीड जनरेट होने के समय @href से ली जाएगी.
  • जब किसी PUT या POST में <gd:feedLink> होता है और @href एट्रिब्यूट दिया जाता है, तो लिंक बनाने के लिए एट्रिब्यूट की वैल्यू का इस्तेमाल किया जाता है. अगर <atom:feed> एलिमेंट भी मौजूद है, तो उसे अनदेखा कर दिया जाता है. अगर @href एट्रिब्यूट तय नहीं किया गया है, तो <atom:feed> एलिमेंट को एम्बेड किए गए फ़ीड के तौर पर सेव किया जाता है. ध्यान दें, हो सकता है कि कुछ सेवाएं इन सभी विकल्पों के साथ काम न करें.

उदाहरण

ब्लॉगिंग:

<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
    <feed>
      <id>http://example.com/Jo/posts/MyFirstPost/comments</id>
      <title>My first post: comments</title>
      ...
      <entry>
         ...
         <content>Good post.</content>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>

सिर्फ़ बाहरी रेफ़रंस के लिए:

<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments"
            countHint="10"/>

ऐटम एंट्री में एम्बेड किया गया फ़ीड, जो सूची दिखाता है:

<gd:feedLink>
  <feed>
    <id>cid:1</id>
    <entry>
       <id>cid:1.1</id>
       <content>list item 1</content>
    </entry>
    <entry>
       <id>cid:1.2</id>
       <content>list item 2</content>
    </entry>
  </feed>
</gd:feedLink>

स्कीमा

start = feedLink

feedLink =
   element gd:feedLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      attribute countHint { xs:unsignedInt }?,
      (atomFeed?)
   }

gd:geoPt

भौगोलिक जगह (अक्षांश, देशांतर, ऊंचाई).

अब इस्तेमाल में नहीं है. यह एलिमेंट बंद कर दिया गया है. जियोटैगिंग डेटा के लिए, इसके बजाय GeoRSS का इस्तेमाल करें.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@elev? xs:float मीटर में ऊंचाई. नीचे दी गई वैल्यू से पता चलता है कि नीचे कितनी गहराई है.
@label? xs:string इस जगह का नाम रखने के लिए, इस्तेमाल की जाने वाली स्ट्रिंग की आसान वैल्यू. इसकी मदद से, यूज़र इंटरफ़ेस (यूआई) को "मौजूदा पोज़िशन" जैसा लेबल दिखाया जा सकता है.
@lat xs:float डिग्री में अक्षांश. पॉज़िटिव वैल्यू का मतलब है, उत्तर में नेगेटिव वैल्यू का मतलब है साउथ. रेंज [-90.0, 90.0] है.
@lon xs:float डिग्री में देशांतर. पॉज़िटिव वैल्यू का मतलब है पूर्व, नेगेटिव वैल्यू का मतलब पश्चिम है. रेंज [-180.0, 180.0] है.
@time? xs:dateTime टाइमस्टैंप.

उदाहरण

<gd:geoPt lat="40.75" lon="-74.0"/>
<gd:geoPt lat="27.98778" lon="86.94444" elev="8850.0"/>

स्कीमा

start = geoPt

geoPt =
   element gd:geoPt {
      attribute label { xs:string }?,
      attribute lat { xs:float },
      attribute lon { xs:float },
      attribute elev { xs:float }?,
      attribute time { xs:dateTime }?
   }

gd:im

शामिल इकाई से जुड़ा इंस्टैंट मैसेजिंग पता.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@address xs:string IM पता.
@label? xs:string इस IM पते को नाम देने के लिए इस्तेमाल किया गया एक सामान्य स्ट्रिंग वैल्यू. इसकी मदद से, यूज़र इंटरफ़ेस (यूआई) को "ऑफ़िस", "निजी", "पसंदीदा" वगैरह का लेबल दिखाने की अनुमति मिलती है.
@rel? xs:string एक प्रोग्राम के मुताबिक दी गई वैल्यू है, जो IM के प्रकार को पहचानती है. ज़्यादा जानकारी के लिए नीचे देखें.
@protocol? xs:string IM नेटवर्क की पहचान करता है. यह मान मानक मान (नीचे दिखाया गया) में से कोई एक हो सकता है या फिर मालिकाना IM नेटवर्क की पहचान करने वाला कोई यूआरआई हो सकता है.
@primary? xs:boolean जब संपर्क प्रकार में कई IM एक्सटेंशन दिखाई देते हैं, तो यह बताता है कि कौन-सा IM एक्सटेंशन प्राथमिक है. ज़्यादा से ज़्यादा एक IM प्राथमिक हो सकता है. डिफ़ॉल्ट वैल्यू "false" है.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other IM पता जो न तो घर, न ही ऑफ़िस. असल टाइप दिखाने के लिए, label का इस्तेमाल किया जा सकता है.
http://schemas.google.com/g/2005#work

प्रोटोकॉल विशेषता मान

यहां दी गई टेबल में, @policy एट्रिब्यूट के लिए संभावित वैल्यू दी गई हैं.

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#AIM AOL Instant Messenger का प्रोटोकॉल
http://schemas.google.com/g/2005#MSN MSN मैसेंजर प्रोटोकॉल
http://schemas.google.com/g/2005#YAHOO Yahoo Messenger का प्रोटोकॉल
http://schemas.google.com/g/2005#SKYPE Skype प्रोटोकॉल
http://schemas.google.com/g/2005#QQ क्यूक्यू प्रोटोकॉल
http://schemas.google.com/g/2005#GOOGLE_TALK Google टॉक प्रोटोकॉल
http://schemas.google.com/g/2005#ICQ ICQ प्रोटोकॉल
http://schemas.google.com/g/2005#JABBER Jabber प्रोटोकॉल

उदाहरण

MSN मैसेंजर के लिए IM पता:

<gd:im protocol="http://schemas.google.com/g/2005#MSN" address="foo@bar.msn.com" rel="http://schemas.google.com/g/2005#home" primary="true"/>

अनिर्दिष्ट प्रोटोकॉल वाला उपयोगकर्ता का IM पता. ऐसा पता डिसप्ले करने के लिए अच्छा होता है, लेकिन प्रोग्राम की मदद से इसे मैनेज करना मुश्किल होता है.

<gd:im label="Other" address="foo@baz.example.com"/>

स्कीमा

start = im

im =
   element gd:im {
      attribute address { xs:string },
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute protocol { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:संगठन

एक संगठन, जो आम तौर पर किसी संपर्क से जुड़ा होता है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@label? xs:string इस संगठन को नाम देने के लिए, एक आसान स्ट्रिंग वैल्यू. इसकी मदद से, यूज़र इंटरफ़ेस (यूआई) को "ऑफ़िस", "वॉलंटियर", "प्रोफ़ेशनल सोसाइटी" वगैरह का लेबल दिखाने की अनुमति मिलती है.
@rel? xs:string एक प्रोग्रामैटिक वैल्यू, जो संगठन के प्रकार की पहचान करती है.
@primary? xs:boolean जब संपर्क प्रकार में कई संगठन एक्सटेंशन दिखाई देते हैं, तो यह बताता है कि कौन सा प्राथमिक है. ज़्यादा से ज़्यादा एक संगठन प्राथमिक हो सकता है. डिफ़ॉल्ट वैल्यू "false" है.
gd:orgName? orgName संगठन का नाम.
gd:orgTitle? orgTitle संगठन के किसी व्यक्ति का शीर्षक.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#other वह संगठन जो काम नहीं करता है. असल टाइप दिखाने के लिए, label का इस्तेमाल किया जा सकता है.
http://schemas.google.com/g/2005#work

उदाहरण

<gd:organization rel="http://schemas.google.com/g/2005#work" label="Work" primary="true"/>
  <gd:orgName>Google, Inc.</gd:orgName>
  <gd:orgTitle>Tech Writer</gd:orgTitle>
</gd:organization>

स्कीमा

start = organzation

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
      orgName?,
      orgTitle?,
   }

gd:orgName

संगठन का नाम. gd:organization एलिमेंट में दिखना चाहिए.

उदाहरण

<gd:orgName>Google, Inc.</gd:orgName>

स्कीमा

start = orgName

orgName =
   element gd:orgName { xs:string }

gd:orgTitle

किसी संगठन में मौजूद व्यक्ति का शीर्षक. gd:organization एलिमेंट में दिखना चाहिए.

उदाहरण

<gd:orgTitle>President and CEO</gd:orgTitle>

स्कीमा

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:originalEvent

आरएफ़सी 2445 के सेक्शन 4.8.4.4 में बताई गई बार-बार होने वाली आईडी प्रॉपर्टी के बराबर. मूल इवेंट की पहचान करने के लिए, यह बार-बार होने वाले इवेंट के हर इंस्टेंस में दिखता है.

इसमें एक <gd:when> एलिमेंट होता है. यह इंस्टेंस के शुरू होने के उस समय के बारे में बताता है जो अब अपवाद बन चुका है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@id xs:string मूल इवेंट का इवेंट आईडी.
@href xs:string मूल इवेंट के लिए इवेंट फ़ीड यूआरएल.

उदाहरण

मूल इवेंट के बारे में बताना:

<gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg"

href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID">
  <gd:when startTime="2006-03-17T22:00:00.000Z"/>
</gd:originalEvent>

स्कीमा

start = originalEvent

originalEvent =
   element gd:originalEvent {
      attribute id { xs:string },
      attribute href { xs:string },
      when
   }

gd:फ़ोन नंबर

शामिल इकाई (जो आम तौर पर किसी व्यक्ति या जगह को दिखाने वाली इकाई होती है) से जुड़ा फ़ोन नंबर.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@label? xs:string इस फ़ोन नंबर को नाम देने के लिए, इस्तेमाल की जाने वाली स्ट्रिंग की आसान वैल्यू. ज़्यादातर मामलों में, @label ज़रूरी नहीं होता, क्योंकि @rel खास तौर पर किसी नंबर की पहचान करता है और यूआई को सही लेबल दिखाने की अनुमति देता है. उदाहरण के लिए, "मोबाइल", "घर", "ऑफ़िस" वगैरह. हालांकि, एक व्यक्ति के पास कई मोबाइल फ़ोन होने पर, उन्हें पहचानने के लिए इस प्रॉपर्टी का इस्तेमाल किया जा सकता है.
@rel? xs:string एक प्रोग्रामेटिक वैल्यू, जिससे पता चलता है कि फ़ोन नंबर किस तरह का है. ज़्यादा जानकारी के लिए नीचे देखें.
@uri? xs:string वीओआईपी/पीएसटीएन ब्रिज जैसे प्रोग्राम के हिसाब से, अपने नंबर को औपचारिक रूप से दिखाने के लिए, "टेल यूआरआई" इस्तेमाल किया जाता है. टेलीफ़ोन यूआरआई के बारे में ज़्यादा जानकारी के लिए आरएफ़सी 3966 देखें.
@primary? xs:boolean जब किसी संपर्क के प्रकार में कई फ़ोन नंबर एक्सटेंशन दिखाई देते हैं, तो इससे पता चलता है कि कौनसा प्राथमिक संपर्क है. ज़्यादा से ज़्यादा एक फ़ोन नंबर प्राथमिक हो सकता है. डिफ़ॉल्ट वैल्यू "false" है.
text() xs:string जिसे लोग पढ़ सकें, वे किसी भी टेलीफ़ोन नंबर फ़ॉर्मैट में हो सकते हैं. आगे और पीछे की खाली सफ़ेद जगह बहुत कम होती है. स्ट्रिंग में मौजूद नई लाइनें भी ज़रूरी नहीं होती हैं. साथ ही, स्ट्रिंग को एक ही जगह से हटाया या समतल किया जा सकता है.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#fax
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#home_fax
http://schemas.google.com/g/2005#mobile
http://schemas.google.com/g/2005#other एक खास तरह का नंबर, जिसके लिए rel की कोई अन्य वैल्यू सही नहीं होती है. उदाहरण के लिए, एक टेलीटाइपराइटर (टीटीवाई) डिवाइस. असल टाइप दिखाने के लिए, label का इस्तेमाल किया जा सकता है.
http://schemas.google.com/g/2005#pager
http://schemas.google.com/g/2005#work
http://schemas.google.com/g/2005#work_fax

उदाहरण

उपयोगकर्ता का दिया गया फ़ोन नंबर:

<gd:phoneNumber>(425) 555-8080 ext. 72585</gd:phoneNumber>

किसी डायरेक्ट्री से लिया गया फ़ोन नंबर

<gd:phoneNumber rel="http://schemas.google.com/g/2005#work" uri="tel:+1-425-555-8080;ext=52585">
  (425) 555-8080 ext. 52585
</gd:phoneNumber>

लेबल वाली संख्या:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212">
  +1 206 555 1212
</gd:phoneNumber>

स्कीमा

start = phoneNumber

phoneNumber =
   element gd:phoneNumber {
      attribute rel { xs:string }?,
      attribute label { xs:string }?,
      attribute uri { xs:string }?,
      attribute primary { xs:boolean }?,
      (xs:string)
   }

gd:postalAddress

एक डाक पता.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@label? xs:string इस पते को नाम देने के लिए इस्तेमाल किया जाने वाला एक आसान स्ट्रिंग मान.
@rel? xs:string यह एक प्रोग्रामेटिक वैल्यू होती है, जिससे पता चलता है कि पिन किस तरह का है. ज़्यादा जानकारी के लिए नीचे देखें.
@primary? xs:boolean जब किसी संपर्क के प्रकार में एक से ज़्यादा डाक पते के एक्सटेंशन दिखते हैं, तो यह बताता है कि कौनसा प्राथमिक पता है. ज़्यादा से ज़्यादा एक डाक पता प्राथमिक हो सकता है. डिफ़ॉल्ट वैल्यू "false" है.
text() xs:string टेक्स्ट के रूप में पता. आगे और पीछे की खाली सफ़ेद जगह बहुत कम होती है. स्ट्रिंग में नई लाइनें अहम हैं.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other घर और ऑफ़िस का पता. असल टाइप दिखाने के लिए, label का इस्तेमाल किया जा सकता है.
http://schemas.google.com/g/2005#work

उदाहरण

<gd:postalAddress>
  500 West 45th Street
  New York, NY 10036
</gd:postalAddress>

स्कीमा

start = postalAddress

postalAddress =
   element gd:postalAddress {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      (xs:string)
   }

gd:रेटिंग

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

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@average? xs:float औसत रेटिंग.
@max xs:int रेटिंग स्केल का ज़्यादा से ज़्यादा मान.
@min xs:int रेटिंग स्केल का कम से कम मान.
@numRaters? xs:int औसत मूल्य की गणना करते समय विचार की गई रेटिंग की संख्या.
@rel? xs:string रेटिंग का आसपेक्ट रेशियो (चौड़ाई-ऊंचाई का अनुपात) तय करता है. अगर रेटिंग नहीं दी गई है, तो इसे कुल रेटिंग कहा जाता है.
@value? xs:int रेटिंग की वैल्यू.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#overall या मौजूद नहीं है कुल रेटिंग. ज़्यादा वैल्यू का मतलब है कि बेहतर रेटिंग.
http://schemas.google.com/g/2005#price कीमत की रेटिंग. ज़्यादा वैल्यू का मतलब है, ज़्यादा कीमतें.
http://schemas.google.com/g/2005#quality क्वालिटी रेटिंग. ज़्यादा वैल्यू का मतलब है, बेहतर क्वालिटी.

उदाहरण

कुल रेटिंग: 4/5

<gd:rating value="4" min="1" max="5"/>

सबसे महंगी कीमत सीमा रेटिंग:

<gd:rating rel="http://schemas.google.com/g/2005#price" value="5" min="1" max="5"/>

5 में से 4.65 की औसत रेटिंग के साथ 200 उपयोगकर्ताओं से रेट किया गया:

<gd:rating average="4.65" min="1" max="5" numRaters="200"/>

स्कीमा

start = rating

rating =
   element gd:rating {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute value { xs:int }?,
      attribute average { xs:float }?,
      attribute min { xs:int },
      attribute max { xs:int },
      attribute numRaters { xs:int }?
   }

gd:बार-बार होने वाला

उन तारीखों और समय के बारे में बताता है जब कोई बार-बार होने वाला इवेंट होता है.

बार-बार होने वाली स्ट्रिंग में, प्रॉपर्टी का एक सेट होता है. इनमें से हर प्रॉपर्टी, iCalendar स्टैंडर्ड (आरएफ़सी 2445) में बताई जाती है.

खास तौर पर, स्ट्रिंग आम तौर पर, एक DTSTART प्रॉपर्टी से शुरू होती है, जो इवेंट के पहले इंस्टेंस के शुरू होने के समय की जानकारी देती है. अक्सर यह एक DTEND प्रॉपर्टी या एक DURATION प्रॉपर्टी से शुरू होती है, जो बताती है कि पहला इंस्टेंस कब खत्म होता है. इसके बाद, Rनियम, RDATE, EX नियम, और/या EXDATE प्रॉपर्टी आती हैं, जो बार-बार होने वाले इवेंट और उसके अपवादों को बताती हैं (लेकिन नीचे देखें). (बार-बार दोहराए जाने वाले इन कॉम्पोनेंट के बारे में ज़्यादा जानकारी के लिए, आरएफ़सी 2445 का सेक्शन 4.8.5 देखें.) पिछली बार, V प्रॉपर्टी कॉम्पोनेंट दिखता है. इसमें पिछली प्रॉपर्टी में बताए गए किसी भी समय क्षेत्र आईडी के लिए, समय क्षेत्र की पूरी जानकारी दी जाती है.

Google कैलेंडर जैसी Google की सेवाएं, बार-बार होने वाले इवेंट के अपवाद को दिखाने के लिए आम तौर पर EX नियम और EXDATE प्रॉपर्टी जनरेट नहीं करती हैं. इसके बजाय, ये <gd:recurrenceException> एलिमेंट जनरेट करती हैं. हालांकि, Google की सेवाओं में फिर भी EX नियम और/या EXDATE प्रॉपर्टी शामिल हो सकती हैं; उदाहरण के लिए, उपयोगकर्ता कैलेंडर में इवेंट और अपवाद इंपोर्ट कर सकते हैं और अगर उन इंपोर्ट किए गए इवेंट में EX नियम या EXDATE प्रॉपर्टी शामिल हैं, तो 'कैलेंडर' <gd:recurrence> प्रॉपर्टी भेजने पर उन प्रॉपर्टी की जानकारी देगा.

ध्यान दें कि <gd:recurrenceException> के इस्तेमाल का मतलब यह नहीं है कि <gd:recurrence> एलिमेंट की जांच करके, यह पक्का किया जा सकता है कि दोहराए जाने वाले ब्यौरे में कोई अपवाद है या नहीं. यह पक्का करने के लिए कि आपको सभी अपवाद मिल जाएं, फ़ीड में <gd:recurrenceException> एलिमेंट ढूंढें और उनके <gd:originalEvent> एलिमेंट का इस्तेमाल करें, ताकि उनका मिलान <gd:recurrence> एलिमेंट से किया जा सके.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
text() xs:string बार-बार होने वाला ब्यौरा.

उदाहरण

हर सुबह 6:00 से 7:00 बजे तक, एक बार-बार होने वाला इवेंट पैसिफ़िक समय: 14 मार्च से 21 मार्च, 2006 तक:

<gd:recurrence>
  DTSTART;TZID=America/Los_Angeles:20060314T060000
  DURATION:PT3600S
  RRULE:FREQ=DAILY;UNTIL=20060321T220000Z
  BEGIN:VTIMEZONE
  TZID:America/Los_Angeles
  X-LIC-LOCATION:America/Los_Angeles
  BEGIN:STANDARD
  TZOFFSETFROM:-0700
  TZOFFSETTO:-0800
  TZNAME:PST
  DTSTART:19671029T020000
  RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
  END:STANDARD
  BEGIN:DAYLIGHT
  TZOFFSETFROM:-0800
  TZOFFSETTO:-0700
  TZNAME:PDT
  DTSTART:19870405T020000
  RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU
  END:DAYLIGHT
  END:VTIMEZONE
</gd:recurrence>

स्कीमा

start = recurrence

recurrence =
   element gd:recurrence {
      (xs:string)
   }

gd:बार-बार होने वाला अपवाद

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

इसमें एक <gd:originalEvent> एलिमेंट शामिल होता है. इस इवेंट में, ओरिजनल इवेंट के बारे में बताया जाता है कि यह एक अपवाद है.

बार-बार होने वाले किसी इवेंट के इंस्टेंस में बदलाव करने पर, उसे अपवाद माना जाता है. आपके किए गए बदलाव के आधार पर, अपवाद उन दो अलग-अलग तरीकों से काम करता है जब मूल बार-बार होने वाले इवेंट में बदलाव किया जाता है:

  • अगर आपने टिप्पणी, मेहमानों या मेहमानों के जवाबों को जोड़ा, बदला या हटाया है, तो मूल इवेंट पर अपवाद लागू होगा. साथ ही, मूल इवेंट में किए गए बदलाव भी इस अपवाद में बदलाव कर देंगे.
  • अगर अपवाद में कोई दूसरा बदलाव किया जाता है (जैसे कि समय या जगह बदलना), तो इंस्टेंस "खास" हो जाता है, जिसका मतलब है कि अब यह मूल इवेंट से ज़्यादा मज़बूती से जुड़ा नहीं है. मूल इवेंट को बदलने पर, खास अपवादों में कोई बदलाव नहीं होता. लेकिन नीचे देखें.

उदाहरण के लिए, मान लें कि आपकी मीटिंग हर मंगलवार और गुरुवार को दोपहर 2 बजे की है. अगर आप इस गुरुवार की मीटिंग के लिए हाज़िरी की सूची बदलते हैं (न कि नियमित रूप से शेड्यूल की गई मीटिंग के लिए), तो यह एक अपवाद बन जाती है. अगर आप इस गुरुवार की मीटिंग के लिए समय बदलते हैं (लेकिन नियमित रूप से शेड्यूल की गई मीटिंग के लिए नहीं), तो यह खास तौर पर हो जाता है.

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

उदाहरण के लिए, इस गुरुवार की मीटिंग में शामिल होने के बाद, मान लें कि आप सोमवार, बुधवार, और शुक्रवार को होने वाली बार-बार होने वाली मीटिंग में बदलाव करते हैं. इस बदलाव से मंगलवार/गुरुवार की मीटिंग के सभी दोहराव वाले इंस्टेंस मिटा दिए जाते हैं. इनमें विशेषज्ञ की बनाई गई मीटिंग भी शामिल है.

अगर बार-बार होने वाले इवेंट का कोई खास इंस्टेंस मिटाया जाता है, तो वह इंस्टेंस <gd:recurrenceException> के तौर पर दिखता है. इसमें <gd:entryLink> होता है और इसका <gd:eventStatus>, "http://schemas.google.com/g/2005#event.canceled" पर सेट होता है. (रद्द किए गए इवेंट के बारे में ज़्यादा जानकारी के लिए, RFC 2445 देखें.)

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@specialized xs:boolean इससे पता चलता है कि अपवाद विशेषज्ञ हैं या नहीं.
gd:entryLink entryLink अपवाद के बारे में जानकारी देने वाली इवेंट एंट्री.
gd:originalEvent originalEvent बार-बार होने वाला मूल इवेंट, जिसका यह अपवाद है.

उदाहरण

बार-बार होने वाले इवेंट का अपवाद (साफ़ तौर पर जानकारी देने के लिए, कुछ हिस्सों को छोटे इटैलिक आइडेंटिफ़ायर से बदला गया है):

<gd:recurrenceException specialized="true">
  <gd:entryLink>
    <entry>
      <id>i8fl1nrv2bl57c1qgr3f0onmgg_20060317T220000Z</id>
      <published>2006-03-17T23:00:00.000Z</published>
      <updated>2006-03-14T21:33:12.000Z</updated>
      <category scheme="http://schemas.google.com/g/2005#kind"
        term="http://schemas.google.com/g/2005#event"/>
      <title type="text">recurrence</title>
      <content type="text"/>
      <link rel="alternate" type="text/html"
        href="http://www.google.com/calendar/event?eid=idString"
        title="alternate"/>
      <author>
        <name>exception</name>
      </author>
      <gd:eventStatus
        value="http://schemas.google.com/g/2005#event.confirmed"/>
      <gd:comments>
        <gd:feedLink
            href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/">
          <feed>
            <updated>2006-03-14T21:36:23.250Z</updated>
            <title type="text">Comments for: recurrence</title>
            <link rel="alternate" type="text/html"
              href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/"
              title="alternate"/>
          </feed>
        </gd:feedLink>
      </gd:comments>
      <gd:transparency
        value="http://schemas.google.com/g/2005#event.opaque "/>
      <gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg"
          href="http://www.google.com/calendar/feeds/userID/private-magicCookie/composite/eventID">
        <gd:when startTime="2006-03-17T22:00:00.000Z"/>
      </gd:originalEvent>
      <gd:where valueString="Home"/>
      <gd:when startTime="2006-03-17T23:00:00.000Z"
        endTime="2006-03-18T00:00:00.000Z"/>
    </entry>
  </gd:entryLink>
</gd:recurrenceException>

स्कीमा

start = recurrenceException

recurrenceException =
   element gd:recurrenceException {
      attribute specialized { xs:boolean },
      (entryLink
       & originalEvent)
   }

gd:रिमाइंडर

ज़्यादातर इस्तेमाल किया गया: <gd:when>

समय का अंतराल, जिसमें यह बताया गया होता है कि शामिल इकाई के @startTime या @dueTime एट्रिब्यूट से पहले कितनी देर तक रिमाइंडर जारी किया जाना चाहिए. इसके अलावा, हम यह भी बता सकते हैं कि रिमाइंडर कब देना है. इसमें, सूचना का तरीका भी बताया जाता है. इससे पता चलता है कि उपयोगकर्ता को याद दिलाने के लिए, सिस्टम को किस मीडियम का इस्तेमाल करना चाहिए.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@absoluteTime? xs:dateTime रिमाइंडर जारी किए जाने का कुल समय. इसका इस्तेमाल आम तौर पर तब किया जाता है, जब कोई उपयोगकर्ता पिछले रिमाइंडर को आगे बढ़ाने के लिए, "स्नूज़ करें" सुविधा का इस्तेमाल करता है. अगर समय क्षेत्र की जानकारी न दी गई हो, तो ऑब्ज़र्वर का स्थानीय समय माना जाता है.
@method? xs:string रिमाइंडर पाने के लिए, सूचना के तरीके का इस्तेमाल करें. इनमें से कोई भी मान हो सकता है: alert (जब कोई उपयोगकर्ता ब्राउज़र में कैलेंडर देख रहा हो, तो चेतावनी दिखाई दे सकती है), email (उपयोगकर्ता को ईमेल संदेश भेजता है) या sms (उपयोगकर्ता को SMS टेक्स्ट संदेश भेजता है).
@days? xs:unsignedInt रिमाइंडर जारी किए जाने से पहले की समयावधि gd:when/@startTime से पहले की है. अगर पैरंट इकाई का टारगेट समय किसी खास समय के बजाय तारीख है, तो ये विशेषताएं उस तारीख की मध्यरात्रि (00:00) के हिसाब से होती हैं.
@hours? xs:unsignedInt
@minutes? xs:unsignedInt

जब आप <gd:when> एंट्री बनाते हैं या उसमें बदलाव करते हैं, तो खास नतीजे पाने के लिए ये तरीके अपनाएं:

  • सेवा को उपयोगकर्ता के डिफ़ॉल्ट रिमाइंडर इस्तेमाल करने की जानकारी देने के लिए, <gd:reminder> एलिमेंट में कोई एट्रिब्यूट शामिल न करें. अगर आप कोई अवधि तय करते हैं, लेकिन method विशेषता का नहीं, तो सेवा आपकी बताई गई अवधि के साथ उपयोगकर्ता के डिफ़ॉल्ट सूचना तरीकों का इस्तेमाल करती है.
  • सेवा को यह बताने के लिए कि इवेंट के लिए कोई भी रिमाइंडर जारी न किया जाए या किसी इवेंट को अपडेट करते समय मौजूदा रिमाइंडर हटाने के लिए, कोई भी <gd:reminder> एलिमेंट शामिल न करें.

ज़रूरी शर्तें

  • ज़्यादा से ज़्यादा @days, @hours, @minutes या @absoluteTime की जानकारी दी जा सकती है. मिली-जुली अवधि के लिए, सबसे सटीक यूनिट में बदलें. उदाहरण के लिए, 1 घंटा 30 मिनट तय करने के लिए, @minutes="90" का इस्तेमाल करें.
  • आप एट्रिब्यूट के लिए नेगेटिव वैल्यू का इस्तेमाल नहीं कर सकते. इसलिए, अगर आपको शुरुआत के समय के बाद रिमाइंडर चाहिए, तो आपको @absoluteTime का इस्तेमाल करना होगा.
  • किसी दिए गए इवेंट के साथ पांच से ज़्यादा रिमाइंडर नहीं जोड़े जा सकते.
  • किसी इवेंट में रिमाइंडर जोड़ते समय, alert, email या sms मैथड को शामिल करने के लिए, आपको एक अवधि भी बतानी होगी.

उदाहरण

मीटिंग के लिए 15 मिनट का रिमाइंडर:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00">
  <gd:reminder minutes="15"/>
</gd:when>

यह वही मीटिंग है जो ऊपर की है, लेकिन रिमाइंडर के बाद 16:45 पर 10 मिनट के लिए स्नूज़ किया गया:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00">
  <gd:reminder minutes="15"/>
  <gd:reminder absoluteTime="2005-06-06T16:55:00-08:00"/>
</gd:when>

स्कीमा

start = reminder

reminder =
   element gd:reminder {
      gdCommonProperties,
      attribute absoluteTime { xs:dateTime }?,
      attribute method { xs:string }?,
      attribute days { xs:unsignedInt }?,
      attribute hours { xs:unsignedInt }?,
      attribute minutes { xs:unsignedInt }?
   }

gd:संसाधन आईडी

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

उदाहरण

<gd:resourceId>9749638</gd:resourceId>

स्कीमा

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:कब

यह खाली समय या इंस्टैंट को दिखाता है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@endTime? xs:dateTime या xs:date इवेंट के खत्म होने के बारे में जानकारी. अगर समय क्षेत्र की जानकारी न दी गई हो, तो ऑब्ज़र्वर का स्थानीय समय क्षेत्र माना जाता है.
@startTime xs:dateTime या xs:date यह इवेंट के शुरू होने या शून्य-अवधि के इवेंट के होने के बारे में बताता है. अगर समय क्षेत्र की जानकारी न दी गई हो, तो ऑब्ज़र्वर का स्थानीय समय क्षेत्र माना जाता है.
@valueString? xs:string एक आसान स्ट्रिंग वैल्यू, जिसका इस्तेमाल इस समयावधि को दिखाने के लिए किया जा सकता है.

ज़रूरी शर्तें

  • startTime/endTime में xs:dateTime को xs:date में नहीं बदला जा सकता.
  • अगर endTime के बारे में नहीं बताया गया है, तो इवेंट को इंस्टैंट टाइम (अगर @startTime में समय शामिल है) या एक दिन का इवेंट (अगर @startTime सिर्फ़ तारीख है) माना जाता है.

उदाहरण

एक दिन का इवेंट:

<gd:when startTime="2005-06-06"/>

एक दिन के इवेंट को दिखाने के लिए, यह तरीका अपनाएं:

<gd:when startTime="2005-06-06" endTime="2005-06-07"/>

स्ट्रिंग की जानकारी के साथ दो दिन का इवेंट (6 जून और 7 जून को):

<gd:when startTime="2005-06-06" endTime="2005-06-08" valueString="This weekend"/>

एक घंटे की मीटिंग:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"/>

शून्य-अवधि वाला इवेंट:

<gd:when startTime="2005-06-06T17:00:00-08:00"/>

स्कीमा

start = when

when =
   element gd:when {
      gdCommonProperties,
      attribute startTime { (xs:date | xs:dateTime) },
      attribute endTime { (xs:date | xs:dateTime) }?,
      attribute valueString { xs:string }?
   }

gd:कहां

शामिल करने वाली इकाई से जुड़ा कोई स्थान (जैसे कि इवेंट का स्थान). असोसिएशन किस तरह की है, यह rel एट्रिब्यूट से तय होता है. जगह की जानकारी, एम्बेड की गई या लिंक की गई संपर्क एंट्री में दी जाती है.

<gd:where> एलिमेंट, <gd:geoPt> एलिमेंट की तुलना में ज़्यादा सामान्य होता है. पूर्व टेक्स्ट टेक्स्ट वर्णन और/या संपर्क प्रविष्टि का उपयोग करके किसी स्थान की पहचान करता है, जबकि बाद वाला किसी विशिष्ट भौगोलिक स्थान का उपयोग करके स्थान की पहचान करता है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@label? xs:string इस जगह को दूसरी जगहों से अलग करने के लिए उपयोगकर्ता के पढ़ने लायक लेबल तय करता है.
@rel? xs:string शामिल इकाई और शामिल स्थान के बीच का संबंध बताता है. संभावित वैल्यू (नीचे देखें) अन्य एलिमेंट से तय की जाती हैं. उदाहरण के लिए, <gd:when> http://schemas.google.com/g/2005#event की जानकारी देता है.
@valueString? xs:string एक आसान स्ट्रिंग वैल्यू जिसका इस्तेमाल इस जगह को दिखाने के लिए किया जा सकता है.
gd:entryLink? entryLink जगह की जानकारी दिखाने वाली एंट्री. इस एंट्री से संपर्क किस तरह का होना चाहिए.

rel मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event या मौजूद नहीं है वह जगह जहां करीब होने वाला इवेंट होता है.
http://schemas.google.com/g/2005#event.alternate दूसरी जगह. उदाहरण के लिए, किसी रिमोट साइट पर मुख्य साइट के वीडियोकॉन्फ़्रेंस लिंक का इस्तेमाल किया गया हो.
http://schemas.google.com/g/2005#event.parking आस-पास का कोई पार्किंग स्थान.

उदाहरण

इवेंट की जगह:

<gd:where valueString="Google Cafeteria (Building 40)"/>

इवेंट की जगह की ज़्यादा जानकारी:

<gd:where rel="http://schemas.google.com/g/2005#event" valueString="Joe's Pub">
  <gd:entryLink href="http://local.example.com/10018/JoesPub">
    <gd:entry>
      <id>http://local.example.com/10018/JoesPub</id>
      <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
      <content>Nice place to listen to jazz music</content>
      <link href="http://www.joespub.com"/>
      <gd:postalAddress>500 West 45th Street, New York, NY 10018</gd:postalAddress>
      <gd:geoPt lat="40.75" lon="-74.0"/>
      <gd:phoneNumber>(212) 555-1212</gd:phoneNumber>
      <gd:email address="info@joespub.com"/>
    </gd:entry>
  </gd:entryLink>
</gd:where>

कई जगहों पर होने वाला इवेंट:

<gd:where label="Mountain View Location (main)"
         valueString="Google Cafeteria (Building 40)"/>

<gd:where rel="http://schemas.google.com/g/2005#event.alternate"
         label="New York Location (videoconference)"
         valueString="Metropolis"/>

स्कीमा

start = where

where =
   element gd:where {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute label { xs:string }?,
      attribute valueString { xs:string }?,
      (entryLink?)
   }

gd:कौन

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

<gd:who> एलिमेंट का इस्तेमाल, ईमेल भेजने वालों और पाने वालों, कैलेंडर इवेंट के आयोजकों वगैरह को बताने के लिए किया जा सकता है.

प्रॉपर्टी

प्रॉपर्टी टाइप ब्यौरा
@email? xs:string ईमेल पता. आम तौर पर, इस प्रॉपर्टी का इस्तेमाल तब किया जाता है, जब <gd:entryLink> नहीं बताया जाता. यह पता आरएफ़सी 2822 सेक्शन 3.4.1 के मुताबिक होना चाहिए.
@rel? xs:string शामिल इकाई और शामिल व्यक्ति के बीच का संबंध बताता है. संभावित वैल्यू के लिए नीचे देखें.
@valueString? xs:string स्ट्रिंग की आसान वैल्यू, जिसका इस्तेमाल इस व्यक्ति को दिखाने के लिए किया जा सकता है.
gd:attendeeStatus? gEnumConstruct इवेंट में शामिल होने वाले व्यक्ति का स्टेटस. विस्तार योग्य enum नीचे दर्ज किया गया है.
gd:attendeeType? gEnumConstruct इवेंट में शामिल होने वाले व्यक्ति का टाइप. विस्तार योग्य enum नीचे दर्ज किया गया है.
gd:entryLink? entryLink व्यक्ति की जानकारी दिखाने वाली एंट्री. इस एंट्री से संपर्क किस तरह का होना चाहिए. कई मामलों में, यह एंट्री संपर्क फ़ीड से की जाएगी.

rel मान

@rel के लिए मान्य मान इस बात पर निर्भर करते हैं कि <gd:who> एलिमेंट किस तरह के दिखाई देते हैं.

वैल्यू दयालु ब्यौरा
http://schemas.google.com/g/2005#event.attendee इवेंट आम मीटिंग/इवेंट में शामिल होने के लिए.
http://schemas.google.com/g/2005#event.organizer इवेंट इवेंट आयोजक. ऐसा ज़रूरी नहीं कि आयोजक कोई मेहमान हो.
http://schemas.google.com/g/2005#event.performer इवेंट कलाकार. http://schemas.google.com/g/2005#event.speaker की तरह है, लेकिन बोली डिलीवरी की तुलना में कला पर ज़्यादा ज़ोर दिया जाता है.
http://schemas.google.com/g/2005#event.speaker इवेंट स्पीकर पर टैप करें.
http://schemas.google.com/g/2005#message.bcc मैसेज करें ईमेल की गुप्त कॉपी.
http://schemas.google.com/g/2005#message.cc मैसेज करें ईमेल की कॉपी भेज सकता है.
http://schemas.google.com/g/2005#message.from मैसेज करें ईमेल (ईमेल या IM) भेजने वाला.
http://schemas.google.com/g/2005#message.reply-to मैसेज करें जवाब देने वाले मैसेज का इंटेंट.
http://schemas.google.com/g/2005#message.to मैसेज करें ईमेल पाने वाले का मुख्य व्यक्ति.

gd:attendeeType मान

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event.optional मेहमान के तौर पर शामिल होना ज़रूरी नहीं है.
http://schemas.google.com/g/2005#event.required ज़रूरी मेहमान.

gd:attendeeStatus की वैल्यू

वैल्यू ब्यौरा
http://schemas.google.com/g/2005#event.accepted अतिथि ने स्वीकार कर लिया है.
http://schemas.google.com/g/2005#event.declined मीटिंग में शामिल होने वाले व्यक्ति ने न्योता अस्वीकार कर दिया है.
http://schemas.google.com/g/2005#event.invited न्योता भेज दिया गया है, लेकिन अनुरोध स्वीकार नहीं किया गया.
http://schemas.google.com/g/2005#event.tentative अतिथि ने अस्थायी रूप से स्वीकार किया है.

उदाहरण

ईमेल प्राप्तकर्ता:

<gd:who rel="http://schemas.google.com/g/2005#message.from" email="jo@example.com"/>
<gd:who rel="http://schemas.google.com/g/2005#message.to" valueString="Elizabeth" email="liz@example.com"/>

मीटिंग में शामिल मेहमान:

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:attendeeType value="http://schemas.google.com/g/2005#event.required"/>
  <gd:attendeeStatus value="http://schemas.google.com/g/2005#event.tentative"/>
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo">
    <entry>
      <id>http://gmail.com/jo/contacts/Jo</id>
      <category term="user-tag" label="Google"/>
      <title>Jo March</title>
      <gd:email address="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

इवेंट आयोजक:

<gd:who rel="http://schemas.google.com/g/2005#event.organizer" valueString="Receptionist 41"/>

स्कीमा

start = who

who =
   element gd:who {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute email { xs:string }?,
      attribute valueString { xsd:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

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