更新共用聯絡人的相片與更新共用聯絡人的資訊稍有不同。如要瞭解如何使用共用聯絡人的資訊,請參閱「更新或刪除共用聯絡人」。使用相片連結時,您必須在 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 通訊協定參考資料。