עדכון או מחיקה של תמונה של איש קשר משותף

עדכון תמונה של איש קשר משותף שונה מעט מעדכון של הפרטים של איש הקשר ששותף. לקבלת מידע על עבודה עם פרטים של איש קשר, עדכון או מחיקה של איש קשר משותף. כשמשתמשים בקישורים לתמונות, צריך לציין את אסימון ההרשאה ב-HTTP הכותרת. מידע נוסף זמין במאמר הבא: מידע נוסף על אימות והרשאה

עדכון תמונה של איש קשר ששותף

לכל איש קשר משותף יש רכיב של קישור לתמונה. הרכיב של הקישור לתמונה מופיע אם לאיש הקשר יש תמונה משויכת או לא. אם לאיש הקשר יש תמונה, האלמנט מכיל מאפיין gd:etag שמציין ETag כותרת HTTP של התמונה. ETag מאפשר להתייחס לגרסה ספציפית של ערך מסוים. במקרה הזה, היא מאפשרת להתייחס לגרסה ספציפית של תמונה. אם לאיש הקשר אין תמונה, אין מאפיין gd:etag וגם המאפיין href מספק את כתובת ה-URL שבה רוצים להשתמש כדי להוסיף תמונה לאיש הקשר.

• כדי להוסיף או לעדכן תמונה, צריך לשלוח תמונה חדשה:

  PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/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.