Elemen kontak bersama

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

Entri kontak berbentuk Jenis kontak yang diperluas, 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 Google Data.

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 daripada jenis kontak. Untuk elemen berikut, Anda 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 memberikan 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 membaca foto yang terkait dengan kontak. Anda dapat menggunakan URL yang ditentukan dalam href untuk membaca foto versi terbaru yang terkait dengan kontak. Link tidak ditampilkan jika tidak ada foto 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 ruang nama ini, elemen yang mewakili grup tempat kontak berada ditentukan.

Properti gContact:groupMembershipInfo

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