العناصر الشائعة: "الأنواع"

المقدمة

وغالبًا ما يكون ذلك مفيدًا للخدمات التي تستخدم واجهات برمجة التطبيقات للبيانات في Google حتى تتمكن من تقديم مجموعة متسقة من المعلومات عن نوع معين من العناصر.

على سبيل المثال، قد توفر خدمات واجهة برمجة التطبيقات لبيانات Google (أو "GData") المتنوعة معلومات الاتصال لشخص أو مؤسسة؛ لذا فمن المنطقي أن تستخدم جميع هذه الخدمات نفس مجموعة عناصر معلومات الاتصال.

يُطلق على مجموعة العناصر التي تصف جهة اتصال معًا اسم جهة الاتصال "نوع". بعض العناصر في نوع جهة الاتصال هي عناصر Atom أو RSS عادية، بينما تعرّف Google عناصر أخرى في مساحة اسم تسمى "مساحة اسم بيانات Google". عادةً ما تتم الإشارة إلى مساحة اسم بيانات Google في رمز XML باستخدام الاسم المستعار gd:، على سبيل المثال، العنصر الذي يحتوي على رقم هاتف أو فاكس هو <gd:phoneNumber>. عنوان URL للمخطط لمساحة اسم بيانات Google هو http://schemas.google.com/g/2005.

كما تحدد Google الأنواع الأخرى أيضًا: الحدث (مجموعة من العناصر الموحدة التي تمثل معًا حدث تقويم) والرسالة (مجموعة من العناصر التي تمثل رسالة إلكترونية أو مشاركة في مجموعة مناقشة أو رسالة أخرى).

يتم استخدام بعض العناصر من مساحة الاسم لبيانات Google بواسطة أنواع متعددة. على سبيل المثال، يربط العنصر <gd:who> شخصًا (يتم وصفه في <gd:who>) بإدخال يحتوي على العنصر <gd:who>. يتم استخدام هذا العنصر في نوع الحدث لتحديد المنظمين والحضور وما إلى ذلك. كما يتم استخدامه أيضًا في نوع الرسالة لتحديد المرسلين والمستلمين.

عندما يستخدم إدخال في خلاصة واجهة برمجة التطبيقات لبيانات Google نوعًا معينًا، فإنه يحتوي على عنصر <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> في نوع جهة الاتصال، وعلى الرغم من أن <atom:author> عنصر مطلوب في إدخال (ما لم يتم تحديده في الخلاصة الرئيسية)، إلا أنه لا يحمل معنى مفيدًا في نوع جهة الاتصال.

جارٍ إنشاء الأنواع

قد يكون من الصعب معرفة المعلومات التي يجب تضمينها بالضبط عند إنشاء مشاركة من نوع معين، خاصة لأن بعض العناصر في الأنواع تشتمل على أنواع أخرى.

من بين الطرق المفيدة لاستخدام مكتبات العملاء التي نقدمها بدلاً من محاولة إنشاء الأنواع يدويًا. توفر مكتبات العملاء طرقًا متنوعة لإضافة البيانات وتغييرها في إدخال من نوع معيّن. راجع وثائق مكتبة العميل للحصول على التفاصيل.

إمكانية التمديد

لا تشمل المعلومات الواردة في هذا المستند جميع الخصائص المحتملة وقيم السمات للأنواع. قد توسع الخدمات أنواعًا معينة، ولذلك قد تستخدم خدمة معينة خصائص وقيمًا غير مضمنة في هذا المستند.

اصطلاحات لغوية

في الجداول في هذا المستند، نستخدم الأعراف التالية للعناصر المطلوبة والاختيارية:

اسم العنصر العنصر المطلوب
itemName? عنصر اختياري
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'] بصفحة HTML تصف جهة الاتصال.
atom:title اسم جهة الاتصال.
gd:email* عناوين البريد الإلكتروني.
gd: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'] رابطًا إلى صفحة HTML تصف الحدث.
atom:title عنوان مختصر للفعالية.
gd:comments؟ خلاصة التعليقات.
gd:eventStatus؟ تم توثيق التعداد الموسع أدناه.
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

قيمة 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:visibility

القيمة الوصف
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

تندرج كل الفئات أدناه ضمن مخطط 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 مستلم النسخة المخفية الوجهة
http://schemas.google.com/g/2005#message.cc مستلم نسخة إلى الرسالة.
http://schemas.google.com/g/2005#message.from مُرسِل الرسالة (البريد الإلكتروني أو الرسائل الفورية)
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

يتكون الجزء المتبقي من هذا المستند من مواد مرجعية للعناصر المستخدمة في الأنواع.

عمليات التعداد

تحتاج بعض عناصر الإضافات إلى تحديد المواقع التي تأتي قيمها من مجموعة تعداد. الشكل العام لهذه الخصائص هو:

<gd:propertyName value="propertyValue">

