این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

عناصر مشترک: "نوع"

اخطار : این صفحه درباره APIهای قدیمی Google، Google Data APIها است. فقط مربوط به APIهایی است که در فهرست راهنمای Google Data APIs فهرست شده اند، که بسیاری از آنها با APIهای جدیدتر جایگزین شده اند. برای اطلاعات در مورد یک API جدید خاص، به مستندات API جدید مراجعه کنید. برای اطلاعات در مورد تأیید درخواست‌ها با یک API جدیدتر، به تأیید اعتبار و مجوز حساب‌های Google مراجعه کنید.

معرفی

اغلب برای سرویس‌هایی که از Google Data API استفاده می‌کنند مفید است تا بتوانند مجموعه‌ای از اطلاعات را در مورد نوع خاصی از آیتم ارائه دهند.

برای مثال، سرویس‌های مختلف Google Data API (یا «GData») ممکن است اطلاعات تماس یک شخص یا یک سازمان را ارائه دهند. منطقی است که همه این خدمات از یک مجموعه از عناصر اطلاعات تماس استفاده کنند.

مجموعه عناصری که با هم یک تماس را توصیف می کنند، تماس "نوع" نامیده می شود. برخی از عناصر در نوع Contact، عناصر معمولی Atom یا RSS هستند. سایرین توسط گوگل در فضای نامی به نام "Google Data namespace" تعریف شده اند. طبق قرارداد، فضای نام Google Data معمولاً در کد XML با استفاده از gd: alias; برای مثال، عنصری که حاوی شماره تلفن یا فکس است <gd:phoneNumber> است. URL طرحی برای فضای نام Google Data http://schemas.google.com/g/2005 است.

Google انواع دیگری را نیز تعریف می‌کند: رویداد (مجموعه‌ای از عناصر استاندارد شده که با هم یک رویداد تقویم را نشان می‌دهند) و پیام (مجموعه‌ای از عناصر نشان‌دهنده یک پیام ایمیل، ارسال گروه بحث یا پیام دیگر).

برخی از عناصر از فضای نام Google Data با انواع مختلفی استفاده می شوند. برای مثال، عنصر <gd:who> یک شخص را (که در <gd:who> توضیح داده شده است) با ورودی حاوی عنصر <gd:who> مرتبط می‌کند. این عنصر در نوع رویداد برای تعیین سازمان‌دهندگان، شرکت‌کنندگان و غیره استفاده می‌شود. همچنین در نوع پیام برای تعیین فرستنده و گیرنده استفاده می شود.

وقتی ورودی در فید Google Data 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"/>

این به مشتریان اجازه می دهد تا به سرعت و به آسانی نوع داده های ورودی را تعیین کنند - یعنی معنایی ورودی را تعیین کنند. (در صورت تمایل می توانید از RSS به جای Atom استفاده کنید؛ به سند مرجع پروتکل برای عناصر RSS مربوط به عناصر Atom مراجعه کنید.)

این سند مرجعی برای برخی از انواع رایج و عناصر موجود در آنها است.

عناصر غیر مستند

ما اطلاعاتی در مورد عناصر استاندارد <atom:entry> در انواعی که آن عناصر معانی استاندارد خود را دارند، درج نمی کنیم. به عنوان مثال، <atom:id> ، <atom:published> ، و <atom:updated> همگی معانی استاندارد خود را دارند که در انواع ظاهر شوند.

ما همچنین اطلاعاتی در مورد عناصر استاندارد Atom که در زمینه داده شده بی‌معنی هستند، درج نمی‌کنیم. به عنوان مثال، <atom:summary> در نوع Contact استفاده نمی شود، و اگرچه <atom:author> یک عنصر ضروری در ورودی است (مگر اینکه در فید والد مشخص شده باشد)، معنای مفیدی در آن ندارد. نوع تماس

ایجاد انواع

ممکن است دشوار باشد که دقیقاً چه اطلاعاتی را باید در هنگام ایجاد یک ورودی از یک نوع خاص درج کنید، به خصوص به این دلیل که برخی از عناصر موجود در این انواع حاوی انواع دیگری هستند.

یکی از روش‌هایی که ممکن است کمک کند، استفاده از کتابخانه‌های مشتری است که ارائه می‌دهیم به جای تلاش برای ساخت انواع دستی. کتابخانه های مشتری روش های مختلفی را برای افزودن و تغییر داده ها در یک ورودی از یک نوع خاص ارائه می کنند. برای جزئیات به مستندات کتابخانه مشتری مراجعه کنید.

توسعه پذیری

اطلاعات موجود در این سند همه ویژگی‌ها و مقادیر ویژگی‌های ممکن را برای انواع پوشش نمی‌دهد. سرویس‌ها ممکن است انواع مختلفی را گسترش دهند، بنابراین یک سرویس خاص ممکن است از ویژگی‌ها و مقادیری استفاده کند که در این سند گنجانده نشده است.

قراردادهای تایپی

در جداول این سند، از قراردادهای زیر برای عناصر مورد نیاز و اختیاری استفاده می کنیم:

نام عنصر	عنصر مورد نیاز
نام عنصر؟	عنصر اختیاری
نام عنصر*	عنصر اختیاری، چند نمونه مجاز است

عناصر و ویژگی ها در نماد XPath استاندارد ارائه شده اند.

نوع تماس

یک مخاطب را نشان می دهد: یک شخص، یک مکان مانند یک باشگاه یا یک رستوران، یا یک سازمان.

عنصر دسته: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>

توجه : اگر از نوع Contact در زمینه Contacts API استفاده می کنید، لطفاً به یاد داشته باشید که نوع Contact نسخه 2.0 (شرح شده در این سند) از نسخه 3.0 API توسط Contacts API استفاده می شود.

خواص

