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

העדכון של תמונה של איש קשר משותף שונה מעט מהעדכון של הפרטים של איש קשר משותף. מידע על עבודה עם פרטים של אנשי קשר משותפים זמין במאמר עדכון או מחיקה של אנשי קשר משותפים. כשמשתמשים בקישורים לתמונות, צריך לציין את אסימון ההרשאה בכותרת ה-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 של התמונה בכותרת If-Match של בקשת ה-HTTP. אם אין לכם את הגרסה האחרונה של התמונה, אתם יכולים להשתמש ב-If-Match: * כדי לעקוף את מערכת ניהול הגרסאות ולמחוק את התמונה.

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