רכיבים משותפים של אנשי קשר

ב-Domain Shared Contacts API נעשה שימוש ברכיבים הרגילים של Google Data API וברכיבים ספציפיים לאנשי קשר משותפים.

רשומה של איש קשר היא סוג איש קשר מורחב, שמייצג אדם, מקום – כמו מועדון או מסעדה – או ארגון. סוג איש הקשר מופיע ב-XML כרכיב <atom:entry> שמכיל רכיבי תוסף שונים ממרחב השמות של Google Data.

האלמנט category שמציין שהרשומה היא איש קשר נראה כך:

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

ב-Domain Shared Contacts API, יש כמה אלמנטים שהם מגבילים יותר מאשר סוג איש הקשר. עבור הרכיבים הבאים, צריך לספק מאפיין rel או מאפיין label, אבל לא את שניהם:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

כשיוצרים או מעדכנים איש קשר משותף, אם מספקים את הערכים rel ו-label, או לא מספקים אף אחד מהם, לשום אחד מהרכיבים האלה, השרת דוחה את הרשומה.

תמיכה ב-Photos

בנוסף לערכים של מאפיינים רגילים כמו self או edit, אפשר להשתמש בערכים של rel לאלמנטי atom:link. כשמשתמשים בקישורים לתמונות, צריך לציין אסימון הרשאה בכותרת ה-HTTP. למידע נוסף, ראו מידע על אימות והרשאה.

  • באמצעות הפקודה GET, הפונקציה rel="http://schemas.google.com/contacts/2008/rel#photo" מוסיפה את היכולת לקרוא את התמונה שמשויכת לאיש הקשר. אפשר להשתמש בכתובת ה-URL שצוינה ב-href כדי לקרוא את הגרסה העדכנית ביותר של התמונה שמשויכת לאיש הקשר. הקישור לא יוצג אם אין תמונה של איש הקשר.

דוגמה:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • באמצעות הפקודה PUT או DELETE, הפקודה rel="http://schemas.google.com/contacts/2008/rel#edit-photo" מוסיפה את היכולת לעדכן או למחוק תמונה מקומית שמשויכת לאיש הקשר.

דוגמה:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

מרחב השמות gContact

כתובת ה-URL של מרחב השמות של ה-XML עבור gContact היא http://schemas.google.com/contact/2008.

במרחב השמות הזה מוגדר רכיב שמייצג קבוצה שאליה שייך איש הקשר.

gContact:groupMembershipInfo מלונות

נכס תיאור
href מזהה את הקבוצה שאליה איש הקשר שייך או השתייך. הפנייה לקבוצה מתבצעת לפי המזהה שלה.
deleted="true" המשמעות היא שההשתייכות של איש הקשר לקבוצה הוסרה. המאפיין הזה נכלל רק אם showdeleted צוין כפרמטר של שאילתה. אחרת, לא יוחזר הערך של groupMembershipInfo עבור קבוצות שהאיש הקשר כבר לא שייך אליהן.