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

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

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

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

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

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

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

  • ‫USER_ID: שם המשתמש של המשתמש – לדוגמה, Alex.
  • ‫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/Alex%40example.com/c9012de">
  

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

כדי למחוק תמונה, צריך להשתמש בשיטת ה-HTTP ‏DELETE.

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

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