Memperbarui atau menghapus kontak bersama

Proses untuk memperbarui atau menghapus kontak bersama serupa.

Memperbarui kontak bersama

Saat memperbarui entri, Anda harus mempertahankan semua XML yang ada saat Anda mengambil entri dari server. Jika tidak, elemen yang diabaikan akan dihapus. Pembaruan dapat memerlukan waktu hingga 24 jam agar terlihat dalam pelengkapan otomatis alamat email dan pengelola kontak.

Untuk memperbarui kontak bersama yang 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 berbagai sumber. Untuk 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 kode 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 yang dibagikan—misalnya, Alex.
    • LAST_NAME: Nama belakang kontak bersama—misalnya, Kim.
    • PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk mengetahui daftar nilai yang didukung, lihat Nilai proyeksi.
    • PRIMARY_PHONE_NUMBER: Nomor telepon pilihan 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>

Menghapus kontak bersama

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

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

Google mempertahankan 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