Yaygın Öğeler: "Türler"

Uyarı: Bu sayfa, Google'ın eski API'leri olan Google Veri API'leriyle ilgilidir. Bu sayfalar, çoğu yeni API'lerle değiştirilen Google Veri API'leri dizininde listelenen API'lerle ilgilidir. Belirli bir yeni API ile ilgili bilgi edinmek için yeni API'nin belgelerine bakabilirsiniz. Yeni bir API ile istekleri yetkilendirme hakkında bilgi için Google Hesaplarında Kimlik Doğrulama ve Yetkilendirme başlıklı makaleyi inceleyin.

Giriş

Bu, belirli bir öğe türüyle ilgili tutarlı bir bilgi kümesi sağlayabilmek için genellikle Google Veri API'lerini kullanan hizmetler için yararlıdır.

Örneğin, çeşitli Google Data API (veya "GData") hizmetleri bir kişi ya da kuruluşun iletişim bilgilerini sağlayabilir; bu tür tüm hizmetlerin aynı iletişim bilgisi öğelerini kullanması uygundur.

Bir kişiyi birlikte tanımlayan öğelerin toplanmasına Kişi "türü" denir. Kişi türündeki öğelerden bazıları normal Atom veya RSS öğeleridir. Diğerleri ise Google tarafından "Google Veri ad alanı" adlı bir ad alanında tanımlanır. Genel olarak Google Veri ad alanı, genellikle gd: takma adı kullanılarak XML kodunda belirtilir. Örneğin, telefon veya faks numarası içeren öğe <gd:phoneNumber> şeklindedir. Google Verileri ad alanının şema URL'si http://schemas.google.com/g/2005'tir.

Google, başka türleri de tanımlar: Etkinlik (bir takvim etkinliğini temsil eden standartlaştırılmış öğeler koleksiyonu) ve Mesaj (e-posta mesajını, tartışma grubu yayınını veya diğer mesajı temsil eden bir öğe koleksiyonu).

Google Veri ad alanındaki bazı öğeler, birden çok tür tarafından kullanılır. Örneğin, <gd:who> öğesi, bir kişiyi (<gd:who> içinde tanımlanır) <gd:who> öğesini içeren girişle ilişkilendirir. Bu öğe, düzenleyenleri, katılımcıları vb. belirtmek için Etkinlik türünde kullanılır. Gönderen ve alıcıları belirtmek için İleti türünde de kullanılır.

Google Data API feed'indeki bir giriş belirli bir türü kullandığında scheme özelliği "http://schemas.google.com/g/2005#kind" ve term özelliği, şema URL'si ve tür adı olarak ayarlanmış bir <atom:category> öğesini içerir. Örneğin, bir Kişi girişi aşağıdaki öğeyi içerir:

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

