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

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

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

האלמנט 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 לקבוצות שאליהן איש הקשר כבר לא משתייך.