ویژگی	شرح
`atom:category` *	دسته بندی ها. نمونه هایی با ویژگی `@label` به عنوان برچسب در نظر گرفته می شوند. برای اطلاعات در مورد استفاده از ویژگی `@scheme` ، به یادداشت ابتدای این بخش مراجعه کنید.
`atom:content`	نکاتی در مورد مخاطب
`atom:link` *	پیوند به اطلاعات مرتبط به طور خاص، `atom:link[@rel='alternate']` به یک صفحه HTML که مخاطب را توصیف می کند پیوند می دهد.
`atom:title`	نام مخاطب این فیلد فقط خواندنی است. برای تغییر نام مخاطب، به `gd:name` مراجعه کنید.
`gd: email` *	آدرس ایمیل.
`gd: extendedProperty` *	دارایی تمدید شده
`gd: deleted` ؟	وجود این عنصر نشان می دهد که این ورودی مخاطب حذف شده است.
`gd: im` *	آدرس های IM
`gd: name` ؟	نام مخاطب به شکل ساختار یافته
`gd: organization` *	سازمان.
`gd: phoneNumber` *	شماره تلفن و فکس.
`gd: structuredPostalAddress` *	آدرس پستی مخاطب به صورت ساختار یافته
`gd: where` ؟	مکانی مرتبط با مخاطب

مثال ها

<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>

نوع پروفایل

نمایه ای را نشان می دهد که با یک کاربر Google یا نهاد دیگری مرتبط است. نوع نمایه ساختار زیادی با نوع تماس دارد. با این حال، از جهاتی متفاوت است: مثلاً نمی‌تواند حاوی ویژگی‌های توسعه‌یافته باشد یا به عنوان حذف شده علامت‌گذاری شود.

عنصر دسته: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#profile"/>

نوع Profile در نسخه 3.0 Contacts API معرفی شد.

خواص

ویژگی	شرح
`atom:category` *	دسته بندی ها. نمونه هایی با ویژگی `@label` به عنوان برچسب در نظر گرفته می شوند. برای اطلاعات در مورد استفاده از ویژگی `@scheme` ، یادداشت "عنصر دسته" را در ابتدای این بخش ببینید.
`atom:content`	نکاتی در مورد پروفایل
`atom:link` *	پیوند به اطلاعات مرتبط به طور خاص، `atom:link[@rel='alternate']` به یک صفحه HTML که نمایه را توصیف می کند پیوند می دهد.
`atom:title`	نام پروفایل این فیلد فقط خواندنی است.
`gd: email` *	آدرس ایمیل.
`gd: im` *	آدرس های IM
`gd: name` ؟	نام، به شکل ساختار یافته.
`gd: organization` *	سازمان.
`gd: phoneNumber` *	شماره تلفن و فکس.
`gd: structuredPostalAddress` *	آدرس پستی، به شکل ساختار یافته.
`gd: where` ؟	مکانی مرتبط با نمایه

مثال ها

<entry xmlns='http://www.w3.org/2005/Atom'
xmlns:gContact='http://schemas.google.com/contact/2008'
xmlns:batch='http://schemas.google.com/gdata/batch'
xmlns:gd='http://schemas.google.com/g/2005'
  <category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#profile' />
  <title>Elizabeth Bennett</title>
  <gd:name>
    <gd:givenName>Elizabeth</gd:givenName>
    <gd:familyName>Bennett</gd:familyName>
  </gd:name>
  <gd:structuredPostalAddress rel='http://schemas.google.com/g/2005#work'>
    <gd:formattedAddress>Longbourne, Nr. Meryton, Hertfordshire, England</gd:formattedAddress>
  </gd:structuredPostalAddress>
</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']` پیوندی به یک صفحه HTML ارائه می دهد که رویداد را توصیف می کند.
`atom:title`	عنوان مختصر رویداد
`gd: comments` ؟	فید نظرات
`gd: eventStatus` ؟	فهرست قابل توسعه مستند در زیر.
`gd: extendedProperty` *	دارایی تمدید شده
`gd: originalEvent` ?	شناسه رویداد اصلی برای رویدادهای تکرار شونده.
`gd: recurrence` ؟	قانون عود
`gd: transparency` ؟	فهرست قابل توسعه مستند در زیر، مربوط به ویژگی TRANSP تعریف شده در RFC 2445 است.
`gd: visibility` ؟	فهرست قابل توسعه مستند در زیر.
`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` .

مقادیر rel برای gd:where

ارزش رابطه	شرح
`http://schemas.google.com/g/2005#event` یا مشخص نشده است.	مکانی که رویداد در آن برگزار می شود.
`http://schemas.google.com/g/2005#event.alternate`	یک مکان ثانویه به عنوان مثال، یک سایت از راه دور با یک ویدیو کنفرانس به سایت اصلی پیوند می دهد.
`http://schemas.google.com/g/2005#event.parking`	پارکینگ نزدیک.

gd: مقادیر رویدادStatus

ارزش	شرح
`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 قرار دهید.
`atom:title`	موضوع پیام.
`gd: geoPt` ?	موقعیت جغرافیایی که پیام از آن پست شده است.
`gd: rating` ?	رتبه بندی کیفیت (همانطور که توسط برنامه تعریف شده است).
`gd: who` *	افراد مرتبط با این پیام معنای دقیق به مقدار `@rel` بستگی دارد. جدول زیر را ببینید.

مقوله @term values

همه دسته‌های زیر در طرح 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`	پیام خوانده نشده است.

مقادیر rel برای gd:who

ویژگی	شرح
`http://schemas.google.com/g/2005#message.bcc`	پیام گیرنده BCC.
`http://schemas.google.com/g/2005#message.cc`	پیام گیرنده 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 Data

بقیه این سند شامل مواد مرجع برای عناصر استفاده شده توسط انواع است.

Enums
gdCommonProperties
gd:additionalName
gd: نظرات
gd: کشور
gd:حذف شد
gd: ایمیل
gd:entryLink
gd:extendedProperty
gd:familyName
gd:feedLink
gd:geoPt
gd:givenName
gd:im
gd: سازمان
gd:org بخش
gd:org شرح شغل
gd:orgName
gd:org نماد
gd:orgTitle
gd:originalEvent
gd: شماره تلفن
gd:postalAddress
gd: رتبه بندی
gd:عود
gd:recurenceException
gd: یادآوری
gd:structuredPostalAddress
gd: وقتی
gd: کجا
gd: چه کسی

Enums

برخی از عناصر پسوند نیاز به مشخص کردن ویژگی هایی دارند که مقادیر آنها از یک مجموعه شمارش شده آمده است. شکل کلی چنین خواصی به شرح زیر است:

<gd:propertyName value="propertyValue">

