Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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

Ö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ı.
`gd:email`*	E-posta adresleri.
`gd:im`*	IM adresleri
`gd:phoneNumber`*	Telefon ve faks numaraları.
`gd:postalAddress`*	Posta adresleri.
`gd:organization`*	Düzen.
`gd:extendedProperty`*	Genişletilmiş mülk.
`gContact:groupMembershipInfo`*	Grup üyeliği bilgileri.
`gd:deleted`*	Kişi girişinin durumu silindi.

Ö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>

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: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ıralama
gdCommonProperties
gd:yorumlar
gd:silindi
gd:e-posta
gd:girişBağlantısı
gd:extendedProperty
gd:feedBağlantısı
gd:coğrafi konum
gd:g
gd:kuruluş
gd:kuruluşAdı
gd:orgBaşlık
gd:orijinalEtkinlik
gd:telefonNumarası
gd:postalAdresi
gd:puan
gd:yineleme
gd:recurrenceException
gd:hatırlatıcı
gd:ne zaman
gd:burada
gd:kim

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:yorumlar

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

Özellikler

Özellik	Tür	Açıklama
`@rel`?	`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: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.
`@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"/>
<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 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 {scheme}#{local-name} kuralını izler.
`@value`?	`xs:string`	Mülk değeri.

Ö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*)
   }

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#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: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.
`@rel`?	`xs:string`	Kuruluşun türünü tanımlayan programatik değer.
`@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"`
`gd:orgName`?	`orgName`	Kurumun adı.
`gd:orgTitle`?	`orgTitle`	Kuruluştaki bir kişinin unvanı.

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:organization>

Şema

start = organzation

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
      orgName?,
      orgTitle?,
   }

gd:kuruluşAdı

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

Örnek

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

Şema

start = orgName

orgName =
   element gd:orgName { 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#fax`
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#home_fax`
`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. Örneğin, bir TTY cihaz. `label`, gerçek türü belirtmek için kullanılabilir.
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`

Ö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: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 { xsd:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

Başa dön