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

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