Memperbarui atau menghapus foto untuk kontak bersama

Memperbarui foto untuk kontak bersama sedikit berbeda dengan memperbarui informasi kontak bersama. Untuk mengetahui informasi tentang cara menggunakan informasi kontak bersama, lihat Memperbarui atau menghapus kontak bersama. Saat menggunakan link foto, Anda harus menentukan token otorisasi di header HTTP. Untuk mengetahui informasi lebih lanjut, baca bagian Mempelajari autentikasi dan otorisasi.

Memperbarui foto untuk kontak bersama

Setiap kontak bersama memiliki elemen link foto. Elemen link foto akan muncul, terlepas dari apakah kontak memiliki foto terkait atau tidak. Jika kontak memiliki foto, berarti elemen tersebut berisi atribut gd:etag yang menentukan header HTTP ETag untuk foto. ETag memungkinkan Anda merujuk ke versi tertentu dari entri tertentu. Dalam hal ini, fitur ini memungkinkan Anda merujuk ke sesi foto tertentu. Jika kontak tidak memiliki foto, berarti tidak ada atribut gd:etag, dan atribut href menyediakan URL yang akan digunakan untuk menambahkan foto ke kontak.

  • Untuk menambahkan atau memperbarui foto, kirim foto baru:

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

    Ganti hal berikut:

    • DOMAIN: URL untuk domain Anda—misalnya, example.com.
    • PHOTO_LINK: Nilai numerik unik yang merepresentasikan link foto untuk kontak bersama—misalnya, c9012de.

    Berikut adalah contoh elemen link foto:

    <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">
    

Menghapus foto untuk kontak bersama

Untuk menghapus foto, Anda harus menggunakan metode DELETE HTTP.

Saat memperbarui atau menghapus foto, kirim ETag foto di header If-Match pada permintaan HTTP. Jika Anda tidak memiliki versi foto terbaru, gunakan If-Match: * untuk mengganti sistem pembuatan versi dan menghapus foto.

Untuk informasi selengkapnya tentang ETags, lihat referensi protokol Google Data API.