Buat kontak bersama

Setelah menyiapkan autentikasi, Anda dapat menggunakan 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 alamat email dan pengelola kontak.

  1. Buat representasi XML kontak bersama yang ingin Anda publikasikan dalam bentuk elemen <entry> Atom dari Jenis kontak, yang mungkin terlihat mirip dengan berikut:

    <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 yang dibagikan—misalnya, Alex.
    • LAST_NAME: Nama belakang kontak yang dibagikan—misalnya, Kim.
    • PRIMARY_EMAIL_ADDRESS: Alamat email yang diinginkan untuk kontak yang dibagikan—misalnya, alk@gmail.com.
    • PREFERRED_NAME: Nama yang ditampilkan untuk pengguna—misalnya, Alex Kim
    • SECONDARY_EMAIL_ADDRESS: Alamat email lain untuk kontak bersama—misalnya, alk@example.org.
    • PRIMARY_PHONE_NUMBER: Nomor telepon pilihan untuk kontak bersama—misalnya, (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: Nomor telepon lain untuk kontak bersama—misalnya, (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: Alamat email yang terkait dengan informasi pesan instan kontak yang dibagikan—misalnya, alk@gmail.com.
    • CITY_NAME: Nama kota untuk kontak yang dibagikan—misalnya, Bogor.
    • ADDRESS: Alamat jalan untuk kontak bersama—misalnya, 1600 Amphibious Blvd.
    • REGION_NAME: Negara bagian atau provinsi untuk kontak bersama—misalnya, CA.
    • POST_CODE: Kode pos untuk kontak yang dibagikan—misalnya, 94045.
    • COUNTRY_NAME: Negara untuk kontak bersama—misalnya, Amerika Serikat.
    • FORMATTED_ADDRESS: Alamat kontak bersama yang diformat menggunakan konvensi negara atau wilayah mereka—misalnya,1800 Amphibious Blvd Mountain View.

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

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

    Misalnya, untuk menambahkan kontak bersama domain ke daftar milik example.com, kirim permintaan POST dengan entri baru ke URL berikut:

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

    Server Google membuat kontak menggunakan entri yang Anda kirim, lalu menampilkan kode status HTTP 201 CREATED, beserta salinan kontak baru dalam bentuk elemen <entry>. Entri yang ditampilkan sama dengan yang Anda kirim, tetapi juga berisi berbagai elemen yang ditambahkan oleh server, seperti elemen <id>.

    Jika permintaan Anda gagal, Google mungkin menampilkan kode status yang berbeda. Untuk mengetahui informasi tentang kode status, lihat dokumen referensi protokol Google Data API.

Langkah berikutnya