יש הבדל קל בין עדכון התמונה של איש קשר משותף לבין עדכון הפרטים שלו. למידע נוסף על עבודה עם פרטי איש קשר ששותפו, ראו עדכון או מחיקה של איש קשר ששותף. כשמשתמשים בקישורים לתמונות, צריך לציין את אסימון ההרשאה בכותרת ה-HTTP. למידע נוסף, ראו מידע על אימות והרשאה.
איך מעדכנים תמונה של איש קשר משותף
לכל איש קשר ששותף יש רכיב של קישור לתמונה. רכיב הקישור לתמונה מופיע גם אם לאיש הקשר יש תמונה משויכת וגם אם אין לו. אם לאדם יש תמונה, האלמנט מכיל את המאפיין gd:etag שמציין כותרת HTTP ETag של התמונה. בעזרת ETag אפשר להפנות לגרסה ספציפית של רשומה מסוימת. במקרה הזה, הוא מאפשר להפנות לגרסה ספציפית של תמונה. אם לאיש הקשר אין תמונה, לא יהיה מאפיין gd:etag, והמאפיין href יספק את כתובת ה-URL שבה משתמשים כדי להוסיף תמונה לאיש הקשר.
כדי להוסיף או לעדכן תמונה, שולחים תמונה חדשה:
PUT https://www.google.com/m8/feeds/photos/media/liz%40
DOMAIN /PHOTO_LINK מחליפים את מה שכתוב בשדות הבאים:
DOMAIN: כתובת ה-URL של הדומיין שלכם – לדוגמה, example.com.PHOTO_LINK: ערך מספרי ייחודי שמייצג את הקישור לתמונה של איש הקשר ששותף – לדוגמה, c9012de.
דוגמה לאלמנט קישור לתמונה:
<link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*" href="https://www.google.com/m8/feeds/photos/media/liz%40example.com/c9012de">
מחיקת תמונה של איש קשר משותף
כדי למחוק תמונה, צריך להשתמש ב-method DELETE ב-HTTP.
כשמעדכנים או מוחקים תמונה, שולחים את ETag של התמונה בכותרת If-Match של בקשת ה-HTTP. אם אין לכם את הגרסה האחרונה של התמונה, תוכלו להשתמש ב-If-Match: * כדי לשנות את מערכת הגרסאות ולמחוק את התמונה.
מידע נוסף על ETags זמין בחומר העזרה בנושא פרוטוקול Google Data APIs.