اگر مقدار ویژگی از فضای نام Google Data باشد، به شکل http://schemas.google.com/g/2005# {kind} است . {ارزش}. به عنوان مثال: http://schemas.google.com/g/2005#event.tentative . اگر فضای مقدار قابل گسترش باشد، مقادیر ممکن است به شکل URI نیز باشند. فرم توصیه شده برای URI های با ارزش توسعه یافته {schema URI} # {value} است. به عنوان مثال: http://www.example.com/attendeeStatus#AudioConference .

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

ویژگی های رایج مورد استفاده برای همه انواع Google. توجه داشته باشید که وجود anyAttribute و anyElement در طرحواره به همه عناصر فضای نام Google Data با استفاده از ویژگی‌های رایج اجازه می‌دهد تا در هر فضای نامی گسترش بیشتری پیدا کنند. به طور خاص، قرار دادن هر عنصر gd یا هر عنصر Atom/RSS در هر عنصر gd دیگر قانونی است. این باید با احتیاط انجام شود، و در بیشتر موارد چنین استفاده ای باید به عنوان یک ویژگی صریح از نوع عنصر حاوی gd مستند شود.

خواص

ویژگی	تایپ کنید	شرح
`@xml:base`	`uri`	ساختار استاندارد XML برای توصیف پایه URI های نسبی تو در تو.
`@xml:lang`	`text`	زبان رشته های تو در تو

طرحواره

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

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

gd:additionalName

نام اضافی (مثلاً میانی) شخص را مشخص می کند، به عنوان مثال. "سوزان".

خواص

ویژگی	تایپ کنید	شرح
`@yomi` ?	`xs:string`	نمایش فونتیکال
`text()`	`xs:string`	نام خانوادگی فرد.

مثال

<gd:additionalName yomi="'suz@n">Susan<gd:additionalName>

طرحواره

start = additionalName

additionalName =
   element gd:additionalName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd: نظرات

حاوی فید نظرات برای ورودی محصور (مانند یک رویداد تقویم).

خواص

ویژگی	تایپ کنید	شرح
`@rel` ?	`xs:string`	نوع نظرات موجود در در حال حاضر، بین نظرات معمولی و نقدها تفاوت وجود دارد.
`gd: feedLink` ?	`feedLink`	فید نظرات این فید باید نوع Message را اجرا کند.

مقادیر رابطه

ارزش	شرح
`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: کشور

نام کشور به همراه کد کشور اختیاری. مورد دوم مطابق با ISO 3166-1 alpha-2 ارائه شده است.

خواص

ویژگی	تایپ کنید	شرح
`@code` ؟	`xs:string`	کد کشور مطابق با ISO 3166-1 alpha-2 .
`text()`	`xs:string`	نام کشور.

مثال ها

<gd:country code='PL'>Poland</gd:country>
<gd:country>Gabon</gd:country>

طرحواره

start = country

country =
   element gd:country {
      attribute code { xs:string }?,
      xs:string?
   }

gd: ایمیل

یک آدرس ایمیل مرتبط با موجودیت حاوی (که معمولاً نهادی است که نماینده یک شخص یا یک مکان است).

خواص

ویژگی	تایپ کنید	شرح
`@address`	`xs:string`	آدرس ایمیل.
`@displayName` ?	`xs:string`	نام نمایشی نهاد (به عنوان مثال یک شخص) که آدرس ایمیل به آن تعلق دارد.
`@label` ?	`xs:string`	یک مقدار رشته ساده برای نامگذاری این آدرس ایمیل استفاده می شود. این به UI ها اجازه می دهد برچسب هایی مانند "Work"، "Personal"، "Preferred" و غیره را نمایش دهند.
`@rel` ?	`xs:string`	یک مقدار برنامه ای که نوع ایمیل را مشخص می کند. برای جزئیات به زیر مراجعه کنید
`@primary` ؟	`xs:boolean`	هنگامی که چندین پسوند ایمیل در یک نوع مخاطب ظاهر می شود، نشان می دهد که کدام یک اصلی است. حداکثر یک ایمیل ممکن است اصلی باشد. مقدار پیش فرض `"false"` است.

مقادیر رابطه

ارزش	شرح
`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" displayName="Foo Bar" />
<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 displayName { xs:string }?,
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:entryLink

یک ورودی منطقی تودرتو را نشان می دهد. برای مثال، یک <gd:who> که یک مخاطب را نشان می‌دهد ممکن است یک ورودی تودرتو از فید مخاطب داشته باشد.

خواص

ویژگی	تایپ کنید	شرح
`@href` ?	`xs:string`	URI ورودی را مشخص می کند. اگر ورودی تودرتو تعبیه شده باشد و پیوند داده نشده باشد، این ویژگی ممکن است حذف شود.
`@readOnly` ?	`xs:boolean`	مشخص می کند که آیا ورودی موجود فقط خواندنی است یا خیر. مقدار پیش فرض `"false"` است.
`@rel` ?	`xs:string`	رابطه پیوند را مشخص می کند. به سرویس اجازه می دهد تا چندین نوع پیوند ورودی برای یک موجودیت واحد ارائه دهد. دارای همان معنای و مقادیر مجاز با ویژگی `rel` عنصر `<atom:link>` .
`atom:entry` ?	`atomEntry`	محتویات مدخل.

محدودیت های

یکی یا هر دو @href یا <atom:entry> باید وجود داشته باشد.
اگر atom:entry وجود نداشته باشد، مشتری می‌تواند محتویات را از URI ورودی در @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 به فید اجازه می دهد تا به صورت اختیاری هر XML معتبری را در عنصر gd:extendedProperty تعبیه کند (متقابل با ویژگی value ).

خواص

ویژگی	تایپ کنید	شرح
`@name`	`xs:string`	نام دارایی را که به صورت URI بیان شده است را مشخص می کند. URIهای دارای ویژگی توسعه یافته معمولاً از قرارداد {schema}#{local-name} پیروی می کنند.
`@value` ؟	`xs:string`	ارزش ملک.
`@realm` ؟	`xs:string`	توسط برخی از APIها برای تعیین محل اعمال ویژگی توسعه یافته استفاده می شود.

مثال

یک شناسه خارجی برای یک رویداد تقویم:

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

