更新共用聯絡人的相片與更新共用聯絡人的資訊略有不同。如要進一步瞭解如何使用共用聯絡人的資訊,請參閱「更新或刪除共用聯絡人」。使用相片連結時,您必須在 HTTP 標頭中指定授權權杖。詳情請參閱「瞭解驗證和授權」。
更新共用聯絡人的相片
每個共用聯絡人都有相片連結元素。無論聯絡人是否有相關聯的相片,相片連結元素都會顯示。如果聯絡人有相片,元素就會包含 gd:etag
屬性,用於指定相片的 ETag
HTTP 標頭。ETag
可讓您參照特定項目的特定版本。在本例中,您可以參照特定版本的照片。如果聯絡人沒有相片,就沒有 gd:etag
屬性,而 href
屬性會提供用於為聯絡人新增相片的網址。
如要新增或更新相片,請傳送新的相片:
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">
刪除共用聯絡人的相片
如要刪除相片,您必須使用 HTTP DELETE
方法。
更新或刪除相片時,請在 HTTP 要求的 If-Match
標頭中傳送相片的 ETag
。如果您沒有最新版本的照片,請使用 If-Match: *
覆寫版本系統並刪除相片。
如要進一步瞭解 ETags
,請參閱 Google Data API 通訊協定參考資料。