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 orang, tempat—seperti klub atau restoran—atau organisasi. Jenis kontak muncul dalam XML sebagai elemen <atom:entry> yang berisi berbagai elemen ekstensi dari namespace Data Google.

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 memberikan rel dan label, atau tidak sama sekali, 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 Pelajari 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 URI 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.

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

gContact:groupMembershipInfo properti

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