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

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

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

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

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

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

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

    • 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/liz%40example.com/c9012de">
    

共有した連絡先の写真を削除する

写真を削除するには、HTTP DELETE メソッドを使用する必要があります。

写真を更新または削除する場合は、HTTP リクエストの If-Match ヘッダーで写真の ETag を送信します。最新バージョンの写真がない場合は、If-Match: * を使用してバージョニング システムをオーバーライドし、写真を削除します。

ETags の詳細については、Google Data APIs プロトコル リファレンスをご覧ください。