xml اضافی برای ورود مخاطب

<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*),
      attribute realm { xs:string } ?
   }

gd:familyName

نام خانوادگی فرد را مشخص می کند، به عنوان مثال. "اسمیت".

خواص

ویژگی	تایپ کنید	شرح
`@yomi` ?	`xs:string`	نمایش آوایی
`text()`	`xs:string`	نام خانوادگی فرد.

مثال

<gd:familyName yomi="smɪð">Smith<gd:familyName>

طرحواره

start = familyName

familyName =
   element gd:familyName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:feedLink

نشان دهنده یک خوراک تودرتو منطقی است. به عنوان مثال، یک فید تقویم ممکن است یک فید تودرتو داشته باشد که تمام نظرات ورودی‌ها را نشان می‌دهد.

خواص

ویژگی	تایپ کنید	شرح
`@countHint` ?	`xs:unsignedInt`	نکاتی در مورد تعداد ورودی ها در فید. بسته به اجرا، ممکن است شمارش دقیقی نباشد.
`@href` ?	`xs:string`	URI فید را مشخص می کند. اگر فید تودرتو تعبیه شده باشد و پیوند داده نشده باشد، این ویژگی ممکن است حذف شود.
`@readOnly` ?	`xs:boolean`	مشخص می کند که آیا فید موجود فقط خواندنی است یا خیر.
`@rel` ?	`xs:string`	رابطه پیوند را مشخص می کند. به این سرویس اجازه می دهد تا چندین نوع پیوند فید را برای یک موجودیت واحد فراهم کند. دارای همان معنای و مقادیر مجاز با ویژگی `rel` عنصر `<atom:link>` .
`atom:feed` ؟	`atomFeed`	محتویات خوراک.

محدودیت های

یکی یا هر دو @href یا <atom:feed> باید وجود داشته باشد.
اگر atom:feed وجود نداشته باشد، مشتری می‌تواند محتویات را از URI در @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"/>

فید تعبیه شده در ورودی Atom که یک لیست را نشان می دهد:

<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`	یک مقدار رشته ساده برای نامگذاری این مکان استفاده می شود. این به UI ها اجازه می دهد تا برچسبی مانند "موقعیت فعلی" را نمایش دهند.
`@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 استفاده می شود. این به UI ها اجازه می دهد برچسب هایی مانند "Work"، "Personal"، "Preferred" و غیره را نمایش دهند.
`@rel` ?	`xs:string`	یک مقدار برنامه ای که نوع IM را مشخص می کند. برای جزئیات به زیر مراجعه کنید
`@protocol` ؟	`xs:string`	شبکه IM را شناسایی می کند. مقدار ممکن است یکی از مقادیر استاندارد (نشان داده شده در زیر) یا یک URI باشد که یک شبکه IM اختصاصی را شناسایی می کند.
`@primary` ؟	`xs:boolean`	هنگامی که چندین برنامه افزودنی IM در یک نوع مخاطب ظاهر می شود، نشان می دهد که کدام اصلی است. حداکثر یک پیام فوری ممکن است اولیه باشد. مقدار پیش فرض `"false"` است.

مقادیر رابطه

ارزش	شرح
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#netmeeting`
`http://schemas.google.com/g/2005#other`	آدرس IM که نه خانه است و نه محل کار. `label` می تواند برای نشان دادن نوع واقعی استفاده شود.
`http://schemas.google.com/g/2005#work`

مقادیر ویژگی پروتکل

جدول زیر برخی از مقادیر احتمالی ممکن برای ویژگی @protocol را نشان می دهد.

ارزش	شرح
`http://schemas.google.com/g/2005#AIM`	پروتکل AOL Instant Messenger
`http://schemas.google.com/g/2005#MSN`	پروتکل MSN Messenger
`http://schemas.google.com/g/2005#YAHOO`	پروتکل یاهو مسنجر
`http://schemas.google.com/g/2005#SKYPE`	پروتکل اسکایپ
`http://schemas.google.com/g/2005#QQ`	پروتکل QQ
`http://schemas.google.com/g/2005#GOOGLE_TALK`	پروتکل Google Talk
`http://schemas.google.com/g/2005#ICQ`	پروتکل ICQ
`http://schemas.google.com/g/2005#JABBER`	پروتکل جابر

مثال ها

یک آدرس IM برای MSN Messenger:

<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:givenName

نام فرد را مشخص می کند، به عنوان مثال. "جان".

خواص

ویژگی	تایپ کنید	شرح
`@yomi` ?	`xs:string`	نمایش آوایی
`text()`	`xs:string`	نام داده شده شخص

مثال

<gd:givenName yomi="dʒon">John<gd:givenName>

طرحواره

start = givenName

givenName =
   element gd:givenName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd: پول

مقدار پول را در یک ارز خاص مشخص می کند.

خواص

ویژگی	تایپ کنید	شرح
`@amount`	`xsd:float`	مقدار پول.
`@currencyCode`	`xsd:string`	کد ارز ISO4217 .

مثال

<gd:money amount='650.0' currencyCode='EUR'/>

طرحواره

element gd:money {
  attribute amount { xsd:float },
  attribute currencyCode { xsd:string }
}

gd:name

اجازه می دهد تا نام شخص را به روشی ساختاریافته ذخیره کند. شامل نام داده شده، نام اضافی، نام خانوادگی، پیشوند، پسوند و نام کامل است.

خواص

ویژگی	تایپ کنید	شرح
`gd:givenName` ?	`givenName`	نام داده شده شخص
`gd:additionalName` ?	`additionalName`	نام اضافی شخص، به عنوان مثال. نام میانی
`gd:familyName` ?	`familyName`	نام خانوادگی فرد.
`gd:namePrefix` ?	`namePrefix`	پیشوند افتخاری، به عنوان مثال. "آقا" یا "خانم".
`gd:nameSuffix` ?	`nameSuffix`	پسوند افتخاری، به عنوان مثال. "سان" یا "III".
`gd:fullName` ?	`fullName`	نمایش بدون ساختار نام.

مثال

نمایندگی ساختار یافته سر وینستون لئونارد اسپنسر-چرچیل، KG