إذا جاءت قيمة الموقع من مساحة الاسم لبيانات Google، فإنها تتخذ الشكل http://schemas.google.com/g/2005#{kind}.{value}. على سبيل المثال: http://schemas.google.com/g/2005#event.tentative إذا كانت مساحة القيمة قابلة للامتداد، فقد تكون القيم أيضًا على هيئة معرف موارد منتظم (URI). النموذج المقترح لعناوين URL ذات القيمة الموسّعة هو {schema URI}#{value}. على سبيل المثال: http://www.example.com/attendeeStatus#AudioConference

gEnumConstruct =
   attribute value { text },
   anyAttribute*

خصائص gdCommonProperties

الخصائص الشائعة المستخدمة لجميع أنواع Google. تجدر الإشارة إلى أن وجود anyAttribute وanyElement في المخطط يسمحان بتمديد جميع عناصر مساحة اسم "بيانات Google" التي تستخدم الخصائص المشتركة بشكل أكبر في أي مساحة اسم. على وجه الخصوص، من القانوني دمج أي عنصر 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:

يحتوي على خلاصة تعليقات لإدخال التضمين (مثل حدث تقويم).

أماكن إقامة

الخاصية النوع الوصف
@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: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) الموسَّعة للخاصية الصيغة {scheme}#{local-name} عادةً.
@value؟ xs:string قيمة الخاصية.

مثال

معرّف خارجي لحدث تقويم:

<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*)
   }

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 قيمة سلسلة بسيطة يتم استخدامها لتسمية هذا الموقع. تسمح لواجهات المستخدم بعرض تصنيف مثل "الموضع الحالي".
@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 عنوان المراسلة الفورية.
@label؟ xs:string قيمة سلسلة بسيطة تستخدم لتسمية عنوان المراسلة الفورية هذا. تسمح لواجهات المستخدم بعرض تصنيف مثل "العمل" أو "شخصي" أو "مفضل" أو ما إلى ذلك.
@rel؟ xs:string قيمة آلية تحدد نوع الرسائل الفورية، انظر أدناه لمعرفة التفاصيل.
@protocol؟ xs:string لتحديد شبكة الرسائل الفورية. يمكن أن تكون القيمة إما إحدى القيم القياسية (الموضحة أدناه) أو معرف الموارد المنتظم (URI) لتحديد شبكة الرسائل الفورية (IM) المملوكة.
@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

قيم سمة البروتوكول

يعرض الجدول التالي بعض القيم المحتملة المحتملة للسمة @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 بروتوكول Yahoo Messenger
http://schemas.google.com/g/2005#SKYPE بروتوكول 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 بروتوكول Jabber

أمثلة

عنوان مراسلة فورية لمراسلة MSN:

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

عنوان مراسلة فورية يقدّمها المستخدم مع بروتوكول غير محدّد. يُعد هذا العنوان مفيدًا لأغراض العرض، ولكن يصعب معالجته برمجيًا.

<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

يعادل موقع معرّف التكرار المحدد في القسم 4.8.4.4 من RFC 2445. تظهر في كل مثيل من حدث متكرر، لتحديد الحدث الأصلي.

يحتوي على عنصر <gd:when> يحدد وقت البدء الأصلي للمثيل الذي أصبح استثناءً.

أماكن إقامة

الخاصية النوع الوصف
@id xs:string رقم تعريف الحدث الأصلي.
@href xs:string عنوان URL لخلاصة الحدث الخاص بالحدث الأصلي.

مثال

تحديد حدث أصلي:

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

رقم هاتف مرتبط بالكيان المتضمّن (الذي يمثل عادة كيانًا يمثل شخصًا أو موقعًا).

أماكن إقامة

الخاصية النوع الوصف
@label؟ xs:string قيمة سلسلة بسيطة يتم استخدامها لتسمية رقم الهاتف هذا. في معظم الحالات، لا يكون @label ضروريًا لأنّ @rel يحدّد رقمًا بشكل فريد ويسمح لواجهات المستخدم بعرض تصنيف صحيح، مثلاً "جوّال" أو "منزل" أو "عمل" وغير ذلك. ولكن في حال كان لدى مستخدم واحد (على سبيل المثال) عدة هواتف جوّالة، يمكن استخدام هذه الخاصية لبيانها بوضوح.
@rel؟ xs:string قيمة آلية تحدد نوع رقم الهاتف، انظر أدناه للاطلاع على التفاصيل.
@uri؟ xs:string "معرّف الموارد المنتظم (URI) للهاتف" الاختياري المُستخدَم لتمثيل الرقم بطريقة رسمية، وهو مفيد للوصول الآلي، مثل جسر VoIP/بروتوكول PSTN. راجع RFC 3966 للحصول على مزيد من المعلومات حول معرفات الموارد المنتظمة (URI) للهاتف.
@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 أخرى ذات معنى. على سبيل المثال، جهاز TTY. يمكن استخدام 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)
   }

التقييم:التقييم

يمثل تقييمًا رقميًا للكيان المتضمن، مثل تعليق. يوفر كل تقييم مقياسه الخاص، على الرغم من أنه يمكن تسويته من خلال خدمة. على سبيل المثال، قد تحوِّل بعض الخدمات جميع التقييمات إلى مقياس من 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"/>

