Elemen kontak bersama

Domain Shared Contacts API menggunakan elemen Google Data API standar dan elemen yang khusus untuk kontak bersama.

Entri kontak berbentuk jenis Kontakyang diperluas, yang mewakili seseorang, tempat—seperti klub atau restoran—atau organisasi. Jenis kontak muncul dalam XML sebagai elemen <atom:entry> yang berisi berbagai elemen ekstensi dari namespace Google Data.

Elemen category yang menunjukkan bahwa entri adalah kontak terlihat seperti berikut:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Di Domain Shared Contacts API, beberapa elemen sedikit lebih ketat daripada jenis kontak. Untuk elemen berikut, Anda harus menyediakan atribut rel atau atribut label, tetapi tidak keduanya:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Saat Anda membuat atau memperbarui kontak bersama, jika Anda menyediakan rel dan label, atau tidak keduanya, untuk salah satu elemen tersebut, server akan menolak entri.

Dukungan foto

Bersama dengan nilai properti standar seperti self atau edit, Anda dapat menggunakan nilai rel untuk elemen atom:link. Saat menggunakan link foto, token otorisasi di header HTTP harus ditentukan. Untuk mengetahui informasi selengkapnya, lihat Mempelajari autentikasi dan otorisasi.

  • Dengan perintah GET, rel="http://schemas.google.com/contacts/2008/rel#photo" menambahkan kemampuan untuk membaca foto yang terkait dengan kontak. Anda dapat menggunakan URL yang ditentukan di href untuk membaca versi terbaru foto yang terkait dengan kontak. Link tidak ditampilkan jika tidak ada gambar untuk kontak.

Contoh:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • Dengan perintah PUT atau DELETE, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" menambahkan kemampuan untuk memperbarui atau menghapus foto lokal yang terkait dengan kontak.

Contoh:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

Namespace gContact

URL namespace XML untuk gContact adalah http://schemas.google.com/contact/2008.

Di namespace ini, elemen ditentukan yang mewakili grup tempat kontak berada.

Properti gContact:groupMembershipInfo

Properti Deskripsi
href Mengidentifikasi grup tempat kontak berada atau pernah berada. Grup direferensikan berdasarkan ID-nya.
deleted="true" Berarti keanggotaan grup dihapus untuk kontak. Atribut ini hanya disertakan jika showdeleted ditentukan sebagai parameter kueri, jika tidak, groupMembershipInfo untuk grup yang tidak lagi dimiliki kontak tidak akan ditampilkan.