Elemen kontak bersama

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

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

Elemen category yang menunjukkan bahwa entri adalah kontak akan 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 dibandingkan jenis kontak. Untuk elemen berikut, Anda harus memberikan 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 diri atau edit, Anda dapat menggunakan nilai rel untuk elemen atom:link. Saat menggunakan link foto, token otorisasi di header HTTP harus ditentukan. Untuk informasi selengkapnya, lihat Mempelajari autentikasi dan otorisasi.

  • Dengan perintah GET, rel="http://schemas.google.com/contacts/2008/rel#photo" menambahkan kemampuan membaca foto yang terkait dengan kontak. Anda dapat menggunakan URL yang ditentukan di href untuk membaca versi terbaru foto yang terkait dengan kontak. Tautan 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.

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

gContact:groupMembershipInfo properti

Properti Deskripsi
href Mengidentifikasi grup tempat kontak berada. Grup ini direferensikan oleh ID-nya.
deleted="true" Berarti bahwa keanggotaan grup telah dihapus untuk kontak. Atribut ini hanya disertakan jika showdeleted ditentukan sebagai parameter kueri. Jika tidak, groupMembershipInfo untuk grup yang bukan milik kontak lagi tidak akan ditampilkan.