تم التقييم بواسطة 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 و/DATE EXRULE و/أو EXDATE التي تعرّف الحدث المتكرر واستثناءاته بشكل جماعي (انظر أدناه). (راجع القسم 4.8.5 من RFC 2445 للحصول على مزيد من المعلومات عن خصائص مكوّنات التكرار هذه.) وأخيرًا، يتوفّر مكوّن VTIMEZONE، وهو يوفّر قواعد مفصّلة للمنطقة الزمنية لأي معرّف منطقة زمنية مذكور في الخصائص السابقة.

لا تنشئ خدمات Google، مثل "تقويم Google"، بشكلٍ عام خصائص 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:recurrenceException

يمثل حدثًا استثنائيًا من حدث متكرّر، أي حدث متكرّر تم فيه تغيير جانب واحد أو أكثر من الحدث المتكرر (مثل قائمة الحضور أو الوقت أو الموقع الجغرافي).

يحتوي على عنصر <gd:originalEvent> الذي يحدّد الفعالية المتكرّرة الأصلية التي تُعد هذه الفعالية استثناءً لها.

عند تغيير حدث متكرّر من حدث متكرّر، يصبح هذا المثيل استثناءً. استنادًا إلى التغيير الذي أجريته، يعمل الاستثناء بإحدى طريقتين مختلفتين عند تغيير الحدث المتكرر الأصلي:

  • إذا أضفت تعليقات أو ضيوف أو ردود على الحضور أو غيّرتها أو أزلتها، سيظل الاستثناء مرتبطًا بالحدث الأصلي، كما تؤدي التغييرات على الحدث الأصلي إلى تغيير الاستثناء أيضًا.
  • إذا أجريت أي تغييرات أخرى على الاستثناء (مثل تغيير الوقت أو الموقع)، يصبح المثيل "متخصصًا"، مما يعني أنه لم يعد مرتبطًا بإحكام بالحدث الأصلي. إذا غيّرت الحدث الأصلي، لن تتغير الاستثناءات المتخصصة. ولكن انظر أدناه.

على سبيل المثال، لنفترض أن لديك اجتماعًا كل ثلاثاء وخميس في الساعة 2:00 بعد الظهر. وإذا غيَّرت قائمة الحضور لاجتماع يوم الخميس هذا (لكن ليس للاجتماع المجدول بانتظام)، يصبح الحدث استثناءً. وإذا غيّرت الوقت اللازم لاجتماع يوم الخميس هذا (ولكن ليس موعد الاجتماع الذي تمت جدولته بانتظام)، يصبح عندئذٍ متخصصًا.

بغض النظر عما إذا كان هناك استثناء متخصص أم لا، إذا حذفت شيئًا يحذف المثيل الذي اشتق منه الاستثناء، فسيتم حذف الاستثناء. تجدر الإشارة إلى أن تغيير اليوم أو الوقت لأحد الأحداث المتكررة يؤدي إلى حذف جميع الأحداث وإنشاء أحداث جديدة.

على سبيل المثال، بعد التخصّص في اجتماع يوم الخميس هذا، لنفترض أنك غيّرت الاجتماع المتكرر إلى أيام الاثنين والأربعاء والجمعة. يؤدي هذا التغيير إلى حذف جميع الأحداث المتكررة لاجتماع الثلاثاء/الخميس، بما في ذلك الحدث المتخصص.

إذا تم حذف حدث معيّن من حدث متكرّر، سيظهر هذا الحدث في صورة <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: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. ولتحديد مدة مختلطة، يمكنك التحويل إلى الوحدة الأكثر دقة. على سبيل المثال، لتحديد ساعة و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>

الاجتماع ذاته كما هو موضح أعلاه، ولكن تم تأجيله لمدة 10 دقائق بعد التذكير في الساعة 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>

المخطط

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

معرّف مورد غير شفاف، يختلف عن atom:id لأنه لا يلزم أن يكون URI صالحًا. تقدم بعض الخدمات معرّفًا منفصلاً لاستخدامه عند إنشاء طلبات لاحقة. الاستخدام الدقيق خاص بالخدمة.

مثال

<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 قيمة سلسلة بسيطة يمكن استخدامها لتمثيل هذه الفترة الزمنية.

القيود

  • لا يمكن مزج xs:dateTime مع xs:date في startTime/endTime.
  • إذا لم يتم تحديد 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>. يجب أن يتوافق العنوان مع RFC 2822، القسم 3.4.1.
@rel؟ xs:string لتحديد العلاقة بين الكيان المتضمن والشخص المتضمن. انظر أدناه للاطلاع على القيم المحتملة.
@valueString؟ xs:string قيمة سلسلة بسيطة يمكن استخدامها لتمثيل هذا الشخص.
gd:attendeeStatus؟ gEnumConstruct حالة ضيف الحدث. تم توثيق التعداد الموسع أدناه.
gd:attendeeType؟ gEnumConstruct نوع ضيف الحدث. تم توثيق التعداد الموسع أدناه.
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 الرسالة مُرسِل الرسالة (البريد الإلكتروني أو الرسائل الفورية)
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 }?)
   }

الرجوع إلى الأعلى