<gd:name>
  <gd:givenName>Winston</gd:givenName>
  <gd:additionalName>Leonard</gd:additionalName>
  <gd:familyName>Spencer-Churchill</gd:familyName>
  <gd:namePrefix>Sir</gd:namePrefix>
  <gd:nameSuffix>OG</gd:nameSuffix>
</gd:name>

طرحواره

start = name

name =
   element gd:name {
      givenName?
      & additionalName?
      & familyName?
      & namePrefix?
      & nameSuffix?
   }

محدودیت های

جزء بدون ساختار نام باید با نمایش ساختاری آن سازگار باشد.

gd: سازمان

سازمانی که معمولاً با یک مخاطب مرتبط است.

خواص

ویژگی	تایپ کنید	شرح
`@label` ?	`xs:string`	یک مقدار رشته ای ساده برای نامگذاری این سازمان استفاده می شود. این به UI ها اجازه می دهد برچسب هایی مانند "کار"، "داوطلب"، "جامعه حرفه ای" و غیره را نمایش دهند.
`gd:orgDepartment` ?	`orgDepartment`	یک بخش در سازمان را مشخص می کند.
`gd:orgJobDescription` ?	`orgJobDescription`	شرح شغل در سازمان.
`gd:orgName` ?	`orgName`	نام سازمان.
`gd:orgSymbol` ?	`orgSymbol`	نماد سازمان.
`gd:orgTitle` ?	`orgTitle`	عنوان یک شخص در سازمان.
`@primary` ؟	`xs:boolean`	وقتی چندین برنامه افزودنی سازمان در یک نوع تماس ظاهر می‌شوند، نشان می‌دهد که کدام اصلی است. حداکثر یک سازمان ممکن است اولیه باشد. مقدار پیش فرض `"false"` است.
`@rel` ?	`xs:string`	یک مقدار برنامه ای که نوع سازمان را مشخص می کند. برای جزئیات به زیر مراجعه کنید
`gd:where` ؟	`where`	مکانی مرتبط با سازمان، به عنوان مثال محل دفتر.

مقادیر رابطه

ارزش	شرح
`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:orgJobDescription>Writes documentation</gd:orgJobDescription>
  <gd:orgDepartment>Software Development</gd:orgDepartment>
  <gd:orgSymbol>GOOG</gd:orgSymbol>
</gd:organization>

طرحواره

start = organization

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      ( orgDepartment? &
      orgJobDescription? &
      orgName? &
      orgSymbol? &
      orgTitle? &
      where? )
   }

gd:org بخش

یک بخش در یک سازمان را توصیف می کند. باید در یک عنصر gd:organization ظاهر شود.

مثال

<gd:orgDepartment>Research and Development</gd:orgDepartment>

طرحواره

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

gd:org شرح شغل

یک شغل در یک سازمان را توصیف می کند. باید در یک عنصر gd:organization ظاهر شود.

مثال

<gd:orgJobDescription>Documenting public APIs</gd:orgJobDescription>

طرحواره

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:orgName

نام سازمان. باید در یک عنصر gd:organization ظاهر شود.

خواص

ویژگی	شرح
`@yomi` ?	Yomigana (کمک خواندن ژاپنی) برای نام سازمان.

مثال

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

طرحواره

start = orgName

orgName =
   element gd:orgName {
     attribute yomi {xs:string},
     xs:string
   }

gd:org نماد

نمادی از یک سازمان را ارائه می دهد. باید در یک عنصر gd:organization ظاهر شود.

مثال

<gd:orgSymbol>GOOG</gd:orgSymbol>

طرحواره

start = orgSymbol

orgSymbol = element gd:orgSymbol { xs:string }

gd:orgTitle

عنوان یک شخص در یک سازمان. باید در یک عنصر gd:organization ظاهر شود.

مثال

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

طرحواره

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:originalEvent

معادل ویژگی Recurrence ID مشخص شده در بخش 4.8.4.4 RFC 2445 . برای شناسایی رویداد اصلی در هر نمونه از یک رویداد تکرار شونده ظاهر می شود.

حاوی یک عنصر <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` به طور منحصربه‌فرد یک عدد را شناسایی می‌کند و به رابط‌های کاربری اجازه می‌دهد برچسب مناسبی مانند "Mobile"، "Home"، "Work" و غیره را نمایش دهند. اما در مواردی که یک نفر دارای ( به عنوان مثال) چندین تلفن همراه، از این ویژگی می توان برای رفع ابهام آنها استفاده کرد.
`@rel` ?	`xs:string`	یک مقدار برنامه ای که نوع شماره تلفن را مشخص می کند. برای جزئیات به زیر مراجعه کنید
`@uri` ?	`xs:string`	یک "tel URI" اختیاری که برای نشان دادن شماره به صورت رسمی استفاده می شود، برای دسترسی برنامه ریزی شده، مانند پل VoIP/PSTN مفید است. برای اطلاعات بیشتر در مورد تلفن URI به RFC 3966 مراجعه کنید.
`@primary` ؟	`xs:boolean`	وقتی چندین پسوند شماره تلفن در یک نوع مخاطب ظاهر می‌شوند، نشان می‌دهد که کدام یک اصلی است. حداکثر یک شماره تلفن ممکن است اصلی باشد. مقدار پیش فرض `"false"` است.
`text()`	`xs:string`	شماره تلفن قابل خواندن توسط انسان؛ ممکن است در هر قالب شماره تلفن باشد. فضای سفید پیشرو و دنباله دار ناچیز است. خطوط جدید درون رشته نیز ناچیز هستند و ممکن است حذف شوند یا به یک فضای منفرد تبدیل شوند.

مقادیر رابطه

ارزش	شرح
`http://schemas.google.com/g/2005#assistant`
`http://schemas.google.com/g/2005#callback`
`http://schemas.google.com/g/2005#car`
`http://schemas.google.com/g/2005#company_main`
`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#isdn`
`http://schemas.google.com/g/2005#main`
`http://schemas.google.com/g/2005#mobile`
`http://schemas.google.com/g/2005#other`	نوع خاصی از عدد که هیچ مقدار `rel` دیگری برای آن معنا ندارد. `label` می تواند برای نشان دادن نوع واقعی استفاده شود.
`http://schemas.google.com/g/2005#other_fax`
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#radio`
`http://schemas.google.com/g/2005#telex`
`http://schemas.google.com/g/2005#tty_tdd`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`
`http://schemas.google.com/g/2005#work_mobile`
`http://schemas.google.com/g/2005#work_pager`

