Paylaşılan kişiler öğeleri

Alan Adı İçinde Paylaşılan Kişiler API'si, standart Google Data API öğelerini ve paylaşılan kişilere özgü öğeleri kullanır.

Kişi girişi, bir kişiyi, mekanı (ör. kulüp veya restoran) ya da kuruluşu temsil eden genişletilmiş bir kişi türü biçimindedir. Kişi türü, XML'de Google Veri ad alanındaki çeşitli uzantı öğelerini içeren bir <atom:entry> öğesi olarak görünür.

Girişin kişi olduğunu belirten category öğesi aşağıdaki gibi görünür:

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

Domain Shared Contacts API'de bazı öğeler, kişi türünden biraz daha kısıtlayıcıdır. Aşağıdaki öğeler için ya bir rel özelliği ya da bir label özelliği gönderirsiniz, ikisini birden gönderemezsiniz:

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

Paylaşılan bir kişi oluşturduğunuzda veya güncellediğinizde, bu öğelerden herhangi biri için hem rel hem de label değerini veya hiçbirini sağlamazsanız sunucu girişi reddeder.

Fotoğraflar desteği

Standart mülkler için self veya edit gibi değerlerle birlikte atom:link öğeleri için rel değerlerini kullanabilirsiniz. Fotoğraf bağlantıları kullanırken HTTP üst bilgisinde yetkilendirme jetonunun belirtilmesi gerekir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında bilgi edinin.

• GET komutuyla rel="http://schemas.google.com/contacts/2008/rel#photo", kişiyle ilişkili fotoğrafı okuma özelliğini ekler. Kişiyle ilişkili fotoğrafın en son sürümünü okumak için href alanında belirtilen URL'yi kullanabilirsiniz. Kişi için resim yoksa bağlantı gösterilmez.

Örnek:

<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/*" />

• rel="http://schemas.google.com/contacts/2008/rel#edit-photo", PUT veya DELETE komutuyla kişiyle ilişkili yerel bir fotoğrafı güncelleme veya silme özelliğini ekler.

Örnek:

<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" />

gContact ad alanı

gContact için XML ad alanı URL'si http://schemas.google.com/contact/2008.

Bu ad alanında, kişinin ait olduğu grubu temsil eden bir öğe tanımlanır.

gContact:groupMembershipInfo tesis

Mülk	Açıklama
href	Kişinin ait olduğu veya ait olduğu grubu tanımlar. Grupa, kimliğiyle referans verilir.
deleted="true"	Kişinin grup üyeliği kaldırıldı demektir. Bu özellik yalnızca showdeleted sorgu parametresi olarak belirtilirse dahil edilir. Aksi takdirde, bir kişinin artık ait olmadığı gruplar için groupMembershipInfo döndürülmez.