共有連絡先の写真の更新は、共有連絡先の情報の更新とは若干異なります。共有連絡先の情報の操作については、共有連絡先の更新または削除をご覧ください。写真リンクを使用する場合は、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 API プロトコル リファレンスをご覧ください。