مثال ها

شماره تلفن ساده وارد شده توسط کاربر:

<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`	آدرس به عنوان متن فضای سفید پیشرو و دنباله دار ناچیز است. خطوط جدید در رشته مهم هستند.

مقادیر رابطه

ارزش	شرح
`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`	ارزش رتبه بندی

مقادیر رابطه

ارزش	شرح
`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"/>

دارای امتیاز 200 کاربر با میانگین امتیاز 4.65 از 5:

<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 (RFC 2445) تعریف شده اند.

به طور خاص، رشته معمولاً با یک ویژگی DTSTART شروع می شود که زمان شروع اولین نمونه رویداد را نشان می دهد، و اغلب یک ویژگی DTEND یا یک ویژگی DURATION برای نشان دادن زمان پایان اولین نمونه شروع می شود. بعد ویژگی های RRULE، RDATE، EXRULE و/یا EXDATE می آیند که در مجموع یک رویداد تکرار شونده و استثناهای آن را تعریف می کنند (اما به زیر مراجعه کنید). (برای اطلاعات بیشتر در مورد این ویژگی‌های مؤلفه تکراری، به بخش 4.8.5 RFC 2445 مراجعه کنید.) در آخر یک مؤلفه VTIMEZONE آمده است که قوانین دقیق منطقه زمانی را برای هر شناسه منطقه زمانی ذکر شده در ویژگی‌های قبلی ارائه می‌کند.

سرویس‌های Google مانند Google Calendar معمولاً ویژگی‌های EXRULE و EXDATE را برای نمایش استثنائات رویدادهای تکرارشونده ایجاد نمی‌کنند. در عوض، عناصر <gd:recurrenceException> را تولید می کنند. با این حال، خدمات Google ممکن است به هر حال دارای ویژگی های EXRULE و/یا EXDATE باشد. برای مثال، کاربران می‌توانند رویدادها و استثناها را به تقویم وارد کنند، و اگر آن رویدادهای وارد شده حاوی ویژگی‌های EXRULE یا 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:recurenceException

رویدادی را نشان می‌دهد که یک استثنا برای یک رویداد تکراری است - یعنی نمونه‌ای از یک رویداد تکرارشونده که در آن یک یا چند جنبه از رویداد تکرارشونده (مانند فهرست حضور، زمان یا مکان) تغییر کرده است.

حاوی یک عنصر <gd:originalEvent> است که رویداد تکرار شونده اصلی را مشخص می کند که این رویداد از آن استثنا است.

وقتی نمونه ای از یک رویداد تکراری را تغییر می دهید، آن نمونه به یک استثنا تبدیل می شود. بسته به اینکه چه تغییری در آن ایجاد کرده‌اید، وقتی رویداد تکرارشونده اصلی تغییر می‌کند، استثنا به یکی از دو روش متفاوت رفتار می‌کند:

اگر نظرات، شرکت‌کنندگان یا پاسخ‌های شرکت‌کنندگان را اضافه کنید، تغییر دهید یا حذف کنید، این استثنا همچنان با رویداد اصلی مرتبط می‌ماند و تغییرات رویداد اصلی، استثنا را نیز تغییر می‌دهد.
اگر هر گونه تغییر دیگری در استثنا ایجاد کنید (مانند تغییر زمان یا مکان)، نمونه «تخصصی» می‌شود، به این معنی که دیگر به رویداد اصلی مرتبط نیست. اگر رویداد اصلی را تغییر دهید، استثناهای تخصصی تغییر نمی‌کنند. اما زیر را ببینید.

به عنوان مثال، فرض کنید هر سه‌شنبه و پنج‌شنبه ساعت ۲ بعد از ظهر جلسه دارید، اگر فهرست حضور را برای جلسه پنج‌شنبه‌ای تغییر دهید (اما نه برای جلسه‌ای که به طور منظم برنامه‌ریزی شده است)، در این صورت استثنا می‌شود. اگر زمان جلسه این پنجشنبه را تغییر دهید (اما نه برای جلسه برنامه ریزی شده منظم)، آنگاه تخصصی می شود.

صرف نظر از تخصصی بودن یا نبودن یک استثنا، اگر کاری انجام دهید که نمونه ای را که استثنا از آن مشتق شده است حذف کنید، آن استثنا حذف می شود. توجه داشته باشید که تغییر روز یا ساعت یک رویداد تکراری، همه نمونه‌ها را حذف می‌کند و موارد جدید ایجاد می‌کند.

به عنوان مثال، بعد از اینکه جلسه این پنج شنبه را تخصصی کردید، بگویید که جلسه تکراری را در روزهای دوشنبه، چهارشنبه و جمعه تغییر داده اید. این تغییر همه موارد تکراری جلسه سه شنبه/پنجشنبه، از جمله موارد تخصصی را حذف می کند.

