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 dari kontak bersama yang ingin Anda publikasikan dalam bentuk elemen <entry> Atom dari Jenis kontak, yang mungkin terlihat seperti 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 hal berikut:

    • FIRST_NAME: Nama depan kontak bersama—misalnya, Alex.
    • LAST_NAME: Nama belakang kontak bersama—misalnya, Kim.
    • PRIMARY_EMAIL_ADDRESS: Alamat email pilihan untuk kontak bersama—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 instant messaging kontak bersama—misalnya, alk@gmail.com.
    • CITY_NAME: Nama kota untuk kontak bersama—misalnya, Mountain View.
    • ADDRESS: Alamat untuk kontak bersama—misalnya, 1600 Amphibious Blvd.
    • REGION_NAME: Negara bagian atau provinsi untuk kontak bersama—misalnya, CA.
    • POST_CODE: Kode pos untuk kontak bersama—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 dalam 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