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 dihref
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
atauDELETE
,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. |