اگر نمونه خاصی از یک رویداد تکرارشونده حذف شود، آن نمونه به صورت یک <gd:recurrenceException> نشان داده می شود که حاوی <gd:entryLink> است که <gd:eventStatus> آن را روی "http://schemas.google.com/g/2005#event.canceled" تنظیم کرده است." "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` (پیام متنی برای کاربر ارسال می کند).
`@days` ؟	`xs:unsignedInt`	دوره زمانی قبل از `gd:when/@startTime` زمانی که باید یادآوری صادر شود. اگر زمان هدف واحد اصلی یک تاریخ باشد نه یک زمان خاص، این ویژگی‌ها نسبت به نیمه شب (00:00) در آن تاریخ است.
`@hours` ؟	`xs:unsignedInt`
`@minutes` ؟	`xs:unsignedInt`

هنگامی که یک ورودی <gd:when> ایجاد یا ویرایش می کنید، از قراردادهای زیر برای دستیابی به نتایج خاص استفاده کنید:

برای اینکه به سرویس بگویید از یادآوری های پیش فرض کاربر استفاده کند، یک عنصر <gd:reminder> بدون ویژگی اضافه کنید. اگر مدت زمان را مشخص کنید اما ویژگی method را ندارید، آنگاه این سرویس از روش‌های اعلان پیش‌فرض کاربر با مدت زمانی که شما مشخص کرده‌اید استفاده می‌کند.
To tell the service to not issue any reminders for the event (or to remove existing reminders when updating an event), don't include any <gd:reminder> elements.

Restrictions

At most one of @days , @hours , @minutes , or @absoluteTime may be specified. To specify a mixed duration, convert to the most precise unit. For example, to specify 1 hour 30 minutes, use @minutes="90" .
You can't use negative values for the attributes (so if you want a reminder to occur after the start time, you must use @absoluteTime ).
A given event can't have more than five reminders associated with it.
When you're adding a reminder to an event, if you specify the alert , email , or sms methods, you must also specify a duration.

Examples

A 15-minute reminder for a meeting:

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

Same meeting as above, but snoozed for 10 minutes after the reminder at 16:45:

<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>

Schema

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:resourceId

An opaque resource identifier, distinct from atom:id as it need not be a valid URI. Some services provide a separate identifier to be used when constructing subsequent requests. Exact usage is service specific.

Example

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

Schema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:structuredPostalAddress

Postal address split into components. It allows to store the address in locale independent format. The fields can be interpreted and used to generate formatted, locale dependent address. The following elements reperesent parts of the address: agent, house name, street, PO box, neighborhood, city, subregion, region, postal code, country . The subregion element is not used for postal addresses, it is provided for extended uses of addresses only. In order to store postal address in an unstructured form formatted address field is provided.

Properties

ویژگی	تایپ کنید	شرح
`@rel` ?	`xs:string`	Type of the address. Unless specified `work` type is assumed.
`@mailClass` ?	`xs:string`	Classes of mail accepted at the address. Unless specified `both` is assumed.
`@usage` ?	`xs:string`	The context in which this addess can be used. Local addresses may differ in layout from general addresses, and frequently use local script (as opposed to Latin script) as well, though local script is allowed in general addresses. Unless specified `general` usage is assumed.
`@label` ?	`xs:string`	A general label for the address.
`@primary` ?	`xs:boolean`	Specifies the address as primary. Default value is `false` .
`gd:agent` ?	`agent`	The agent who actually receives the mail. Used in work addresses. Also for 'in care of' or 'c/o'.
`gd:housename` ?	`housename`	Used in places where houses or buildings have names (and not necessarily numbers), eg. "The Pillars".
`gd:street` ?	`street`	Can be street, avenue, road, etc. This element also includes the house number and room/apartment/flat/floor number.
`gd:pobox` ?	`pobox`	Covers actual PO boxes, drawers, locked bags, etc. This is usually but not always mutually exclusive with street.
`gd:neighborhood` ?	`neighborhood`	This is used to disambiguate a street address when a city contains more than one street with the same name, or to specify a small place whose mail is routed through a larger postal town. In China it could be a county or a minor city.
`gd:city` ?	`city`	Can be city, village, town, borough, etc. This is the postal town and not necessarily the place of residence or place of business.
`gd:subregion` ?	`subregion`	Handles administrative districts such as US or UK counties that are not used for mail addressing purposes. Subregion is not intended for delivery addresses.
`gd:region` ?	`region`	A state, province, county (in Ireland), Land (in Germany), departement (in France), etc.
`gd:postcode` ?	`postcode`	Postal code. Usually country-wide, but sometimes specific to the city (eg "2" in "Dublin 2, Ireland" addresses).
`gd: country` ?	`country`	The name or code of the country.
`gd:formattedAddress` ?	`formattedAddress`	The full, unstructured postal address.

rel values

Value	شرح
`http://schemas.google.com/g/2005#work`	Work address. Unless other provided this is the default value.
`http://schemas.google.com/g/2005#home`	Home address.
`http://schemas.google.com/g/2005#other`	Any other type of address.

mailClass values

Value	شرح
`http://schemas.google.com/g/2005#both`	Parcels and letters can be sent to the address. Unless other provided this is the default value.
`http://schemas.google.com/g/2005#letters`	Only letters can be sent to the address.
`http://schemas.google.com/g/2005#parcels`	Only parcels can be sent to the address.
`http://schemas.google.com/g/2005#neither`	Address is purely locational and cannot be used for mail.

usage values

Value	شرح
`http://schemas.google.com/g/2005#general`	This address is for general usage. Unless other provided this is the default value.
`http://schemas.google.com/g/2005#local`	This address is for local usage.

Examples

Corporate address:

mr. John Doe

Google Inc.

1600 Amphitheatre Parkway

Mountain View, CA 94043

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#letters' label='John at Google'>
  <gd:street>1600 Amphitheatre Parkway</gd:street>
  <gd:city>Mountain View</gd:city>
  <gd:region>CA</gd:region>
  <gd:postcode>94043</gd:postcode>
</gd:structuredPostalAddress>

Private address:

Madame Duval

27, rue Pasteur

14390 CABOURG

FRANCE

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#both' label='Madame Duval'>
  <gd:street>27, rue Pasteur</gd:street>
  <gd:city>CABOURG</gd:city>
  <gd:postcode>14390</gd:postcode>
  <gd:country>FRANCE</gd:country>
</gd:structuredPostalAddress>

Schema

start = structuredPostalAddress

structuredPostalAddress =
   element gd:structuredPostalAddress {
      attribute label { xs:string }?,
      attribute mailClass { xs:string }?,
      attribute primary { xs:boolean }?,
      attribute rel { xs:string }?,
      attribute usage { xs:string }?,
      (agent?
       & housename?
       & street?
       & poBox?
       & neighborhood?
       & city?
       & subregion?
       & region?
       & postcode?
       & country?
       & formattedAddress? )
}

Restrictions

It is forbidden to have both 'gd:postalAddress' and 'gd:structuredPostalAddress' in one entity.
Only one structured address can be specified as primary.
The unstructured postal address must be consistent with the structured data.

gd:when

Represents a period of time or an instant.

Properties

ویژگی	تایپ کنید	شرح
`@endTime` ?	`xs:dateTime` or `xs:date`	Describes when the event ends. If the timezone is not specified, the observer's local timezone is assumed.
`@startTime`	`xs:dateTime` or `xs:date`	Describes when the event starts or (for zero-duration events) when it occurs. If the timezone is not specified, the observer's local timezone is assumed.
`@valueString` ?	`xs:string`	A simple string value that can be used as a representation of this time period.

