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

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