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

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

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

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

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

  PUT https://www.google.com/m8/feeds/photos/media/liz%40DOMAIN/PHOTO_LINK
  

  מחליפים את מה שכתוב בשדות הבאים:

  • DOMAIN: כתובת האתר של הדומיין שלכם — לדוגמה, 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">
  

מחיקת תמונה של איש קשר משותף

כדי למחוק תמונה, עליך להשתמש בשיטה DELETE של HTTP.

כשמעדכנים או מוחקים תמונה, צריך לשלוח את ETag של התמונה בכותרת If-Match של בקשת ה-HTTP. אם לא מותקנת הגרסה האחרונה של התמונה, תוכלו להשתמש ב-If-Match: * כדי לשנות את מערכת ניהול הגרסאות ולמחוק את התמונה.

למידע נוסף על ETags, קראו את החומר לעיון בנושא הפרוטוקול של Google Data APIs.