Restrictions

It's not possible to mix xs:dateTime with xs:date in startTime / endTime .
If endTime is not specified, then the event is considered to be an instant in time (if @startTime includes a time) or a one-day event (if @startTime is only a date).

Examples

A one-day event:

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

Alternative representation of a one-day event:

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

A two-day event (on June 6 and June 7) with a string description:

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

A one-hour meeting:

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

A zero-duration event:

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

Schema

start = when

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

gd:where

A place (such as an event location) associated with the containing entity. The type of the association is determined by the rel attribute; the details of the location are contained in an embedded or linked-to Contact entry.

A <gd:where> element is more general than a <gd:geoPt> element. The former identifies a place using a text description and/or a Contact entry, while the latter identifies a place using a specific geographic location.

Properties

ویژگی	تایپ کنید	شرح
`@label` ?	`xs:string`	Specifies a user-readable label to distinguish this location from other locations.
`@rel` ?	`xs:string`	Specifies the relationship between the containing entity and the contained location. Possible values (see below) are defined by other elements. For example, `<gd:when>` defines `http://schemas.google.com/g/2005#event` .
`@valueString` ?	`xs:string`	A simple string value that can be used as a representation of this location.
`gd: entryLink` ?	`entryLink`	Entry representing location details. This entry should implement the Contact kind.

rel values

Value	شرح
`http://schemas.google.com/g/2005#event` or not specified	Place where the enclosing event takes place.
`http://schemas.google.com/g/2005#event.alternate`	A secondary location. For example, a remote site with a videoconference link to the main site.
`http://schemas.google.com/g/2005#event.parking`	A nearby parking lot.

Examples

Event location:

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

More complicated event location:

<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>

Event with multiple locations:

<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"/>

Schema

start = where

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

gd:who

A person associated with the containing entity. The type of the association is determined by the rel attribute; the details about the person are contained in an embedded or linked-to Contact entry.

The <gd:who> element can be used to specify email senders and recipients, calendar event organizers, and so on.

Properties

ویژگی	تایپ کنید	شرح
`@email` ?	`xs:string`	آدرس ایمیل. This property is typically used when `<gd:entryLink>` is not specified. The address must comply with RFC 2822 , section 3.4.1.
`@rel` ?	`xs:string`	Specifies the relationship between the containing entity and the contained person. See below for possible values.
`@valueString` ?	`xs:string`	A simple string value that can be used as a representation of this person.
`gd: attendeeStatus` ?	`gEnumConstruct`	Status of event attendee. Extensible enum documented below.
`gd: attendeeType` ?	`gEnumConstruct`	Type of event attendee. Extensible enum documented below.
`gd: entryLink` ?	`entryLink`	Entry representing person details. This entry should implement the Contact kind. In many cases, this entry will come from a contact feed.

rel values

The valid values for @rel depend on which kind the <gd:who> element appears in.

Value	Kind	شرح
`http://schemas.google.com/g/2005#event.attendee`	رویداد	A general meeting/event attendee.
`http://schemas.google.com/g/2005#event.organizer`	رویداد	Event organizer. An organizer is not necessarily an attendee.
`http://schemas.google.com/g/2005#event.performer`	رویداد	Performer. Similar to `http://schemas.google.com/g/2005#event.speaker` , but with more emphasis on art than speech delivery.
`http://schemas.google.com/g/2005#event.speaker`	رویداد	Speaker.
`http://schemas.google.com/g/2005#message.bcc`	Message	Message BCC recipient.
`http://schemas.google.com/g/2005#message.cc`	Message	Message CC recipient.
`http://schemas.google.com/g/2005#message.from`	Message	Message (email or IM) sender.
`http://schemas.google.com/g/2005#message.reply-to`	Message	Intended recipient of a reply message.
`http://schemas.google.com/g/2005#message.to`	Message	Message primary recipient.

gd:attendeeType Values

Value	شرح
`http://schemas.google.com/g/2005#event.optional`	Optional attendee.
`http://schemas.google.com/g/2005#event.required`	Required attendee.

gd:attendeeStatus Values

Value	شرح
`http://schemas.google.com/g/2005#event.accepted`	Attendee has accepted.
`http://schemas.google.com/g/2005#event.declined`	Attendee has declined.
`http://schemas.google.com/g/2005#event.invited`	Invitation has been sent, but the person has not accepted.
`http://schemas.google.com/g/2005#event.tentative`	Attendee has accepted tentatively.

Examples

Email recipients:

<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"/>

Meeting attendee:

<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>

Event organizer:

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

Schema

start = who

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

Changes since 1.0

Changes to the contact kind

The following elements not present in version 1.0 were added in version 2.0 of the contact kind:

gd: name
gd: structuredPostalAddress
gd: where

The following phone types not present in version 1.0 were added in version 2.0:

http://schemas.google.com/g/2005#assistant
http://schemas.google.com/g/2005#callback
http://schemas.google.com/g/2005#car
http://schemas.google.com/g/2005#company_main
http://schemas.google.com/g/2005#isdn
http://schemas.google.com/g/2005#main
http://schemas.google.com/g/2005#other_fax
http://schemas.google.com/g/2005#radio
http://schemas.google.com/g/2005#telex
http://schemas.google.com/g/2005#tty_tdd
http://schemas.google.com/g/2005#work_mobile
http://schemas.google.com/g/2005#work_pager

The following IM type not present in version 1.0 was added in version 2.0:

http://schemas.google.com/g/2005#netmeeting

The following elements of the 1.0 contact kind are no longer supported:

atom:title — still present in entries returned by the server, but ignored on PUT and POST requests. Replaced by gd: name .
gd: postalAddress — replaced by gd: structuredPostalAddress .

Changes to `gd:email`

The new attribute @displayName was added in gd:email in 2.0

Changes to `gd:organization`

The following subelements of gd:organization were introduced in 2.0:

gd:orgDepartment
gd:orgJobDescription
gd:orgSymbol
gd:where

Changes to `gd:orgName`

In version 2.0 the element gd:orgName was enhanced by adding the @yomi attribute to it.