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

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