共有連絡先の写真を更新、削除する

共有連絡先の写真を更新する方法は、共有連絡先の情報を更新する方法とは少し異なります。共有連絡先の情報の操作については、共有連絡先を更新または削除するをご覧ください。写真リンクを使用する場合は、HTTP ヘッダーで認証トークンを指定する必要があります。詳細については、認証と認可についてをご覧ください。

共有連絡先の写真を更新する

共有連絡先には写真リンク要素があります。連絡先に写真が関連付けられているかどうかに関係なく、写真リンク要素が表示されます。連絡先に写真がある場合、要素には写真の ETag HTTP ヘッダーを指定する gd:etag 属性が含まれます。ETag を使用すると、特定のエントリの特定のバージョンを参照できます。この場合、写真の特定のバージョンを参照できます。連絡先に写真がない場合、gd:etag 属性は存在せず、href 属性は連絡先に写真を追加するために使用する URL を提供します。

  • 写真を追加または更新するには、新しい写真を送信します。

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

    次のように置き換えます。

    • USER_ID: ユーザーのユーザー名（例: Alex）。
    • DOMAIN: ドメインの URL（例: 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 APIs プロトコル リファレンスをご覧ください。