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ıralama
- gdCommonProperties
- gd:ekAd
- gd:yorumlar
- gd:ülke
- gd:silindi
- gd:e-posta
- gd:girişBağlantısı
- gd:extendedProperty
- gd:aileAdı
- gd:feedBağlantısı
- gd:coğrafi konum
- gd:VerilenAd
- gd:g
- gd:kuruluş
- gd:orgDepartmanı
- gd:orgİşAçıklaması
- gd:kuruluşAdı
- gd:orgSembol
- gd:orgBaşlık
- gd:orijinalEtkinlik
- gd:telefonNumarası
- gd:postalAdresi
- gd:puan
- gd:yineleme
- gd:recurrenceException
- gd:hatırlatıcı
- gd:yapılandırılmışPostaAdresi
- 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: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
veyaPOST
,<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şseatom: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çbirmethod
ö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
veyasms
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:
<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:
<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
ileendTime
içindexs:dateTime
ilexs: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 }?) }
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:
gd:name
gd:structuredPostalAddress
gd:where
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 ancakPUT
vePOST
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.