Paylaşılan kişiler öğeleri

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

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

Girişin bir 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'deki bazı öğeler kişi türünden biraz daha kısıtlayıcıdır. Aşağıdaki öğeler için ya rel ya da label özelliği sağlarsınız; ikisini birden sağlamazsınız:

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

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

Fotoğraflar desteği

atom:link öğeleri için rel değerlerini, kendi veya düzenleme gibi standart mülklerin değerleriyle birlikte kullanabilirsiniz. Fotoğraf bağlantıları kullanılırken HTTP üstbilgisinde yetkilendirme jetonunun belirtilmesi gerekir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında bilgi bölümüne bakın.

  • GET komutuyla rel="http://schemas.google.com/contacts/2008/rel#photo", kişiyle ilişkilendirilmiş fotoğrafı okuma özelliğini ekler. Kişiyle ilişkilendirilmiş fotoğrafın en son sürümünü okumak için href özelliğinde 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/*" />
  • PUT veya DELETE komutuyla rel="http://schemas.google.com/contacts/2008/rel#edit-photo", 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 şeklindedir.

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

gContact:groupMembershipInfo tesis

Özellik Açıklama
href Kişinin ait olduğu grubu tanımlar. Gruba, kimliği tarafından başvurulur.
deleted="true" Kişinin grup üyeliğinin kaldırıldığı anlamına gelir. Bu özellik yalnızca sorgu parametresi olarak showdeleted belirtilirse dahil edilir. Aksi takdirde, bir kişinin artık ait olmadığı gruplar için groupMembershipInfo döndürülmez.