Paylaşılan kişiler öğeleri

Domain Shared Contacts API, standart Google Data API öğelerini ve paylaşılan kişiler için özel olan öğeleri kullanır.

Kişi girişi, bir kişiyi, bir mekanı (ör. kulüp veya restoran) ya da bir kuruluşu temsil eden genişletilmiş bir Kişi 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 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, birkaç öğe kişi türünden biraz daha kısıtlayıcıdır. Aşağıdaki öğeler için rel özelliğini veya label özelliğini gönderirsiniz ancak ikisini birden göndermezsiniz:

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

Paylaşılan bir kişiyi oluştururken veya güncellerken bu öğelerden herhangi biri için hem rel hem de label değerini ya da hiçbirini sağlamazsanız sunucu girişi reddeder.

Fotoğraflar desteği

self veya edit gibi standart özelliklerin değerleriyle birlikte rel değerlerini atom:link öğeleri için kullanabilirsiniz. Fotoğraf bağlantıları kullanılırken HTTP üstbilgisinde yetkilendirme jetonu belirtilmelidir. Daha fazla bilgi için Kimlik doğrulama ve yetkilendirme hakkında başlıklı makaleyi inceleyin.

  • 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 içinde belirtilen URL'yi kullanabilirsiniz. Kişinin resmi 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'dir.

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. Grup, kimliğiyle referans alınır.
deleted="true" Kişinin grup üyeliğinin kaldırıldığı anlamına gelir. Bu özellik yalnızca showdeleted sorgu parametresi olarak belirtilmişse dahil edilir. Aksi takdirde, bir kişinin artık ait olmadığı gruplar için groupMembershipInfo döndürülmez.