Bu, müşterilerin girişin ne tür verileri (yani girişin semantiğini belirlemesi) hızlı ve kolay bir şekilde belirlemesini sağlar. (Tercih ederseniz Atom yerine RSS'yi kullanabilirsiniz. Atom öğelerine karşılık gelen RSS öğeleri için protokol referansı dokümanına bakın.)

Bu doküman, bazı yaygın türler ve içerdikleri öğeler için referans niteliğindedir.

Belgelenmemiş öğeler

<atom:entry> öğesinin standart öğeleriyle ilgili bilgileri, bu öğelerin standart anlamlarının olduğu türlere dahil etmeyiz. Örneğin; <atom:id>, <atom:published> ve <atom:updated>, çeşitli türlerde göründüğünde standart anlamlarına sahiptir.

Ayrıca, belirtilen bağlamda anlam ifade etmeyecek standart Atom öğeleri hakkında bilgi eklemeyiz. Örneğin, <atom:summary>, İletişim türünde kullanılmaz ve <atom:author>, girişte gerekli bir öğe olsa da (üst feed'de belirtilmemişse) İletişim türünde yararlı bir anlamı yoktur.

Tür oluşturma

Belirli türdeki girişleri oluştururken, özellikle türlerdeki bazı öğelerin başka türler içermesi nedeniyle tam olarak hangi bilgileri eklemeniz gerektiğini anlamak zor olabilir.

Yardımcı olabilecek bir yaklaşım da manuel olarak çeşitli türler oluşturmaya çalışmak yerine, sağladığımız istemci kitaplıklarını kullanmaktır. İstemci kitaplıkları, belirli bir girişteki verileri eklemek ve değiştirmek için çeşitli yöntemler sunar. Ayrıntılar için istemci kitaplığı dokümanlarına bakın.

Genişletilebilirlik

Bu belgedeki bilgiler, türler için olası tüm özellikleri ve özellik değerlerini kapsamaz. Hizmetler, türleri genişletebileceği için belirli bir hizmet bu dokümanda bulunmayan özellikler ve değerler kullanabilir.

Tipografi kuralları

Bu belgedeki tablolarda, zorunlu ve isteğe bağlı öğeler için aşağıdaki kuralları kullanırız:

öğeAdı Zorunlu öğe
itemName İsteğe bağlı öğe
itemName* İsteğe bağlı öğe, birden fazla örneğe izin verilir

Öğeler ve özellikler standart XPath notasyonunda sunulur.

İletişim türü

Bir kişiyi ifade eder: bir kişi, kulüp veya restoran gibi bir mekan ya da bir kuruluş.

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

Not: Kişi türünü Kişiler API'si bağlamında kullanıyorsanız API'nin 3.0 sürümünden itibaren, Contact type'ın 2.0 (bu belgede açıklanmıştır) Kişiler API'si tarafından kullanıldığını lütfen unutmayın.

Özellikler

Özellik Açıklama
atom:category* Kategoriler. @label özelliğine sahip örnekler etiket olarak değerlendirilir. @scheme özelliğinin kullanımı hakkında bilgi için bu bölümün başındaki notlara bakın.
atom:content Kişiyle ilgili notlar.
atom:link* Alakalı bilgilerin bağlantıları. Daha ayrıntılı olarak belirtmek gerekirse atom:link[@rel='alternate'], kişiyi açıklayan bir HTML sayfasına bağlantı verir.
atom:title Kişinin adı. Bu alan salt okunurdur. Kişinin adını değiştirmek için gd:name sayfasına bakın.
gd:email* E-posta adresleri.
gd:extendedProperty* Genişletilmiş mülk.
gd:deleted? Bu öğenin varlığı, bu kişi girişinin silindiğini gösteriyor.
gd:im* IM adresleri
gd:name? Yapılandırılmış formdaki kişinin adı.
gd:organization* Düzen.
gd:phoneNumber* Telefon ve faks numaraları.
gd:structuredPostalAddress* Kişinin yapılandırılmış formdaki posta adresi.
gd:where? Kişiyle ilişkilendirilen bir yer.

Örnekler

<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gd='http://schemas.google.com/g/2005'>
  <category scheme='http://schemas.google.com/g/2005#kind' 
      term='http://schemas.google.com/contact/2008#contact'/>
  <title>Elizabeth Bennet</title>
  <content>My good friend, Liz.  A little quick to judge sometimes, but nice girl.</content>
  <gd:email rel='http://schemas.google.com/g/2005#work' primary='true' address='liz@gmail.com'/>
  <gd:email rel='http://schemas.google.com/g/2005#home' address='liz@example.org'/>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work' primary='true'>
    (206)555-1212
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    (206)555-1213
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#mobile'>
    (206) 555-1212
  </gd:phoneNumber>
  <gd:im rel='http://schemas.google.com/g/2005#home' 
      protocol='http://schemas.google.com/g/2005#GOOGLE_TALK' 
      address='liz@gmail.com'/>
  <gd:postalAddress rel='http://schemas.google.com/g/2005#work' primary='true'>
    1600 Amphitheatre Pkwy 
    Mountain View, CA 94043
  </gd:postalAddress>
  <gd:postalAddress rel='http://schemas.google.com/g/2005#home'>
    800 Main Street
    Mountain View, CA 94041
  </gd:postalAddress>
  <gd:organization>
    <gd:orgName>Google, Inc.</gd:orgName>
    <gd:orgTitle>Tech Writer</gd:orgTitle>
  </gd:organization>
</entry>

Profil türü

Bir Google kullanıcısı veya başka bir tüzel kişiyle ilişkili bir profili temsil eder. Profil türü, İletişim türü ile birçok yapı paylaşır. Ancak bazı yönlerden farklılık gösterir: Örneğin, genişletilmiş özellikler içeremez veya silindi olarak işaretlenemez.

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

Profil türü, Contacts API'nin 3.0 sürümünde kullanıma sunulmuştur.

Özellikler

Özellik Açıklama
atom:category* Kategoriler. @label özelliğine sahip örnekler etiket olarak değerlendirilir. @scheme özelliğinin kullanımı hakkında bilgi için bu bölümün başındaki "Kategori öğesi" notuna bakın.
atom:content Profil hakkında notlar.
atom:link* Alakalı bilgilerin bağlantıları. Özellikle, atom:link[@rel='alternate'] profili açıklayan bir HTML sayfasına bağlantı veriyor.
atom:title Profil adı. Bu alan salt okunurdur.
gd:email* E-posta adresleri.
gd:im* IM adresleri
gd:name? Ad, yapılandırılmış biçimde.
gd:organization* Düzen.
gd:phoneNumber* Telefon ve faks numaraları.
gd:structuredPostalAddress* Posta adresi, yapılandırılmış biçimde.
gd:where? Profille ilişkili bir yer.

Örnekler

<entry xmlns='http://www.w3.org/2005/Atom'
xmlns:gContact='http://schemas.google.com/contact/2008'
xmlns:batch='http://schemas.google.com/gdata/batch'
xmlns:gd='http://schemas.google.com/g/2005'
  <category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#profile' />
  <title>Elizabeth Bennett</title>
  <gd:name>
    <gd:givenName>Elizabeth</gd:givenName>
    <gd:familyName>Bennett</gd:familyName>
  </gd:name>
  <gd:structuredPostalAddress rel='http://schemas.google.com/g/2005#work'>
    <gd:formattedAddress>Longbourne, Nr. Meryton, Hertfordshire, England</gd:formattedAddress>
  </gd:structuredPostalAddress>
</entry>

Etkinlik türü

Bir takvim etkinliğini temsil eder. Etkinlik konumu, bir <gd:where> öğesine yerleştirilmiş (veya bağlantılı olan) bir Kişi türü ile gösterilir. Etkinlik planlayıcıları ve katılımcılar, <gd:who> öğelerine yerleştirilmiş (veya bağlantılı) olan Kişi türleri olarak gösterilir.

Kategori öğesi: <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>

Özellikler

Özellik Açıklama
atom:author Bu etkinliği oluşturan kişi.
atom:category* Kategoriler. @label özelliğine sahip örnekler etiket olarak değerlendirilir. @scheme özelliğinin kullanımı hakkında bilgi için bu bölümün başındaki notlara bakın.
atom:content Etkinliğin daha uzun açıklaması.
atom:link* Bağlantılar. Daha ayrıntılı olarak belirtmek gerekirse atom:link[@rel='alternate'], etkinliği açıklayan bir HTML sayfasının bağlantısını sağlar.
atom:title Etkinliğin kısa başlığı.
gd:comments? Yorumlar feed'i.
gd:eventStatus? Aşağıda belirtilen genişletilebilir numaralandırma.
gd:extendedProperty* Genişletilmiş mülk.
gd:originalEvent? Düzenli etkinlikler için orijinal etkinlik tanımlayıcısı.
gd:recurrence? Yinelenme kuralı.
gd:transparency? RFC 2445'te tanımlanan TRANSP özelliğine karşılık gelen, aşağıda belirtilen genişletilebilir numaralandırma.
gd:visibility? Aşağıda belirtilen genişletilebilir numaralandırma.
gd:when* Etkinlik süresi. startTime ve endTime özelliklerinin her ikisi de ayarlanmalıdır ancak tüm gün süren etkinlikler için zaman içermeyen, yalnızca tarihler mevcuttur.
gd:when/gd:reminder* Etkinlik için hatırlatıcılar.
gd:where* Etkinliğin konumu veya otopark gibi yakın çevredeki ihtiyaçlar. Feed düzeyinde bir <gd:where> öğesi belirtilirse ancak giriş düzeyinde <gd:where> öğesi yoksa girişler, feed düzeyindeki <gd:where> değerini devralır.
gd:who* Etkinlikle ilişkili kullanıcılar: düzenleyen, katılımcılar, konuşmacılar, sanatçılar vb.
gd:who/gd:attendeeStatus? Kabul durumu.
gd:who/gd:attendeeType? Katılımcı türü: required veya optional.

gd:where için rel değerleri

rel değeri Açıklama
http://schemas.google.com/g/2005#event veya belirtilmedi. Etkinliğin gerçekleştiği yer.
http://schemas.google.com/g/2005#event.alternate İkincil konum. Örneğin, ana siteye video konferans bağlantısı içeren uzak bir site.
http://schemas.google.com/g/2005#event.parking Yakındaki otopark.

gd:eventStatus değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event.canceled Etkinlik iptal edildi.
http://schemas.google.com/g/2005#event.confirmed Etkinlik planlandı.
http://schemas.google.com/g/2005#event.tentative Etkinlik yalnızca geçici olarak planlandı.

gd:görünürlük değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event.confidential Bazı okuyucuların etkinliği görmesine izin verin.
http://schemas.google.com/g/2005#event.default Davranışı, etkinliğin göründüğü takvimin sahibinin tercihlerinden devralın.
http://schemas.google.com/g/2005#event.private En az okuyucunun etkinliği görmesine izin verin.
http://schemas.google.com/g/2005#event.public Çoğu okuyucunun etkinliği görmesine izin verin.

gd:şeffaflık değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event.opaque Etkinliğin takvimde zaman geçirdiğini gösterir; etkinlik zamanı uygun/meşgul aramasında meşgul olarak işaretlenir.
http://schemas.google.com/g/2005#event.transparent Etkinliğin takvimde hiç zaman almadığını belirtir. Etkinlik saati uygun/meşgul aramasında meşgul olarak işaretlenmez.

Örnekler

Toplantı:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
  <id>http://mycal.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
  <published>2005-01-18T21:00:00Z</published>
  <updated>2006-01-01T00:00:00Z</updated>
  <title>Discuss BazMat API</title>
  <content>We will discuss integrating GData with BazMat.</content>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <gd:when startTime='2005-01-18T21:00:00Z' endTime='2005-01-18T22:00:00Z'>
    <gd:reminder minutes='15'/>
  </gd:when>
  <gd:where valueString='Building 41, Room X'/>
  <gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
  <gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
  <gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>

Çevrimiçi etkinlik:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>
  <id>http://mycal.example.com/feeds/jo/home/full/982307e797979879a</id>
  <published>2005-01-18T21:00:00Z</published>
  <updated>2006-01-01T00:00:00Z</updated>
  <title>Online Chess Tournament</title>
  <content/>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <gd:when startTime='2006-01-24T19:00:00-08:00' endTime='2006-01-24T20:00:00-08:00'>
    <gd:reminder minutes='15'/>
  </gd:when>
  <gd:where>
    <gd:entryLink>
      <entry>
        <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
        <id>http://contacts.example.com/jo/GamePhannz</id>
        <published>2005-01-18T21:00:00Z</published>
        <updated>2006-01-01T00:00:00Z</updated>
        <title>GamePhannz Online Game Server</title>
        <link rel="http://schemas.google.com/g/2005#onlineLocation" type="text/html" href="http://gamephannz.example.com/chess/138fd87e"/>
        <content/>
      </entry>
    </gd:entryLink>
  </gd:where>
  <gd:eventStatus value="http://schemas.google.com/g/2005#event.confirmed"/>
  <gd:visibility value="http://schemas.google.com/g/2005#event.public"/>
  <gd:transparency value="http://schemas.google.com/g/2005#event.transparent"/>
</entry>

Mesaj türü

Bir mesajı (ör. e-posta, tartışma grubu yayını veya yorum) temsil eder.

Kategori öğesi: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>

Özellikler

Özellik Açıklama
atom:category* Kategoriler. @label özelliğine sahip örnekler etiket olarak değerlendirilir. @scheme özelliğinin kullanımı hakkında bilgi için bu bölümün başındaki notlara bakın. @term özelliğinin kullanımıyla ilgili bilgi edinmek için aşağıdaki tabloya bakın.
atom:content İleti gövdesi.
atom:link* Mesaj ekleri'ne gider. Özellikle, bir ek yüklemek için <link rel="enclosure"> kullanın ve ekin içeriğini Atom medya koleksiyonuna yerleştirin.
atom:title İleti konusu.
gd:geoPt? İletinin yayınlandığı coğrafi konum.
gd:rating? Kalite puanı (uygulama tarafından tanımlandığı şekilde).
gd:who* Bu mesajla ilişkilendirilmiş kullanıcılar. Anlamlar, tam olarak @rel değerine bağlıdır. Aşağıdaki tabloya bakın.

Kategori @term değerleri

Aşağıdaki tüm kategoriler http://schemas.google.com/g/2005 şemasında mevcuttur.

Süre Açıklama
http://schemas.google.com/g/2005#message.chat Mesaj, bir sohbet oturumunun transkriptidir.
http://schemas.google.com/g/2005#message.inbox İleti, gelen kutusuna ait olarak işaretlenir.
http://schemas.google.com/g/2005#message.sent Mesaj gönderildi olarak işaretlendi.
http://schemas.google.com/g/2005#message.spam İleti spam olarak değerlendirilir.
http://schemas.google.com/g/2005#message.starred İleti yıldız işaretli olarak işaretlenir.
http://schemas.google.com/g/2005#message.unread Mesaj okunmamış.

gd:who için rel değerleri

Özellik Açıklama
http://schemas.google.com/g/2005#message.bcc BCC alıcısına mesaj gönder.
http://schemas.google.com/g/2005#message.cc İleti CC alıcısı.
http://schemas.google.com/g/2005#message.from İleti (e-posta veya IM) göndereni.
http://schemas.google.com/g/2005#message.reply-to Bir yanıt mesajının amaçlanan alıcısı.
http://schemas.google.com/g/2005#message.to Mesaj birincil alıcısı.

Örnek

E-posta iletisi:

<entry xmlns:gd="http://schemas.google.com/g/2005">
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>
  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message.sent"/>
  <author>
    <name>Jo March</name>
    <email>jo@example.com</email>
  </author>
  <id>http://mymail.example.com/feeds/jo/home/full/e1a2af06df8a563edf9d32ec9fd61e03f7f3b67b</id>
  <published>2006-01-18T21:00:00Z</published>
  <updated>2006-01-18T21:00:00Z</updated>
  <title>Re: Info?</title>
  <content>Hi, Fritz -- The information you're looking for is on p. 47.</content>
  <gd:who rel="http://schemas.google.com/g/2005#message.from">
    <gd:entryLink href="http://contacts.example.com/jo/Jo"/>
  </gd:who>
  <gd:who rel="http://schemas.google.com/g/2005#message.to">
    <gd:entryLink href="http://contacts.example.com/fritzb/FritzB"/>
  </gd:who>
</entry>

Google Verileri ad alanı öğesi referansı

Bu dokümanın geri kalanı, türler tarafından kullanılan öğelere yönelik referans malzemeden oluşur.

Sıralamalar

Bazı uzantı öğelerinin değerleri, numaralandırılmış bir gruptan gelen özellikleri belirtmesi gerekir. Bu tür tesislerin genel biçimi şu şekildedir:

<gd:propertyName value="propertyValue">

Mülk değeri Google Veri ad alanından geliyorsa http://schemas.google.com/g/2005#{kind}.{value} biçiminde olur. Örneğin: http://schemas.google.com/g/2005#event.tentative. Değer alanı genişletilebilirse değerler de URI biçiminde olabilir. Genişletilmiş değer URI'leri için önerilen biçim {schema URI}#{value} şeklindedir. Örneğin: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonÖzellikleri

Tüm Google türleri için kullanılan ortak özellikler. Şemada anyAttribute ve anyElement özelliklerinin, ortak özellikleri kullanan tüm Google Verileri ad alanı öğelerinin herhangi bir ad alanında daha fazla genişletilmesine olanak tanıdığını unutmayın. Özellikle, herhangi bir gd öğesini veya herhangi bir Atom/RSS öğesini başka bir gd öğesinin içine yerleştirmek yasaldır. Bu işlem kurallara uygun şekilde uygulanmalıdır ve çoğu durumda bu kullanım, kapsayıcı gd öğesi türünün açık bir özelliği olarak belgelenmelidir.

Özellikler

Özellik Tür Açıklama
@xml:base uri İç içe yerleştirilmiş göreli URI'ların tabanını açıklamak için kullanılan standart XML yapısı.
@xml:lang text İç içe yerleştirilmiş dizelerin dilidir.

Şema

namespace gd = "http://schemas.google.com/g/2005"

gdCommonProperties = {
   atomCommonAttributes,
   anyAttribute*,
   (anyElement*)
}

gd:ekAd

Kişinin ek (ör. orta) adını belirtir. Ör. "Susan".

Özellikler

Özellik Tür Açıklama
@yomi? xs:string Fonetik temsil.
text() xs:string Kişinin soyadı.

Örnek

<gd:additionalName yomi="'suz@n">Susan<gd:additionalName>

Şema

start = additionalName

additionalName =
   element gd:additionalName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:yorumlar

Çevreleyen giriş için (örneğin, bir takvim etkinliğinde) bir yorum feed'i içerir.

Özellikler

Özellik Tür Açıklama
@rel? xs:string Gruptaki yorumların türü. Şu anda, normal yorumlar ve incelemeler arasında bir ayrım vardır.
gd:feedLink? feedLink Yorumlar feed'i. Bu feed, İleti türünü uygulamalıdır.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#regular veya belirtilmedi Normal yorumlar (kullanıcılardan).
http://schemas.google.com/g/2005#reviews Profesyonel yorumlar.

Örnekler

Yorumlar feed'i:

<gd:comments>
  <gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
    <feed>
      <id>http://example.com/Jo/posts/MyFirstPost/comments</id>
      <title>My first post: comments</title>
      ...
      <entry>
         ...
         <content>Good post.</content>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>
</gd:comments>

Yorum feed'i:

<gd:comments rel="http://schemas.google.com/g/2005#reviews">
  <gd:feedLink href="http://example.com/restaurants/SanFrancisco/432432/reviews" countHint="25">
    <feed>
      <id>http://example.com/restaurants/SanFrancisco/432432/reviews</id>
      <title>La Folie reviews</title>
      ...
      <entry>
         ...
         <content>Good food.</content>
         <gd:rating value="5" min="1" max="5"/>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>
</gd:comments>

Şema

start = comments

comments =
   element gd:comments {
      gdCommonProperties,
      attribute rel { xs:string }?,
      (feedLink?)
   }

gd:silindi

Mevcut olduğunda, kapsayıcı girişinin silindiğini belirten bir işaretçi öğesidir.

Özellikler

Yok.

Şema

start = deleted

deleted =
   element gd:deleted

gd:ülke

Ülke adı ve isteğe bağlı ülke kodu. İkincisi ise ISO 3166-1 alfa-2'ye uygun olarak verilir.

Özellikler

Özellik Tür Açıklama
@code? xs:string ISO 3166-1 alfa-2'deki gibi ülke kodu.
text() xs:string Ülke adı.

Örnekler

<gd:country code='PL'>Poland</gd:country>
<gd:country>Gabon</gd:country>

Şema

start = country

country =
   element gd:country {
      attribute code { xs:string }?,
      xs:string?
   }

gd:e-posta

Bulunduğu tüzel kişiyle ilişkili bir e-posta adresi (genellikle bir kişiyi veya konumu temsil eden bir tüzel kişidir).

Özellikler

Özellik Tür Açıklama
@address xs:string E-posta adresi.
@displayName? xs:string E-posta adresinin ait olduğu varlığın (ör. kişi) görünen adı.
@label? xs:string Bu e-posta adresini adlandırmak için kullanılan basit bir dize değeri. Kullanıcı arayüzlerinin "İş", "Kişisel", "Tercih Edilen" gibi bir etiketi göstermesine olanak tanır.
@rel? xs:string E-posta türünü tanımlayan programatik değer. Ayrıntılar için aşağıya bakın.
@primary? xs:boolean Bir iletişim türünde birden çok e-posta uzantısı gösterildiğinde hangisinin birincil olduğunu belirtir. En fazla bir e-posta birincil olabilir. Varsayılan değer: "false"

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other Ne ev ne de iş yeri olan bir e-posta adresi. label, gerçek türü belirtmek için kullanılabilir.
http://schemas.google.com/g/2005#work

Örnekler

<gd:email address="foo@bar.example.com" displayName="Foo Bar" />
<gd:email label="Personal" rel="http://schemas.google.com/g/2005#home" address="fubar@gmail.com" primary="true"/>

Şema

start = email

email =
   element gd:email {
      attribute address { xs:string },
      attribute displayName { xs:string }?,
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:girişBağlantısı

Mantıksal olarak iç içe yerleştirilmiş bir girişi temsil eder. Örneğin, bir kişiyi temsil eden <gd:who> öğesi, kişi feed'inden iç içe yerleştirilmiş bir girişe sahip olabilir.

Özellikler

Özellik Tür Açıklama
@href? xs:string Giriş URI'sını belirtir. İç içe yerleştirilmiş giriş yerleştirilmişse ve bağlantılı değilse bu özellik atlanabilir.
@readOnly? xs:boolean Mevcut girişin salt okunur olup olmadığını belirtir. Varsayılan değer: "false"
@rel? xs:string Bağlantı ilişkisini belirtir; hizmetin tek bir varlık için birden çok giriş bağlantısı türü sağlamasına olanak tanır. <atom:link> öğesinin rel özelliğiyle aynı anlamlara ve izin verilen değerlere sahip.
atom:entry? atomEntry Girişin içeriği.

Kısıtlamalar

  • @href veya <atom:entry> öğelerinin her ikisi de mevcut olmalıdır.
  • atom:entry mevcut değilse istemci, içeriği @href içindeki giriş URI'sinden getirebilir. atom:entry mevcutsa içerikler, girişin oluşturulduğu sırada @href kaynağından alınacak olanlarla aynı olmalıdır.
  • PUT veya POST, <gd:entryLink> içeriyorsa ve @href özelliği belirtilmişse özelliğin değeri bağlantı oluşturmak için kullanılır. atom:entry öğesi de varsa bu öğe yok sayılır. @href özelliği belirtilmemişse atom:entry öğesi, yerleşik bir giriş olarak veya başka bir feed'de depolanıp ona bağlanır. Bazı hizmetlerin bu seçeneklerin hepsini desteklemeyebileceğini unutmayın.

Örnekler

<gd:who> alanındaki iletişim bilgileri:

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo">
    <entry>
      <category scheme="http://schemas.google.com/g/2005#kind"
        term="http://schemas.google.com/g/2005#contact"/>
      <id>http://gmail.com/jo/contacts/Jo</id>
      <category term="user-tag" label="Google"/>
      <title>Jo March</title>
      <gd:email address="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

Yalnızca harici başvuru (salt okunur giriş):

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo" readOnly="true"/>
</gd:who>

Şema

start = entryLink

entryLink =
   element gd:entryLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      (atomEntry?)
   }

gd:extendedProperty

Çevreleyen tüzel kişinin yardımcı mülkü olarak sınırlı miktarda özel veri depolamanıza olanak tanır.

anyForeignElement varlığının, feed'in herhangi bir geçerli XML'i isteğe bağlı olarak gd:extendedProperty öğesine yerleştirmesine izin verdiğini unutmayın (value özelliğiyle karşılıklı olarak hariç tutulur).

Özellikler

Özellik Tür Açıklama
@name xs:string URI olarak ifade edilen özelliğin adını belirtir. Genişletilmiş mülk URI'leri genellikle {schema}#{local-name} kuralını izler.
@value? xs:string Mülk değeri.
@realm? xs:string Genişletilmiş mülkün nerede geçerli olduğunu belirtmek için bazı API'ler tarafından kullanılır.

Örnek

Takvim etkinliğinin harici tanımlayıcısı:

<gd:extendedProperty name="http://www.example.com/schemas/2007#mycal.id"
  value="1234"></gd:extendedProperty> 

Kişi girişi için ek XML

<gd:extendedProperty name="com.google">
  <some_xml>value</some_xml>
</gd:extendedProperty>

Şema

start = extendedProperty

extendedProperty =
   element gd:extendedProperty {
      attribute name { xs:string },
      attribute value { xs:string } ?,
      (anyForeignElement*),
      attribute realm { xs:string } ?
   }

gd:aileAdı

Kişinin aile adını belirtir (ör. "Demir".

Özellikler

Özellik Tür Açıklama
@yomi? xs:string Fonetik temsil.
text() xs:string Kişinin soyadı.

Örnek

<gd:familyName yomi="smɪð">Smith<gd:familyName>

Şema

start = familyName

familyName =
   element gd:familyName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:feedBağlantısı

Mantıksal olarak iç içe yerleştirilmiş bir feed'i temsil eder. Örneğin, bir takvim feed'inde girişlerdeki tüm yorumları temsil eden iç içe yerleştirilmiş bir feed olabilir.

Özellikler

Özellik Tür Açıklama
@countHint? xs:unsignedInt Feed'deki girişlerin sayısıyla ilgili ipuçları. Uygulamaya bağlı olarak, kesin bir sayı olmayabilir.
@href? xs:string Özet akışı URI'sini belirtir. İç içe yerleştirilmiş feed yerleştirilmişse ve bağlı değilse bu özellik atlanabilir.
@readOnly? xs:boolean Mevcut feed'in salt okunur olup olmadığını belirtir.
@rel? xs:string Bağlantı ilişkisini belirtir; hizmetin tek bir varlık için birden çok türde feed bağlantısı sağlamasına izin verir. <atom:link> öğesinin rel özelliğiyle aynı anlamlara ve izin verilen değerlere sahip.
atom:feed? atomFeed Feed'in içeriği.

Kısıtlamalar

  • @href veya <atom:feed> öğelerinin her ikisi de mevcut olmalıdır.
  • atom:feed mevcut değilse istemci, içeriği URI'dan @href içinde getirebilir. Mevcutsa içerikler, feed'in oluşturulduğu sırada @href ürününden alınacak olanlarla aynı olmalıdır.
  • PUT veya POST değeri <gd:feedLink> içeriyorsa ve @href özelliği belirtilirse özelliğin değeri bağlantı oluşturmak için kullanılır. <atom:feed> öğesi de varsa bu öğe yok sayılır. @href özelliği belirtilmemişse <atom:feed> öğesi, yerleşik feed olarak depolanır. Bazı hizmetlerin bu seçeneklerin hepsini desteklemeyebileceğini unutmayın.

Örnekler

Blog oluşturma:

<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments" countHint="10">
    <feed>
      <id>http://example.com/Jo/posts/MyFirstPost/comments</id>
      <title>My first post: comments</title>
      ...
      <entry>
         ...
         <content>Good post.</content>
      </entry>
      <entry>
         ...
      </entry>
      ...
    </feed>
  </gd:feedLink>

Yalnızca harici referans:

<gd:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments"
            countHint="10"/>

Bir Atom girişine listeyi temsil eden yerleştirilmiş feed:

<gd:feedLink>
  <feed>
    <id>cid:1</id>
    <entry>
       <id>cid:1.1</id>
       <content>list item 1</content>
    </entry>
    <entry>
       <id>cid:1.2</id>
       <content>list item 2</content>
    </entry>
  </feed>
</gd:feedLink>

Şema

start = feedLink

feedLink =
   element gd:feedLink {
      attribute href { xs:string }?,
      attribute readOnly { xs:boolean }?,
      attribute countHint { xs:unsignedInt }?,
      (atomFeed?)
   }

gd:coğrafi konum

Coğrafi konum (enlem, boylam, yükseklik).

Kullanımdan kaldırıldı. Bu öğe kullanımdan kaldırıldı. Coğrafi etiketleme verileri için GeoRSS'yi kullanın.

Özellikler

Özellik Tür Açıklama
@elev? xs:float Metre cinsinden yükseklik. Negatif değerler, derinliklerin altındaki deniz seviyesini belirtir.
@label? xs:string Bu konumu adlandırmak için kullanılan basit bir dize değeridir. Kullanıcı arayüzlerinin "Geçerli Konum" gibi bir etiket göstermesine olanak tanır.
@lat xs:float Enlem cinsinden derece. Pozitif değerler Kuzey, negatif değerler Güney anlamına gelir. Aralık [-90,0, 90,0] şeklindedir.
@lon xs:float Enlem cinsinden boylam. Pozitif değerler Doğu, negatif değerler ise Batı anlamına gelir. Aralık [-180.0, 180,0]'dır.
@time? xs:dateTime Zaman damgası.

Örnekler

<gd:geoPt lat="40.75" lon="-74.0"/>
<gd:geoPt lat="27.98778" lon="86.94444" elev="8850.0"/>

Şema

start = geoPt

geoPt =
   element gd:geoPt {
      attribute label { xs:string }?,
      attribute lat { xs:float },
      attribute lon { xs:float },
      attribute elev { xs:float }?,
      attribute time { xs:dateTime }?
   }

gd:d

Bulunduğu varlıkla ilişkili bir anlık mesajlaşma adresi.

Özellikler

Özellik Tür Açıklama
@address xs:string IM adresi.
@label? xs:string Bu IM adresini adlandırmak için kullanılan basit bir dize değeri. Kullanıcı arayüzlerinin "İş", "Kişisel", "Tercih Edilen" gibi bir etiketi göstermesine olanak tanır.
@rel? xs:string IM türünü tanımlayan programatik değer. Ayrıntılar için aşağıya bakın.
@protocol? xs:string IM ağını tanımlar. Değer, standart değerlerden (aşağıda gösterilmiştir) biri veya özel bir IM ağını tanımlayan URI olabilir.
@primary? xs:boolean Kişi türünde birden fazla IM uzantısı gösterildiğinde hangisinin birincil olduğunu belirtir. En fazla bir IM birincil olabilir. Varsayılan değer: "false"

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#netmeeting
http://schemas.google.com/g/2005#other Ev veya iş adresi olmayan bir IM adresi. label, gerçek türü belirtmek için kullanılabilir.
http://schemas.google.com/g/2005#work

protokol özellik değerleri

Aşağıdaki tabloda @protokol özelliği için olası bazı değerler gösterilmektedir.

Değer Açıklama
http://schemas.google.com/g/2005#AIM AOL Instant Messenger protokolü
http://schemas.google.com/g/2005#MSN MSN Messenger protokolü
http://schemas.google.com/g/2005#YAHOO Yahoo Messenger protokolü
http://schemas.google.com/g/2005#SKYPE Skype protokolü
http://schemas.google.com/g/2005#QQ QQ protokolü
http://schemas.google.com/g/2005#GOOGLE_TALK Google Talk protokolü
http://schemas.google.com/g/2005#ICQ ICQ protokolü
http://schemas.google.com/g/2005#JABBER Jabber protokolü

Örnekler

MSN Messenger için IM adresi:

<gd:im protocol="http://schemas.google.com/g/2005#MSN" address="foo@bar.msn.com" rel="http://schemas.google.com/g/2005#home" primary="true"/>

Belirtilmemiş bir protokole sahip, kullanıcı tarafından sağlanan IM adresi. Bu tür adresler, görüntüleme amacıyla kullanışlıdır, ancak programatik olarak işlenmesi zordur.

<gd:im label="Other" address="foo@baz.example.com"/>

Şema

start = im

im =
   element gd:im {
      attribute address { xs:string },
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute protocol { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:ad

Kişinin adını belirtir. Örneğin, "Can".

Özellikler

Özellik Tür Açıklama
@yomi? xs:string Fonetik temsil.
text() xs:string Kişinin adı.

Örnek

<gd:givenName yomi="dʒon">John<gd:givenName>

Şema

start = givenName

givenName =
   element gd:givenName {
      attribute yomi { xs:string }?,
      (xs:string)
   }

gd:para

Belirli bir para birimi cinsinden bir para tutarını belirtir.

Özellikler

Özellik Tür Açıklama
@amount xsd:float Tutar.
@currencyCode xsd:string ISO4217 para birimi kodu.

Örnek

<gd:money amount='650.0' currencyCode='EUR'/>

Şema

element gd:money {
  attribute amount { xsd:float },
  attribute currencyCode { xsd:string }
}

gd:ad

Kullanıcı adının yapılandırılmış bir şekilde depolanmasını sağlar. Ad, ek ad, aile adı, ön ek, son ek ve tam addan oluşur.

Özellikler

Özellik Tür Açıklama
gd:givenName? givenName Kişinin adı.
gd:additionalName? additionalName Kullanıcının ek adı (ör. ikinci ad).
gd:familyName? familyName Kişinin soyadı.
gd:namePrefix? namePrefix Saygın ön eki, ör. "Bay" veya "Bayan".
gd:nameSuffix? nameSuffix Saygın son ek, ör. "SAN" veya "III".
gd:fullName? fullName Adın yapılandırılmamış temsili.

Örnek

Sir Winston Leonard Spencer-Churchill, KG'nin yapılandırılmış temsili

<gd:name>
  <gd:givenName>Winston</gd:givenName>
  <gd:additionalName>Leonard</gd:additionalName>
  <gd:familyName>Spencer-Churchill</gd:familyName>
  <gd:namePrefix>Sir</gd:namePrefix>
  <gd:nameSuffix>OG</gd:nameSuffix>
</gd:name>

Şema

start = name

name =
   element gd:name {
      givenName?
      & additionalName?
      & familyName?
      & namePrefix?
      & nameSuffix?
   }

Kısıtlamalar

  • Adın yapılandırılmamış bileşeni, yapılandırılmış temsiliyle tutarlı olmalıdır.

gd:kuruluş

Genellikle bir kişiyle ilişkilendirilen kuruluş.

Özellikler

Özellik Tür Açıklama
@label? xs:string Bu kuruluşu adlandırmak için kullanılan basit bir dize değeri. Kullanıcı arayüzlerinin "İş", "Gönüllü", "Profesyonel Toplum" gibi bir etiket göstermesine olanak tanır.
gd:orgDepartment? orgDepartment Kuruluş içindeki bir bölümü belirtir.
gd:orgJobDescription? orgJobDescription Kuruluştaki bir işin açıklaması.
gd:orgName? orgName Kurumun adı.
gd:orgSymbol? orgSymbol Kuruluşun simgesi.
gd:orgTitle? orgTitle Kuruluştaki bir kişinin unvanı.
@primary? xs:boolean Kişi türünde birden fazla kuruluş uzantısı varsa birincil olanı belirtir. En fazla bir kuruluş birincil olabilir. Varsayılan değer: "false"
@rel? xs:string Kuruluş türünü tanımlayan programatik değer. Ayrıntılar için aşağıya bakın.
gd:where? where Kuruluşla ilişkili bir yer (ör. ofisin konumu).

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#other Çalışmayan bir kuruluş. label, gerçek türü belirtmek için kullanılabilir.
http://schemas.google.com/g/2005#work

Örnekler

<gd:organization rel="http://schemas.google.com/g/2005#work" label="Work" primary="true">
  <gd:orgName>Google, Inc.</gd:orgName>
  <gd:orgTitle>Tech Writer</gd:orgTitle>
  <gd:orgJobDescription>Writes documentation</gd:orgJobDescription>
  <gd:orgDepartment>Software Development</gd:orgDepartment>
  <gd:orgSymbol>GOOG</gd:orgSymbol>
</gd:organization>

Şema

start = organization

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      ( orgDepartment? &
      orgJobDescription? &
      orgName? &
      orgSymbol? &
      orgTitle? &
      where? )
   }

gd:orgUlaşma

Kuruluş içindeki bir departmanı açıklar. Bir gd:organization öğesinin içinde görünmelidir.

Örnek

<gd:orgDepartment>Research and Development</gd:orgDepartment>

Şema

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

gd:orgİşAçıklaması

Kuruluştaki bir işi tanımlar. Bir gd:organization öğesinin içinde görünmelidir.

Örnek

<gd:orgJobDescription>Documenting public APIs</gd:orgJobDescription>

Şema

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:kuruluşAdı

Kurumun adı. Bir gd:organization öğesinin içinde görünmelidir.

Özellikler

Özellik Açıklama
@yomi? Kuruluş adı için Yomigana (Japonca okuma yardımı).

Örnek

<gd:orgName>Google, Inc.</gd:orgName>

Şema

start = orgName

orgName =
   element gd:orgName {
     attribute yomi {xs:string},
     xs:string
   }

gd:kuruluşsimgesi

Bir kuruluşun simgesini belirtir. Bir gd:organization öğesinin içinde görünmelidir.

Örnek

<gd:orgSymbol>GOOG</gd:orgSymbol>

Şema

start = orgSymbol

orgSymbol = element gd:orgSymbol { xs:string }

gd:kuruluşBaşlığı

Kuruluştaki bir kişinin unvanı. Bir gd:organization öğesinin içinde görünmelidir.

Örnek

<gd:orgTitle>President and CEO</gd:orgTitle>

Şema

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:orijinalEtkinlik

RFC 2445 bölümünün 4.8.4.4 bölümünde belirtilen Yinelenme Kimliği özelliğine eşdeğerdir. Orijinal etkinliği tanımlamak için, yinelenen etkinliğin her örneğinde görünür.

İstisnaya dönüşen örneğin başlangıç zamanını belirten bir <gd:when> öğesi içeriyor.

Özellikler

Özellik Tür Açıklama
@id xs:string Orijinal etkinliğin etkinlik kimliği.
@href xs:string Orijinal etkinliğin etkinlik feed'i URL'si.

Örnek

Orijinal bir etkinliği belirtmek için:

<gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg"

href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID">
  <gd:when startTime="2006-03-17T22:00:00.000Z"/>
</gd:originalEvent>

Şema

start = originalEvent

originalEvent =
   element gd:originalEvent {
      attribute id { xs:string },
      attribute href { xs:string },
      when
   }

gd:telefonNumarası

Bulunduğu tüzel kişiyle ilişkili bir telefon numarası (genellikle bir kişiyi veya konumu temsil eden bir tüzel kişidir).

Özellikler

Özellik Tür Açıklama
@label? xs:string Bu telefon numarasına ad vermek için kullanılan basit bir dize değeri. @rel bir numarayı benzersiz şekilde tanımlayıp kullanıcı arayüzlerinin "Cep Telefonu", "Ev", "İş" gibi uygun bir etiket göstermesine izin verdiği için çoğu durumda @label gerekli değildir. Ancak bir kişinin birden fazla cep telefonu (örneğin) olduğu durumlarda bu özellik, numaraları netleştirmek için kullanılabilir.
@rel? xs:string Telefon numarasının türünü tanımlayan programatik değer. Ayrıntılar için aşağıya bakın.
@uri? xs:string Numarayı resmi bir şekilde göstermek için kullanılan isteğe bağlı bir "tel URI"dır (VoIP/PSTN köprüsü gibi). Tel URI'ları hakkında daha fazla bilgi için RFC 3966'ya bakın.
@primary? xs:boolean Kişi türünde birden fazla telefon numarası uzantısı varsa birincil telefon numarası gösterilir. En fazla bir telefon numarası birincil olabilir. Varsayılan değer: "false"
text() xs:string İnsan tarafından okunabilir telefon numarası; herhangi bir telefon numarası biçiminde olabilir. Baştaki ve sondaki boşluk önemli değildir. Dize içindeki yeni satırlar da önemsizdir ve tek bir alandan kaldırılabilir veya düzleştirilebilir.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#assistant
http://schemas.google.com/g/2005#callback
http://schemas.google.com/g/2005#car
http://schemas.google.com/g/2005#company_main
http://schemas.google.com/g/2005#fax
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#home_fax
http://schemas.google.com/g/2005#isdn
http://schemas.google.com/g/2005#main
http://schemas.google.com/g/2005#mobile
http://schemas.google.com/g/2005#other Başka hiçbir rel değerinin anlamlı olmadığı özel bir sayı türüdür. label, gerçek türü belirtmek için kullanılabilir.
http://schemas.google.com/g/2005#other_fax
http://schemas.google.com/g/2005#pager
http://schemas.google.com/g/2005#radio
http://schemas.google.com/g/2005#telex
http://schemas.google.com/g/2005#tty_tdd
http://schemas.google.com/g/2005#work
http://schemas.google.com/g/2005#work_fax
http://schemas.google.com/g/2005#work_mobile
http://schemas.google.com/g/2005#work_pager

Örnekler

Kullanıcı tarafından girilen basit telefon numarası:

<gd:phoneNumber>(425) 555-8080 ext. 72585</gd:phoneNumber>

Bir dizinden alınan telefon numarası:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#work" uri="tel:+1-425-555-8080;ext=52585">
  (425) 555-8080 ext. 52585
</gd:phoneNumber>

Etiketli sayı:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212">
  +1 206 555 1212
</gd:phoneNumber>

Şema

start = phoneNumber

phoneNumber =
   element gd:phoneNumber {
      attribute rel { xs:string }?,
      attribute label { xs:string }?,
      attribute uri { xs:string }?,
      attribute primary { xs:boolean }?,
      (xs:string)
   }

gd:postalAdresi

Posta adresi.

Özellikler

Özellik Tür Açıklama
@label? xs:string Bu adrese ad vermek için kullanılan basit bir dize değeri.
@rel? xs:string Posta adresinin türünü tanımlayan programatik değer. Ayrıntılar için aşağıya bakın.
@primary? xs:boolean Bir iletişim türünde birden çok posta adresi uzantısı göründüğünde, hangisinin birincil olduğunu belirtir. En fazla bir posta adresi birincil olabilir. Varsayılan değer: "false"
text() xs:string Metin olarak adres. Baştaki ve sondaki boşluk önemli değildir. Dize içindeki yeni satırlar önemlidir.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other Ne ev ne de iş adresi. label, gerçek türü belirtmek için kullanılabilir.
http://schemas.google.com/g/2005#work

Örnekler

<gd:postalAddress>
  500 West 45th Street
  New York, NY 10036
</gd:postalAddress>

Şema

start = postalAddress

postalAddress =
   element gd:postalAddress {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      (xs:string)
   }

gd:derecelendirme

Çevreleyen öğenin (ör. yorum) sayısal puanını belirtir. Her derecelendirme kendi ölçeğine sahiptir, ancak bir hizmet tarafından normalleştirilebilir. Örneğin, bazı hizmetler tüm puanları 1'den 5'e kadar bir ölçeğe dönüştürebilir.

Özellikler

Özellik Tür Açıklama
@average? xs:float Ortalama puan.
@max xs:int Puan ölçeğinin maksimum değeri.
@min xs:int Puan ölçeğinin minimum değeri.
@numRaters? xs:int Ortalama değer hesaplanırken dikkate alınan puan sayısı.
@rel? xs:string Puan verilen yönü belirtir. Belirtilmezse puan, genel bir derecelendirmedir.
@value? xs:int Puan değeri.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#overall veya belirtilmedi Genel puan. Daha yüksek değerler, daha iyi puanlar anlamına gelir.
http://schemas.google.com/g/2005#price Fiyat puanı. Daha yüksek değerler, daha yüksek fiyatlar anlamına gelir.
http://schemas.google.com/g/2005#quality Kalite puanı. Daha yüksek değerler daha yüksek kalite anlamına gelir.

Örnekler

Genel değerlendirme: 4/5

<gd:rating value="4" min="1" max="5"/>

En pahalı fiyat aralığı puanı:

<gd:rating rel="http://schemas.google.com/g/2005#price" value="5" min="1" max="5"/>

5 üzerinden ortalama 4,65 puan alan 200 kullanıcı tarafından derecelendirilmiştir:

<gd:rating average="4.65" min="1" max="5" numRaters="200"/>

Şema

start = rating

rating =
   element gd:rating {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute value { xs:int }?,
      attribute average { xs:float }?,
      attribute min { xs:int },
      attribute max { xs:int },
      attribute numRaters { xs:int }?
   }

gd:yineleme

Düzenli bir etkinliğin gerçekleştiği tarih ve saatleri belirtir.

Yinelenmeyi tanımlayan dize, her biri iCalendar standardında (RFC 2445) tanımlanan bir dizi mülkten oluşur.

Dize, genellikle etkinliğin ilk örneğinin başlangıç zamanını belirten bir DTSTART özelliği ve genellikle ilk örneğin sona erdiğini belirten DTEND özelliği ile başlar. Ardından, yinelenen bir etkinliği ve istisnalarını toplu bir şekilde tanımlayan ({0}aşağıya bakın) R NOKTA, RDATE, ÜLKE ve/veya EXDATE özellikleri gelir. (Bu yineleme bileşeni özellikleri hakkında daha fazla bilgi için RFC 2445'in 4.8.5 numaralı bölümüne bakın.) Son olarak, önceki mülklerde bahsedilen saat dilimi kimliği için ayrıntılı saat dilimi kuralları sağlayan bir Vmyactivity bileşeni gelir.

Google Takvim gibi Google hizmetleri, yinelenen etkinliklerle ilgili istisnaları temsil etmek için genellikle EXCREDIT ve EXDATE özelliklerini oluşturmaz. Bunun yerine <gd:recurrenceException> öğeleri oluşturur. Ancak, Google hizmetleri yine de EXCREDIT ve/veya EXDATE özelliklerini içerebilir; örneğin, kullanıcılar etkinlikleri ve istisnaları Takvim'e aktarabilir ve içe aktarılan bu etkinlikler EXCSR veya EXDATE özelliklerini içeriyorsa Takvim, bir <gd:recurrence> öğesi gönderdiğinde bu özellikleri sağlar.

<gd:recurrenceException> kullanmanın, tekrarlama açıklaması ile ilgili istisnaların olup olmadığı konusunda yalnızca bir <gd:recurrence> öğesini incelediğinizden emin olamayacağınız anlamına gelir. Tüm istisnaları bulmak için feed'de <gd:recurrenceException> öğelerini arayın ve bunları <gd:recurrence> öğeleriyle eşleştirmek için <gd:originalEvent> öğelerini kullanın.

Özellikler

Özellik Tür Açıklama
text() xs:string Yinelenme açıklaması.

Örnek

Her sabah 06:00 ile 07:00 arasında yinelenen bir etkinlik Pasifik saati, 14 Mart - 21 Mart 2006:

<gd:recurrence>
  DTSTART;TZID=America/Los_Angeles:20060314T060000
  DURATION:PT3600S
  RRULE:FREQ=DAILY;UNTIL=20060321T220000Z
  BEGIN:VTIMEZONE
  TZID:America/Los_Angeles
  X-LIC-LOCATION:America/Los_Angeles
  BEGIN:STANDARD
  TZOFFSETFROM:-0700
  TZOFFSETTO:-0800
  TZNAME:PST
  DTSTART:19671029T020000
  RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
  END:STANDARD
  BEGIN:DAYLIGHT
  TZOFFSETFROM:-0800
  TZOFFSETTO:-0700
  TZNAME:PDT
  DTSTART:19870405T020000
  RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU
  END:DAYLIGHT
  END:VTIMEZONE
</gd:recurrence>

Şema

start = recurrence

recurrence =
   element gd:recurrence {
      (xs:string)
   }

gd:recurrenceException

Düzenli bir etkinliğin istisnası olan bir etkinliği, yani tekrarlanan etkinliğin bir veya daha fazla unsurunun (katılım listesi, saat veya konum) değiştirildiği bir etkinliği belirtir.

Bu etkinliğin bir istisna olduğu orijinal düzenli etkinliği belirten bir <gd:originalEvent> öğesi içerir.

Düzenli bir etkinliğin örneğini değiştirdiğinizde, söz konusu örnek bir istisna haline gelir. Değişiklikte yaptığınız değişikliğe bağlı olarak, orijinal düzenli etkinlik değiştirildiğinde istisna iki davranıştan biriyle birlikte çalışır:

  • Yorumları, katılımcıları veya katılımcı yanıtlarını ekler, değiştirir ya da kaldırırsanız istisna, orijinal etkinliğe bağlı kalır ve orijinal etkinlikte yapılan değişiklikler de istisnayı değiştirir.
  • İstisnada başka değişiklikler yaparsanız (örneğin, zamanı veya yeri değiştirirseniz) örnek "özel" hale gelir, yani artık orijinal etkinliğe sıkı bir şekilde bağlı değildir. Orijinal etkinliği değiştirirseniz özel istisnalar değişmez. Ancak aşağıya bakın.

Örneğin, her Salı ve Perşembe 14:00'te bir toplantınız olduğunu varsayalım. Bu Perşembe gününün toplantısı için katılım listesini değiştirirseniz (ancak düzenli olarak planlanan toplantı için değil) bu istisnaya tabidir. Bu perşembe toplantısının zamanını değiştirirseniz (düzenli olarak planlanan bir toplantı için değil) toplantı özelleştirilir.

Bir istisnanın özel olup olmadığına bakılmaksızın, istisnanın türetildiği örneği silen bir istisna yaparsanız istisna silinir. Düzenli bir etkinliğin gününü veya saatini değiştirdiğinizde tüm örneklerin silinip yeni örnekler oluşturulduğunu unutmayın.

Örneğin, bu perşembenin toplantısını uzmanlaştırdıktan sonra, yinelenen toplantıyı pazartesi, çarşamba ve cuma günleri yapılacak şekilde değiştirdiğinizi varsayalım. Bu değişiklik, özel etkinlik de dahil olmak üzere Salı/Perşembe toplantısının tüm yinelenen örneklerini siler.

Düzenli bir etkinliğin belirli bir örneği silinirse bu örnek, <gd:eventStatus> içinde "http://schemas.google.com/g/2005#event.canceled" bulunan, <gd:entryLink> değerini içeren bir <gd:recurrenceException> olarak görünür. (İptal edilen etkinlikler hakkında daha fazla bilgi için RFC 2445'e bakın.)

Özellikler

Özellik Tür Açıklama
@specialized xs:boolean İstisnanın özel olup olmadığını gösterir.
gd:entryLink entryLink İstisnayla ilgili ayrıntıları sağlayan etkinlik girişi.
gd:originalEvent originalEvent Bunun bir istisnası olan orijinal düzenli etkinlik.

Örnek

Yinelenen bir etkinliğe istisna (bazı bölümlerin net olması için kısa italik tanımlayıcılarla değiştirilmesi):

<gd:recurrenceException specialized="true">
  <gd:entryLink>
    <entry>
      <id>i8fl1nrv2bl57c1qgr3f0onmgg_20060317T220000Z</id>
      <published>2006-03-17T23:00:00.000Z</published>
      <updated>2006-03-14T21:33:12.000Z</updated>
      <category scheme="http://schemas.google.com/g/2005#kind"
        term="http://schemas.google.com/g/2005#event"/>
      <title type="text">recurrence</title>
      <content type="text"/>
      <link rel="alternate" type="text/html"
        href="http://www.google.com/calendar/event?eid=idString"
        title="alternate"/>
      <author>
        <name>exception</name>
      </author>
      <gd:eventStatus
        value="http://schemas.google.com/g/2005#event.confirmed"/>
      <gd:comments>
        <gd:feedLink
            href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/">
          <feed>
            <updated>2006-03-14T21:36:23.250Z</updated>
            <title type="text">Comments for: recurrence</title>
            <link rel="alternate" type="text/html"
              href="http://www.google.com/calendar/feeds/userID/private-magicCookie/full/eventID/comments/"
              title="alternate"/>
          </feed>
        </gd:feedLink>
      </gd:comments>
      <gd:transparency
        value="http://schemas.google.com/g/2005#event.opaque "/>
      <gd:originalEvent id="i8fl1nrv2bl57c1qgr3f0onmgg"
          href="http://www.google.com/calendar/feeds/userID/private-magicCookie/composite/eventID">
        <gd:when startTime="2006-03-17T22:00:00.000Z"/>
      </gd:originalEvent>
      <gd:where valueString="Home"/>
      <gd:when startTime="2006-03-17T23:00:00.000Z"
        endTime="2006-03-18T00:00:00.000Z"/>
    </entry>
  </gd:entryLink>
</gd:recurrenceException>

Şema

start = recurrenceException

recurrenceException =
   element gd:recurrenceException {
      attribute specialized { xs:boolean },
      (entryLink
       & originalEvent)
   }

gd:hatırlatıcı

En sık kullanıldığı yerler: <gd:when>

Kapsayıcı varlığın @startTime veya @dueTime özelliğinden ne kadar süre önce hatırlatıcı gönderilmesi gerektiğini gösteren zaman aralığı. Alternatif olarak, hatırlatıcının gönderileceği mutlak süreyi de belirtebilirsiniz. Ayrıca, sistemin kullanıcıya hangi aracı kullanması gerektiğini belirten bir bildirim yöntemi de belirtir.

Özellikler

Özellik Tür Açıklama
@absoluteTime? xs:dateTime Hatırlatıcının verilmesi gereken mutlak zaman. Bu genellikle, bir kullanıcı önceki bir hatırlatıcıyı ertelemek için "ertele" özelliğini kullandığında kullanılır. Saat dilimi belirtilmezse gözlemleyicinin yerel saati dikkate alınır.
@method? xs:string Hatırlatıcının kullanması gereken bildirim yöntemi. Şu değerlerden herhangi birine sahip olabilir: alert (kullanıcı bir tarayıcıda takvimi görüntülerken uyarı gösterilmesine neden olur), email (kullanıcıya e-posta mesajı gönderir) veya sms (kullanıcıya SMS kısa mesajı gönderir).
@days? xs:unsignedInt gd:when/@startTime tarihinden önce hatırlatıcı gönderilmesi gereken süre. Üst varlığın hedef saati belirli bir saat yerine tarihse bu özellikler söz konusu tarihte gece yarısına (00:00) göre gösterilir.
@hours? xs:unsignedInt
@minutes? xs:unsignedInt

<gd:when> girişi oluştururken veya düzenlerken belirli sonuçlara ulaşmak için aşağıdaki kuralları kullanın:

  • Hizmete, kullanıcının varsayılan hatırlatıcılarını kullanmasını bildirmek için, özelliği olmayan bir <gd:reminder> öğesi ekleyin. Bir süre belirtirseniz ancak hiçbir method özelliği belirtmezseniz hizmet, belirttiğiniz süre boyunca kullanıcının varsayılan bildirim yöntemlerini kullanır.
  • Hizmete etkinlik için hatırlatıcı yayınlamamasını (veya etkinliği güncellerken mevcut hatırlatıcıları kaldırmasını) bildirmek için <gd:reminder> öğelerini eklemeyin.

Kısıtlamalar

  • @days, @hours, @minutes veya @absoluteTime değerlerinden en fazla biri belirtilebilir. Karma süre belirtmek için en kesin birimi dönüştürün. Örneğin, 1 saat 30 dakika belirtmek için @minutes="90" kullanın.
  • Özellikler için negatif değerleri kullanamazsınız. Bu nedenle, başlangıç zamanından sonra hatırlatıcı olmasını istiyorsanız @absoluteTime etiketini kullanmanız gerekir.)
  • Belirli bir etkinlikle ilişkili beşten fazla hatırlatıcı olamaz.
  • Bir etkinliğe hatırlatıcı eklerken alert, email veya sms yöntemlerini belirtirseniz süre de belirtmeniz gerekir.

Örnekler

Toplantı için 15 dakikalık hatırlatıcı:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00">
  <gd:reminder minutes="15"/>
</gd:when>

Yukarıdaki toplantının aynısı, ancak hatırlatıcıdan 16:45'e kadar 10 dakika ertelendi:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00">
  <gd:reminder minutes="15"/>
  <gd:reminder absoluteTime="2005-06-06T16:55:00-08:00"/>
</gd:when>

Şema

start = reminder

reminder =
   element gd:reminder {
      gdCommonProperties,
      attribute absoluteTime { xs:dateTime }?,
      attribute method { xs:string }?,
      attribute days { xs:unsignedInt }?,
      attribute hours { xs:unsignedInt }?,
      attribute minutes { xs:unsignedInt }?
   }

gd:kaynakKimliği

Geçerli bir URI gerekmediğinden atom:id'den farklı, opak bir kaynak tanımlayıcısı. Bazı hizmetler, sonraki istekler oluşturulurken kullanılacak ayrı bir tanımlayıcı sağlar. Tam kullanım hizmete özgüdür.

Örnek

<gd:resourceId>9749638</gd:resourceId>

Şema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:yapılandırılmışPostaAdresi

Posta adresi bileşenlere ayrılmıştır. Adresin yerel ayardan bağımsız biçimde depolanmasını sağlar. Alanlar yorumlanabilir ve yerel ayara bağlı biçimlendirilmiş adres oluşturmak için kullanılabilir. Şu öğeler, adresin bölümlerini temsil etmiştir: aracı, ev adı, sokak, posta kutusu, mahalle, şehir, alt bölge, bölge, posta kodu, ülke. subregion öğesi posta adresleri için kullanılmaz, yalnızca adreslerin genişletilmiş kullanımları için sağlanır. Posta adresinin yapılandırılmamış bir biçimde depolanması için biçimlendirilmiş adres alanı sağlanır.

Özellikler

Özellik Tür Açıklama
@rel? xs:string Adres türü. Belirtilmediği sürece work türü varsayılır.
@mailClass? xs:string Adreste kabul edilen posta sınıfları. Belirtilmediği sürece both kabul edilir.
@usage? xs:string Bu adresin kullanılabileceği bağlam. Yerel adreslerin düzeni, genel adreslerden farklılık gösterebilir ve genellikle yerel komut dosyasına (Latin alfabesi yerine) kullanılır, ancak genel adreslerde yerel komut dosyasına izin verilir. Belirtilmediği sürece general kullanımı varsayılır.
@label? xs:string Adresin genel etiketi.
@primary? xs:boolean Adresi birincil olarak belirtir. Varsayılan değer: false
gd:agent? agent E-postayı alan temsilci. İş adreslerinde kullanılır. "Bakım" veya "c/o" için de geçerlidir.
gd:housename? housename Evlerin veya binaların adlarının (ve sayılara sahip olmaması) gereken yerlerde kullanılır. Örneğin, "Sütunlar".
gd:street? street Sokak, bulvar, yol vb. olabilir. Bu öğe ayrıca ev numarasını ve oda/apartman/düz/kat numarasını da içerir.
gd:pobox? pobox Posta kutuları, çekmeceler, kilitli bagajlar vb. için geçerlidir. Bu seçenek genellikle sokak dışında her zaman karşılıklı dışlayıcı değildir.
gd:neighborhood? neighborhood Bu bilgi, bir şehrin, aynı ada sahip birden fazla sokak içermesi halinde bir sokak adresini belirginleştirmek veya postalarının büyük bir posta şehri üzerinden yönlendirildiği küçük bir yeri belirtmek için kullanılır. Çin'de bu bir ilçe veya küçük bir şehir olabilir.
gd:city? city Şehir, köy, kasaba, ilçe vb. olabilir. Bu, posta şehridir ve mutlaka ikamet yeri veya iş yeri değildir.
gd:subregion? subregion Posta adresi olarak kullanılmayan ABD veya İngiltere ilçeleri gibi idari bölgeleri yönetir. Alt bölge, teslimat adresleri için tasarlanmamıştır.
gd:region? region Eyalet, il, ilçe (İrlanda), Land (Almanya'da), kalkış (Fransa'da) vb.
gd:postcode? postcode Posta kodu. Genellikle ülke genelindedir, ancak bazen şehre özgüdür (ör. "Dublin 2, İrlanda" adreslerinde "2").
gd:country? country Ülkenin adı veya kodu.
gd:formattedAddress? formattedAddress Tam ve yapılandırılmamış posta adresi.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#work İş adresi. Aksi belirtilmediği sürece varsayılan değer budur.
http://schemas.google.com/g/2005#home Ev adresi.
http://schemas.google.com/g/2005#other Başka herhangi bir adres türü.

mailClass değerleri

Değer Açıklama
http://schemas.google.com/g/2005#both Adreslere paket ve mektup gönderilebilir. Aksi belirtilmediği sürece varsayılan değer budur.
http://schemas.google.com/g/2005#letters Adrese yalnızca harfler gönderilebilir.
http://schemas.google.com/g/2005#parcels Adrese yalnızca paketler gönderilebilir.
http://schemas.google.com/g/2005#neither Adres yalnızca konumsaldır ve posta için kullanılamaz.

kullanım değerleri

Değer Açıklama
http://schemas.google.com/g/2005#general Bu adres genel kullanım içindir. Aksi belirtilmediği sürece varsayılan değer budur.
http://schemas.google.com/g/2005#local Bu adres yerel kullanıma yöneliktir.

Örnekler

Şirket adresi:

Mr. John Doe
Google Inc.
1600 Amphitheatre Parkway
Mountain View, CA 94043
<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#letters' label='John at Google'>
  <gd:street>1600 Amphitheatre Parkway</gd:street>
  <gd:city>Mountain View</gd:city>
  <gd:region>CA</gd:region>
  <gd:postcode>94043</gd:postcode>
</gd:structuredPostalAddress>

Özel adres:

Madame Duval
27, rue Pasteur
14390 CABourG
FRANSA
<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#both' label='Madame Duval'>
  <gd:street>27, rue Pasteur</gd:street>
  <gd:city>CABOURG</gd:city>
  <gd:postcode>14390</gd:postcode>
  <gd:country>FRANCE</gd:country>
</gd:structuredPostalAddress>

Şema

start = structuredPostalAddress

structuredPostalAddress =
   element gd:structuredPostalAddress {
      attribute label { xs:string }?,
      attribute mailClass { xs:string }?,
      attribute primary { xs:boolean }?,
      attribute rel { xs:string }?,
      attribute usage { xs:string }?,
      (agent?
       & housename?
       & street?
       & poBox?
       & neighborhood?
       & city?
       & subregion?
       & region?
       & postcode?
       & country?
       & formattedAddress? )
}

Kısıtlamalar

  • Bir varlıkta hem "gd:postalAddress" hem "gd:structuredPostalAddress" bulunması yasaktır.
  • Birincil olarak yalnızca bir yapılandırılmış adres belirtilebilir.
  • Yapılandırılmamış posta adresi, yapılandırılmış verilerle tutarlı olmalıdır.

gd:ne zaman

Belirli bir dönemi veya anı temsil eder.

Özellikler

Özellik Tür Açıklama
@endTime? xs:dateTime veya xs:date Etkinliğin ne zaman sona erdiğini belirtir. Saat dilimi belirtilmezse gözlemleyicinin yerel saat dilimi kullanılır.
@startTime xs:dateTime veya xs:date Etkinliğin ne zaman başladığını veya (sıfır süreli etkinlikler için) ne zaman gerçekleştiğini açıklar. Saat dilimi belirtilmezse gözlemleyicinin yerel saat dilimi kullanılır.
@valueString? xs:string Bu dönemin temsili olarak kullanılabilecek basit bir dize değeri.

Kısıtlamalar

  • startTime ile endTime içinde xs:dateTime ile xs:date karıştırılamaz.
  • endTime belirtilmezse etkinlik anlık olarak (@startTime bir saat içeriyorsa) veya bir günlük etkinlik (@startTime yalnızca bir tarihse) olarak kabul edilir.

Örnekler

Bir günlük etkinlik:

<gd:when startTime="2005-06-06"/>

Bir günlük etkinliğin alternatif temsili:

<gd:when startTime="2005-06-06" endTime="2005-06-07"/>

Dize açıklaması içeren iki günlük etkinlik (6 Haziran ve 7 Haziran'da):

<gd:when startTime="2005-06-06" endTime="2005-06-08" valueString="This weekend"/>

Bir saatlik toplantı:

<gd:when startTime="2005-06-06T17:00:00-08:00" endTime="2005-06-06T18:00:00-08:00"/>

Sıfır süreli etkinlik:

<gd:when startTime="2005-06-06T17:00:00-08:00"/>

Şema

start = when

when =
   element gd:when {
      gdCommonProperties,
      attribute startTime { (xs:date | xs:dateTime) },
      attribute endTime { (xs:date | xs:dateTime) }?,
      attribute valueString { xs:string }?
   }

gd:nerede

Kapsayıcı varlıkla ilişkili bir yer (ör. etkinlik konumu). İlişkilendirmenin türü rel özelliği tarafından belirlenir. Konumun ayrıntıları, yerleştirilmiş veya bağlı bir Kişi girişinde yer alır.

<gd:where> öğesi, <gd:geoPt> öğesinden daha geneldir. Birincisi, bir yeri metin açıklaması ve/veya Kişi girişi kullanarak tanımlarken, ikincisi belirli bir coğrafi konumu kullanan yeri tanımlar.

Özellikler

Özellik Tür Açıklama
@label? xs:string Bu konumu diğer konumlardan ayırt etmek için kullanıcı tarafından okunabilir bir etiket belirtir.
@rel? xs:string Kapsayıcı varlık ile içerilen konum arasındaki ilişkiyi belirtir. Olası değerler (aşağıya bakın) diğer unsurlar tarafından tanımlanır. Örneğin, <gd:when>, http://schemas.google.com/g/2005#event alanını tanımlıyor.
@valueString? xs:string Bu konumu temsil etmek için kullanılabilecek basit bir dize değeri.
gd:entryLink? entryLink Konum ayrıntılarını temsil eden giriş. Bu giriş, İletişim türünü uygulamalıdır.

rel değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event veya belirtilmedi Çevreleyen etkinliğin gerçekleştiği yer.
http://schemas.google.com/g/2005#event.alternate İkincil konum. Örneğin, ana siteye video konferans bağlantısı içeren uzak bir site.
http://schemas.google.com/g/2005#event.parking Yakındaki bir otopark.

Örnekler

Etkinlik konumu:

<gd:where valueString="Google Cafeteria (Building 40)"/>

Daha karmaşık etkinlik yeri:

<gd:where rel="http://schemas.google.com/g/2005#event" valueString="Joe's Pub">
  <gd:entryLink href="http://local.example.com/10018/JoesPub">
    <gd:entry>
      <id>http://local.example.com/10018/JoesPub</id>
      <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#contact"/>
      <content>Nice place to listen to jazz music</content>
      <link href="http://www.joespub.com"/>
      <gd:postalAddress>500 West 45th Street, New York, NY 10018</gd:postalAddress>
      <gd:geoPt lat="40.75" lon="-74.0"/>
      <gd:phoneNumber>(212) 555-1212</gd:phoneNumber>
      <gd:email address="info@joespub.com"/>
    </gd:entry>
  </gd:entryLink>
</gd:where>

Birden fazla konuma sahip etkinlik:

<gd:where label="Mountain View Location (main)"
         valueString="Google Cafeteria (Building 40)"/>

<gd:where rel="http://schemas.google.com/g/2005#event.alternate"
         label="New York Location (videoconference)"
         valueString="Metropolis"/>

Şema

start = where

where =
   element gd:where {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute label { xs:string }?,
      attribute valueString { xs:string }?,
      (entryLink?)
   }

gd:kim

Bulunduğu tüzel kişiyle ilişkili bir kişi. İlişkilendirmenin türü rel özelliği tarafından belirlenir. Kişiyle ilgili ayrıntılar, yerleştirilmiş veya bağlı bir Kişi girişinde yer alır.

<gd:who> öğesi, e-posta gönderenler ile alıcıları, takvim etkinliğini düzenleyenleri vs. belirtmek için kullanılabilir.

Özellikler

Özellik Tür Açıklama
@email? xs:string E-posta adresi. Bu özellik genellikle <gd:entryLink> belirtilmemişse kullanılır. Adres, RFC 2822 bölüm 3.4.1'e uygun olmalıdır.
@rel? xs:string Kapsanan varlık ve kapsayıcı kişi arasındaki ilişkiyi belirtir. Olası değerler için aşağıya bakın.
@valueString? xs:string Bu kişiyi temsil etmek için kullanılabilecek basit bir dize değeri.
gd:attendeeStatus? gEnumConstruct Etkinlik katılımcısının durumu. Aşağıda belirtilen genişletilebilir numaralandırma.
gd:attendeeType? gEnumConstruct Etkinlik katılımcısı türü. Aşağıda belirtilen genişletilebilir numaralandırma.
gd:entryLink? entryLink Kişi ayrıntılarını temsil eden giriş. Bu giriş, İletişim türünü uygulamalıdır. Çoğu durumda bu giriş bir kişi feed'inden gelir.

rel değerleri

@rel için geçerli değerler, <gd:who> öğesinin hangi türde göründüğüne bağlıdır.

Değer Tür Açıklama
http://schemas.google.com/g/2005#event.attendee Etkinlik Genel bir toplantı/etkinlik katılımcısı.
http://schemas.google.com/g/2005#event.organizer Etkinlik Etkinliği düzenleyen kullanıcı. Düzenleyen kullanıcı olmanız gerekmez.
http://schemas.google.com/g/2005#event.performer Etkinlik Sanatçı. http://schemas.google.com/g/2005#event.speaker örneğine benzer, ancak resim teslimatına kıyasla sanata daha fazla önem verilir.
http://schemas.google.com/g/2005#event.speaker Etkinlik Hoparlör.
http://schemas.google.com/g/2005#message.bcc İleti BCC alıcısına mesaj gönder.
http://schemas.google.com/g/2005#message.cc İleti İleti CC alıcısı.
http://schemas.google.com/g/2005#message.from İleti İleti (e-posta veya IM) göndereni.
http://schemas.google.com/g/2005#message.reply-to İleti Bir yanıt mesajının amaçlanan alıcısı.
http://schemas.google.com/g/2005#message.to İleti Mesaj birincil alıcısı.

gd:attendeeType Değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event.optional İsteğe bağlı katılımcı.
http://schemas.google.com/g/2005#event.required Gereken katılımcı.

gd:attendeeStatus Değerleri

Değer Açıklama
http://schemas.google.com/g/2005#event.accepted Katılımcı kabul etti.
http://schemas.google.com/g/2005#event.declined Katılımcı reddetti.
http://schemas.google.com/g/2005#event.invited Davetiye gönderildi ancak kişi daveti kabul etmedi.
http://schemas.google.com/g/2005#event.tentative Katılımcılar geçici olarak kabul etti.

Örnekler

E-posta alıcıları:

<gd:who rel="http://schemas.google.com/g/2005#message.from" email="jo@example.com"/>
<gd:who rel="http://schemas.google.com/g/2005#message.to" valueString="Elizabeth" email="liz@example.com"/>

Toplantı katılımcısı:

<gd:who rel="http://schemas.google.com/g/2005#event.attendee" valueString="Jo">
  <gd:attendeeType value="http://schemas.google.com/g/2005#event.required"/>
  <gd:attendeeStatus value="http://schemas.google.com/g/2005#event.tentative"/>
  <gd:entryLink href="http://gmail.com/jo/contacts/Jo">
    <entry>
      <id>http://gmail.com/jo/contacts/Jo</id>
      <category term="user-tag" label="Google"/>
      <title>Jo March</title>
      <gd:email address="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

Etkinliği düzenleyen kullanıcı:

<gd:who rel="http://schemas.google.com/g/2005#event.organizer" valueString="Receptionist 41"/>

Şema

start = who

who =
   element gd:who {
      gdCommonProperties,
      attribute rel { xs:string }?,
      attribute email { xs:string }?,
      attribute valueString { xs:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

Başa dön

1.0 sürümünden sonraki değişiklikler

Kişi türünde yapılan değişiklikler

Aşağıdaki sürüm 1.0'da bulunmayan öğeler, kişi türünün sürüm 2.0'ına eklenmiştir:

Sürüm 1.0'da bulunmayan aşağıdaki telefon türleri sürüm 2.0'a eklenmiştir:

  • http://schemas.google.com/g/2005#assistant
  • http://schemas.google.com/g/2005#callback
  • http://schemas.google.com/g/2005#car
  • http://schemas.google.com/g/2005#company_main
  • http://schemas.google.com/g/2005#isdn
  • http://schemas.google.com/g/2005#main
  • http://schemas.google.com/g/2005#other_fax
  • http://schemas.google.com/g/2005#radio
  • http://schemas.google.com/g/2005#telex
  • http://schemas.google.com/g/2005#tty_tdd
  • http://schemas.google.com/g/2005#work_mobile
  • http://schemas.google.com/g/2005#work_pager

Sürüm 1.0'da bulunmayan aşağıdaki IM türü, sürüm 2.0'da eklenmiştir:

  • http://schemas.google.com/g/2005#netmeeting

Aşağıdaki 1.0 kişi türü öğeleri artık desteklenmemektedir:

  • atom:title: Sunucu tarafından döndürülen girişlerde bulunmaya devam eder ancak PUT ve POST isteklerinde yoksayılır. gd:name tarafından değiştirildi.
  • gd:postalAddress - gd:structuredPostalAddress ile değiştirildi.

gd:email ile ilgili değişiklikler

@displayName adlı yeni özellik, 2.0 sürümünde gd:email uygulamasına eklendi

gd:organization ile ilgili değişiklikler

gd:organization alt öğeleri 2.0 sürümünde kullanıma sunuldu:

  • gd:orgDepartment
  • gd:orgJobDescription
  • gd:orgSymbol
  • gd:where

gd:orgName ile ilgili değişiklikler

2.0 sürümünde gd:orgName öğesi, @yomi özelliği eklenerek geliştirilmiştir.

Başa dön