Memperbarui atau menghapus kontak bersama

Proses untuk memperbarui atau menghapus kontak bersama juga serupa.

Memperbarui kontak bersama

Saat mengupdate entri, Anda harus mempertahankan semua XML yang ada saat mengambil entri dari server. Jika tidak, elemen yang diabaikan akan dihapus. Perubahan dapat memerlukan waktu hingga 24 jam untuk ditampilkan di pelengkapan otomatis alamat email dan pengelola kontak.

Untuk memperbarui kontak bersama yang sudah ada, lakukan hal berikut:

  1. Dapatkan entri yang ingin diperbarui.
  2. Edit entri.

  3. Kirim permintaan PUT dengan entri yang diperbarui dalam isi pesan ke URL edit kontak. Gunakan jenis konten application/atom+xml dan pastikan nilai <id> dalam entri yang diperbarui sama persis dengan <id> entri yang ada. URL edit diakhiri dengan nomor versi, untuk mendeteksi konflik update dari sumber yang berbeda. Untuk mengetahui informasi selengkapnya, lihat pembuatan versi.

    Perbarui entri:

    <entry>
  <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
  <updated>2008-02-28T18:47:02.303Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>TITLE_NAME</title>
  <gd:name>
    <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <content type='text'>NOTES</content>
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
  <link rel='edit' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
    primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
  <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
</entry>

    Ganti hal berikut:

    • DOMAIN: URL untuk domain Anda—misalnya, example.com.
    • TITLE_NAME: Nama untuk entri kontak—misalnya, daftar kontak example.com.
    • FIRST_NAME: Nama depan kontak bersama—misalnya, Alex.
    • LAST_NAME: Nama belakang kontak bersama—misalnya, Kim.
    • PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk daftar nilai yang didukung, lihat Nilai proyeksi.
    • PRIMARY_PHONE_NUMBER: Nomor telepon yang dipilih untuk kontak bersama—misalnya, (206)555-1212.
    • CUSTOM_PROPERTY: Nama untuk properti kustom yang ingin Anda simpan tentang kontak bersama—misalnya, hewan peliharaan.

    • CUSTOM_PROPRTY_VALUE: Nilai untuk properti kustom yang ingin Anda simpan tentang kontak bersama—misalnya, hamster.

      Berikut adalah contoh entri yang diperbarui untuk kontak bersama dengan URL edit yang ditandai:

      <entry>
<id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
<updated>2008-02-28T18:47:02.303Z</updated>
<category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#contact' />
<title type='text'>Fitzgerald</title>
<gd:name>
  <gd:fullName>Fitzgerald</gd:fullName>
</gd:name>
<content type='text'>Notes</content>
<link rel='self' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
<link rel='edit' type='application/atom+xml'
  href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
<gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
  primary='true'>456-123-2133</gd:phoneNumber>
<gd:extendedProperty name="pet" value="hamster" />
<gd:extendedProperty name="cuisine">
  <italian />
</gd:extendedProperty>
</entry>

Hapus kontak bersama

Kontak bersama yang dihapus dapat memerlukan waktu hingga 24 jam agar hilang dari pelengkapan otomatis alamat email dan pengelola kontak. Untuk memperbarui kontak yang ada, lihat Memperbarui kontak. Jangan perbarui kontak dengan menghapus kontak lalu menambahkannya kembali.

  • Untuk menghapus kontak bersama, kirim permintaan DELETE ke URL edit kontak tersebut. URL ini adalah URL yang sama dengan yang digunakan untuk memperbarui kontak.

Google menyimpan placeholder untuk kontak yang dihapus selama 30 hari setelah penghapusan. Selama waktu tersebut, Anda dapat meminta placeholder menggunakan parameter kueri showdeleted.

Langkah berikutnya

Memperbarui atau menghapus foto untuk kontak bersama