Buat kontak bersama

Setelah menyiapkan autentikasi, gunakan Domain Shared Contacts API untuk memublikasikan entri kontak bersama baru ke domain Google Workspace. Kontak bersama dapat memerlukan waktu hingga 24 jam untuk muncul di pelengkapan otomatis dan pengelola kontak.

  1. Buat representasi XML dari kontak bersama untuk dipublikasikan sebagai elemen Atom <entry> dari Contact kind:

    <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'>
  <atom:category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <gd:name>
     <gd:givenName>FIRST_NAME</gd:givenName>
     <gd:familyName>LAST_NAME</gd:familyName>
     <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
  </gd:name>
  <atom:content type='text'>NOTES</atom:content>
  <gd:email rel='http://schemas.google.com/g/2005#work'
    primary='true'
    address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
  <gd:email rel='http://schemas.google.com/g/2005#home'
    address='SECONDARY_EMAIL_ADDRESS' />
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
    primary='true'>
    PRIMARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    SECONDARY_PHONE_NUMBER
  </gd:phoneNumber>
  <gd:im address='INSTANT_MESSAGING_ADDRESS'
    protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
    primary='true'
    rel='http://schemas.google.com/g/2005#home' />
  <gd:structuredPostalAddress
      rel='http://schemas.google.com/g/2005#work'
      primary='true'>
    <gd:city>CITY_NAME</gd:city>
    <gd:street>ADDRESS</gd:street>
    <gd:region>REGION_NAME</gd:region>
    <gd:postcode>POST_CODE</gd:postcode>
    <gd:country>COUNTRY_NAME</gd:country>
    <gd:formattedAddress>
      FORMATTED_ADDRESS
    </gd:formattedAddress>
  </gd:structuredPostalAddress>
</atom:entry>

    Ganti kode berikut:

    • FIRST_NAME: Nama depan kontak, seperti Dana.
    • LAST_NAME: Nama belakang kontak, seperti A.
    • PRIMARY_EMAIL_ADDRESS: Alamat email pilihan, seperti dana@example.com.
    • PREFERRED_NAME: Nama tampilan untuk pengguna, seperti Dana A.
    • SECONDARY_EMAIL_ADDRESS: Email sekunder, seperti da@example.com.
    • PRIMARY_PHONE_NUMBER: Nomor telepon pilihan, seperti 800-555-0100.
    • SECONDARY_PHONE_NUMBER: Nomor telepon sekunder, seperti 800-555-0101.
    • INSTANT_MESSAGING_ADDRESS: Alamat email pesan instan, seperti dana@example.com.
    • CITY_NAME: Nama kota, seperti Mountain View.
    • ADDRESS: Alamat jalan, seperti 1800 Amphibious Blvd.
    • REGION_NAME: Negara bagian atau provinsi, seperti CA.
    • POST_CODE: Kode ZIP atau kode pos, seperti 94045.
    • COUNTRY_NAME: Negara, seperti Amerika Serikat.
    • FORMATTED_ADDRESS: Alamat yang diformat menggunakan konvensi lokal, seperti 1800 Amphibious Blvd., Mountain View, CA 94045, USA.

  2. Untuk memublikasikan entri ini, kirimkan ke URL feed daftar kontak:

    1. Tempatkan elemen Atom <entry> di isi permintaan POST baru menggunakan jenis konten application/atom+xml.
    2. Kirim permintaan POST ke URL feed.

    Misalnya, untuk menambahkan kontak ke daftar example.com, kirim permintaan POST ke URL berikut:

    https://www.google.com/m8/feeds/contacts/example.com/full

    Server membuat kontak dan menampilkan kode status HTTP 201 CREATED, beserta entri kontak baru. Entri yang ditampilkan mencakup elemen yang dibuat server seperti <id>.

    Jika permintaan gagal, server akan menampilkan kode status yang berbeda. Lihat referensi protokol Google Data API.

Langkah berikutnya