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

ה-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, או אף אחד מהרכיבים האלה, השרת ידחה את הרשומה.

תמיכה ב-Google Photos

יחד עם ערכים של מאפיינים רגילים, כמו עצמי או עריכה, אפשר להשתמש בערכים של 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 מלונות

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