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

更新共用聯絡人的相片與更新共用聯絡人的資訊略有不同。如要瞭解如何使用共用聯絡人的資訊，請參閱「更新或刪除共用聯絡人」。使用相片連結時，您必須在 HTTP 標頭中指定授權權杖。詳情請參閱「瞭解驗證和授權」。

更新共用聯絡人的相片

每個共用聯絡人都有相片連結元素。無論聯絡人是否有相關聯的相片，都會顯示相片連結元素。如果聯絡人有相片，元素會包含 gd:etag 屬性，指定相片的 ETag HTTP 標頭。ETag 可讓您參照特定項目的特定版本。在此情況下，你可以參照特定版本的相片。如果聯絡人沒有相片，就不會有 gd:etag 屬性，而 href 屬性會提供可用來為聯絡人新增相片的網址。

  • 如要新增或更新相片，請傳送新相片：

    PUT https://www.google.com/m8/feeds/photos/media/USER_ID%40DOMAIN/PHOTO_LINK

    更改下列內容：

    • USER_ID：使用者名稱，例如 Alex。
    • 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/Alex%40example.com/c9012de">

刪除共用聯絡人的相片

如要刪除相片，請使用 HTTP DELETE 方法。

更新或刪除相片時，請在 HTTP 要求的 If-Match 標頭中傳送相片的 ETag。如果沒有最新版本的相片，請使用 If-Match: * 覆寫版本控管系統並刪除相片。

如要進一步瞭解 ETags，請參閱 Google Data API 通訊協定參考資料。