更新或刪除已分享的聯絡人相片

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