Gängige Elemente: „Kinds“

Warnung: Diese Seite bezieht sich auf die älteren Google Data APIs. Sie ist nur für die APIs relevant, die im Verzeichnis der Google Data APIs aufgeführt sind. Viele davon wurden durch neuere APIs ersetzt. Informationen zu einer bestimmten neuen API finden Sie in der Dokumentation der neuen API. Informationen zum Autorisieren von Anfragen mit einer neueren API finden Sie unter Authentifizierung und Autorisierung von Google-Konten.

Einführung

Häufig ist es nützlich für Dienste, die die Google Data APIs verwenden, um konsistente Informationen zu einer bestimmten Art von Elementen bereitzustellen.

Verschiedene Google Data API-Dienste (oder „GData“)-Dienste können beispielsweise Kontaktdaten für eine Person oder eine Organisation bereitstellen. Es ist sinnvoll, für alle entsprechenden Dienste dieselben Kontaktdateninformationen zu verwenden.

Die Sammlung von Elementen, die zusammen einen Kontakt beschreiben, wird als Kontaktart bezeichnet. Einige Elemente der Art "Contact" sind gewöhnliche Atom- oder RSS-Elemente. Andere werden von Google in einem Namespace namens "Google Data Namespace" definiert. Per Konvention wird der Google Data-Namespace im XML-Code mit dem Alias gd: bezeichnet. Das Element mit einer Telefon- oder Faxnummer ist beispielsweise <gd:phoneNumber>. Die Schema-URL für den Google Data-Namespace lautet http://schemas.google.com/g/2005.

Google definiert auch andere Arten: Ereignis (eine Sammlung standardisierter Elemente, die gemeinsam einen Kalendertermin darstellen) und Nachricht (eine Sammlung von Elementen, die eine E-Mail-Nachricht, eine Diskussionsgruppe oder eine andere Nachricht repräsentieren).

Einige Elemente aus dem Google Data-Namespace werden von mehreren Arten verwendet. Beispielsweise verknüpft das <gd:who>-Element eine Person (im <gd:who> beschrieben) mit dem Eintrag, der das <gd:who>-Element enthält. Dieses Element wird in der Ereignisart verwendet, um Organisatoren, Gäste usw. anzugeben. Er wird auch im Nachrichtentyp verwendet, um Absender und Empfänger anzugeben.

Wenn ein Eintrag in einem Google Data API-Feed einen bestimmten Typ verwendet, enthält er ein <atom:category>-Element, bei dem das Attribut scheme auf "http://schemas.google.com/g/2005#kind" und das Attribut term auf den Namen der Schema-URL, gefolgt vom Namen des Typs, festgelegt ist. Ein Kontakteintrag enthält beispielsweise das folgende Element:

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

So können Clients schnell und einfach ermitteln, welche Art von Daten der Eintrag enthält, und somit die Semantik des Eintrags ermitteln. Wenn Sie möchten, können Sie auch RSS anstelle von Atom verwenden. Informationen zu den Atom-Elementen finden Sie in der Protokollreferenz.

Dieses Dokument ist eine Referenz für einige gängige Arten und die darin enthaltenen Elemente.

Nicht dokumentierte Elemente

Wir nehmen keine Informationen zu den Standardelementen von <atom:entry> in Arten auf, bei denen diese Elemente ihre Standardbedeutung haben. Zum Beispiel haben <atom:id>, <atom:published> und <atom:updated> alle ihre Standardbedeutungen, wenn sie in Arten vorkommen.

Wir nehmen auch keine Informationen zu standardmäßigen Atom-Elementen auf, die im gegebenen Kontext bedeutungslos sind. <atom:summary> wird beispielsweise in der Kontaktart nicht verwendet und <atom:author> ist zwar ein erforderliches Element in einem Eintrag (es sei denn, es ist im übergeordneten Feed angegeben), hat aber keine nützliche Bedeutung bei der Kontaktart.

Arten erstellen

Es kann schwierig sein, genau zu bestimmen, welche Informationen Sie beim Erstellen eines Eintrags einer bestimmten Art angeben müssen, insbesondere weil einige Elemente in den Arten andere Arten enthalten.

Ein Ansatz, der dabei helfen könnte, ist die Verwendung der von uns bereitgestellten Clientbibliotheken anstelle der manuellen Erstellung von Arten. Die Clientbibliotheken bieten verschiedene Methoden zum Hinzufügen und Ändern von Daten in einem Eintrag eines bestimmten Typs. Weitere Informationen finden Sie in der Dokumentation der Clientbibliothek.

Erweiterbarkeit

In diesem Dokument werden nicht alle möglichen Eigenschaften und Attributwerte für Arten behandelt. Dienste können Typen erweitern. Daher kann ein bestimmter Dienst Eigenschaften und Werte verwenden, die in diesem Dokument nicht enthalten sind.

Typografische Konventionen

In den Tabellen dieses Dokuments verwenden wir die folgenden Konventionen für erforderliche und optionale Elemente:

Elementname	Erforderliches Element
ElementName?	Optionales Element
ElementName*	Optionales Element, mehrere Instanzen zulässig

Elemente und Attribute werden in der Standard-XPath-Notation dargestellt.

Kontaktart

Ein Kontakt: eine Person, ein Veranstaltungsort wie ein Club, ein Restaurant oder eine Organisation.

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

Hinweis: Wenn Sie die Kontaktart im Kontext der Contacts API verwenden, beachten Sie bitte, dass die Version der Kontaktart 2.0 (wie in diesem Dokument beschrieben) seit Version 3.0 der Kontakte API verwendet wird.

Attribute

Attribut	Beschreibung
atom:category*	Kategorien. Instanzen mit dem Attribut @label werden als Tags behandelt. Informationen zur Verwendung des Attributs @scheme finden Sie im Hinweis am Anfang dieses Abschnitts.
atom:content	Hinweise zum Kontakt.
atom:link*	Links zu verwandten Informationen. atom:link[@rel='alternate'] ist mit einer HTML-Seite verknüpft, auf der der Kontakt beschrieben wird.
atom:title	Kontaktname Dieses Feld ist schreibgeschützt. Informationen zum Ändern des Kontaktnamens finden Sie unter gd:name.
gd:email*	E-Mail-Adressen.
gd:extendedProperty*	Erweiterte Property.
gd:deleted?	Wenn dieses Element vorhanden ist, wurde der Kontakteintrag gelöscht.
gd:im*	IM-Adressen.
gd:name?	Name des Kontakts in strukturierter Form.
gd:organization*	Organisation.
gd:phoneNumber*	Telefon- und Faxnummern.
gd:structuredPostalAddress*	Postanschrift des Kontakts in strukturierter Form.
gd:where?	Ein Ort, der dem Kontakt zugeordnet ist.

Beispiele

<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='[e-mail]'/>
  <gd:email rel='http://schemas.google.com/g/2005#home' address='[e-mail]'/>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#work' primary='true'>
    [phone]
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
    [phone]
  </gd:phoneNumber>
  <gd:phoneNumber rel='http://schemas.google.com/g/2005#mobile'>
    [phone]
  </gd:phoneNumber>
  <gd:im rel='http://schemas.google.com/g/2005#home' 
      protocol='http://schemas.google.com/g/2005#GOOGLE_TALK' 
      address='[e-mail]'/>
  <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>

Profilart

Profil, das mit einem Google-Nutzer oder einer anderen Entität verknüpft ist Die Art der Profilart ist ähnlich aufgebaut wie die Kontaktart. Er unterscheidet sich jedoch in einigen Punkten: Er darf weder erweiterte Eigenschaften enthalten noch als gelöscht gekennzeichnet sein.

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

Die Profilart wurde in Version 3.0 der Contacts API eingeführt.

Attribute

Attribut	Beschreibung
atom:category*	Kategorien. Instanzen mit dem Attribut @label werden als Tags behandelt. Informationen zur Verwendung des Attributs @scheme finden Sie im Abschnitt „Kategorieelement“ am Anfang dieses Abschnitts.
atom:content	Hinweise zum Profil.
atom:link*	Links zu verwandten Informationen. atom:link[@rel='alternate'] ist mit einer HTML-Seite verknüpft, auf der das Profil beschrieben wird.
atom:title	Name des Profils. Dieses Feld ist schreibgeschützt.
gd:email*	E-Mail-Adressen.
gd:im*	IM-Adressen.
gd:name?	Name in strukturierter Form
gd:organization*	Organisation.
gd:phoneNumber*	Telefon- und Faxnummern.
gd:structuredPostalAddress*	Postanschrift in strukturierter Form
gd:where?	Ein dem Profil zugeordneter Ort

Beispiele

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

Ereignisart

Ein Kalendertermin Der Veranstaltungsort wird durch eine Art von Kontakt repräsentiert, die in ein <gd:where>-Element eingebettet ist. Die Veranstaltungsplaner und -teilnehmer werden als Kontakttypen dargestellt, die in <gd:who>-Elementen eingebettet sind.

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

Attribute

Attribut	Beschreibung
atom:author	Person, die diesen Termin erstellt hat.
atom:category*	Kategorien. Instanzen mit dem Attribut @label werden als Tags behandelt. Informationen zur Verwendung des Attributs @scheme finden Sie im Hinweis am Anfang dieses Abschnitts.
atom:content	Längere Beschreibung des Ereignisses
atom:link*	Links: atom:link[@rel='alternate'] bietet einen Link zu einer HTML-Seite, die das Ereignis beschreibt.
atom:title	Kurzer Titel für die Veranstaltung.
gd:comments?	Kommentarfeed.
gd:eventStatus?	Erweiterbare Aufzählung unten.
gd:extendedProperty*	Erweiterte Property.
gd:originalEvent?	Ursprüngliche Ereignis-ID für wiederkehrende Termine.
gd:recurrence?	Wiederholungsregel.
gd:transparency?	Die unten aufgeführte erweiterbare Aufzählung, die der in RFC 2445 definierten TRANSP-Eigenschaft entspricht.
gd:visibility?	Erweiterbare Aufzählung unten.
gd:when*	Ereignisdauer Die Attribute startTime und endTime müssen beide festgelegt werden, auch wenn es sich bei ganztägigen Ereignissen nur um Datumsangaben handelt und keine Zeiten.
gd:when/gd:reminder*	Erinnerungen für den Termin.
gd:where*	Der Veranstaltungsort oder Dinge in der Nähe, z. B. Parkplätze. Wenn ein <gd:where>-Element auf Feedebene angegeben ist, aber kein <gd:where>-Element auf Eintragsebene, werden die Einträge auf <gd:where> auf Feedebene übernommen.
gd:who*	Personen, die dem Termin zugeordnet sind: Organisator, Teilnehmer, Redner, Künstler usw.
gd:who/gd:attendeeStatus?	Annahmestatus.
gd:who/gd:attendeeType?	Teilnehmertyp: required oder optional.

rel-Werte für gd:where

rel-Wert	Beschreibung
http://schemas.google.com/g/2005#event oder nicht angegeben.	Ort, an dem die Veranstaltung stattfindet
http://schemas.google.com/g/2005#event.alternate	Ein sekundärer Standort. Das kann beispielsweise eine Remote-Website mit einem Link zur Videokonferenz sein.
http://schemas.google.com/g/2005#event.parking	Parkplatz in der Nähe.

gd:eventStatus-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#event.canceled	Die Veranstaltung wurde abgesagt.
http://schemas.google.com/g/2005#event.confirmed	Die Veranstaltung ist geplant.
http://schemas.google.com/g/2005#event.tentative	Die Veranstaltung wird nur vorläufig geplant.

gd:Sichtbarkeitswerte

Wert	Beschreibung
http://schemas.google.com/g/2005#event.confidential	Lasse einige Leser das Ereignis sehen.
http://schemas.google.com/g/2005#event.default	Sie können das Verhalten des Eigentümers des Kalenders übernehmen, in dem der Termin angezeigt wird.
http://schemas.google.com/g/2005#event.private	So können nur wenige Leser das Ereignis sehen.
http://schemas.google.com/g/2005#event.public	Die meisten Leser können das Ereignis sehen.

gd:transparency

Wert	Beschreibung
http://schemas.google.com/g/2005#event.opaque	Zeigt an, dass der Termin die Zeit des Kalenders verbraucht. Die Zeit eines Termins wird in der Suche nach Verfügbarkeit angezeigt.
http://schemas.google.com/g/2005#event.transparent	Zeigt an, dass der Termin im Kalender keine Zeit verbraucht hat. Die Zeit eines Termins wird in der Suche nach Verfügbarkeitsstatus nicht als beschäftigt markiert.

Beispiele

Besprechung:

<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>[e-mail]</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>

Onlineveranstaltung:

<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>[e-mail]</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>

Art der Nachricht

Eine Nachricht, z. B. eine E-Mail, eine Diskussionsgruppe oder ein Kommentar

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

Attribute

Attribut	Beschreibung
atom:category*	Kategorien. Instanzen mit dem Attribut @label werden als Tags behandelt. Informationen zur Verwendung des Attributs @scheme finden Sie im Hinweis am Anfang dieses Abschnitts. Informationen zur Verwendung des Attributs @term finden Sie in der Tabelle unten.
atom:content	Nachrichtentext.
atom:link*	Anhänge in Nachrichten. Wenn Sie einen Anhang hochladen möchten, verwenden Sie <link rel="enclosure"> und platzieren Sie dessen Inhalt in einer Atom-Mediasammlung.
atom:title	Betreff der Nachricht
gd:geoPt?	Geografischer Standort, von dem die Nachricht gepostet wurde
gd:rating?	Qualitätsbewertung gemäß der Definition der App.
gd:who*	Personen, die dieser Nachricht zugeordnet sind Die genaue Semantik hängt vom Wert @rel ab. Siehe Tabelle unten.

Kategorie@@term-Werte

Alle Kategorien unten befinden sich im http://schemas.google.com/g/2005-Schema.

Laufzeit	Beschreibung
http://schemas.google.com/g/2005#message.chat	Die Nachricht ist ein Transkript einer Chatsitzung.
http://schemas.google.com/g/2005#message.inbox	Die Nachricht wurde als zum Posteingang gehörend gekennzeichnet.
http://schemas.google.com/g/2005#message.sent	Die Nachricht ist als gesendet markiert.
http://schemas.google.com/g/2005#message.spam	Die Nachricht wird als Spam eingestuft.
http://schemas.google.com/g/2005#message.starred	Die Nachricht ist als markiert markiert.
http://schemas.google.com/g/2005#message.unread	Die Nachricht ist ungelesen.

rel-Werte für gd:who

Attribut	Beschreibung
http://schemas.google.com/g/2005#message.bcc	BCC-Empfänger der Nachricht.
http://schemas.google.com/g/2005#message.cc	CC-Empfänger der Nachricht.
http://schemas.google.com/g/2005#message.from	Absender der Nachricht (E-Mail oder IM).
http://schemas.google.com/g/2005#message.reply-to	Vorgesehener Empfänger einer Antwortnachricht.
http://schemas.google.com/g/2005#message.to	Primärer Empfänger der Nachricht.

Beispiel

E-Mail-Nachricht:

<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>[e-mail]</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>

Referenz zum Namespace-Element von Google-Daten

Der Rest dieses Dokuments besteht aus Referenzmaterial für die von den Typen verwendeten Elementen.

• Aufzählungen
• gdCommonProperties
• gd:additionalName
• gd:Kommentare
• gd:country
• gd:Gelöscht
• gd:E-Mail
• gd:entryLink
• gd:extendedProperty,
• gd:Familienname
• gd:feedLink
• gd:geoPt
• gd:givenName
• gd:im
• gd:Organisation
• gd:orgAbteilung
• gd:orgJobDescription
• gd:orgName
• gd:orgSymbol
• gd:orgTitel
• gd:originalEvent
• gd:phoneNumber
• gd:Postadresse
• gd:rating
• gd:recurrence
• gd:recurrenceException
• gd:Erinnerung
• gd:structuredPostalAddress
• gd:wann
• gd:wo
• gd:wer

Enums

Einige Erweiterungselemente müssen Properties angeben, deren Werte aus einem Aufzählungssatz stammen. Die allgemeine Form solcher Properties ist:

<gd:propertyName value="propertyValue">

Wenn der Attributwert aus dem Google Data-Namespace stammt, hat er die Form http://schemas.google.com/g/2005#{kind}.{value}. z. B. http://schemas.google.com/g/2005#event.tentative. Wenn der Wertbereich erweiterbar ist, können Werte auch in Form eines URI vorliegen. Das empfohlene Formular für URIs mit erweiterten Werten ist {schema URI}#{value}. Beispiel: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties.

Gemeinsame Properties, die für alle Google-Typen verwendet werden. Wenn anyAttribute und anyElement im Schema vorhanden sind, können alle Google Data-Namespace-Elemente mit gemeinsamen Properties in jedem Namespace weiter erweitert werden. Insbesondere ist es zulässig, gd- und Atom-/RSS-Elemente in anderen gd-Elementen zu verschachteln. Dies sollte mit Bedacht vorgenommen werden und sollte in den meisten Fällen als explizite Eigenschaft des enthaltenen gd-Elementtyps dokumentiert werden.

Attribute

Attribut	Typ	Beschreibung
@xml:base	uri	Standard-XML-Konstrukt zur Beschreibung der Basis verschachtelter relativer URIs.
@xml:lang	text	Sprache verschachtelter Strings.

Schema

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

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

gd:additionalName

Gibt einen zusätzlichen Namen (z. B. für den mittleren Namen) der Person an, z. B. „Susan“

Attribute

Attribut	Typ	Beschreibung
@yomi?	xs:string	Fonetische Darstellung.
text()	xs:string	Der Familienname der Person.

Beispiel

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

Schema

start = additionalName

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

gd:kommentare

Enthält einen Kommentarfeed für den umschließenden Eintrag, z. B. einen Kalendertermin.

Attribute

Attribut	Typ	Beschreibung
@rel?	xs:string	Art der darin enthaltenen Kommentare. Derzeit wird zwischen regulären Kommentaren und Rezensionen unterschieden.
gd:feedLink?	feedLink	Kommentarfeed. Dieser Feed sollte die Art Message implementieren.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#regular oder nicht angegeben	Regelmäßige Kommentare von Nutzern.
http://schemas.google.com/g/2005#reviews	Professionelle Rezensionen

Beispiele

Kommentarfeed:

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

Rezensionsfeed:

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

Schema

start = comments

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

gd:gelöscht

Ein Markierungselement, das angibt, dass der enthaltene Eintrag gelöscht wurde, falls vorhanden.

Attribute

Keine.

Schema

start = deleted

deleted =
   element gd:deleted

gd:country

Ländername zusammen mit optionalem Ländercode. Letzteres wird gemäß ISO 3166-1 alpha-2 angegeben.

Attribute

Attribut	Typ	Beschreibung
@code?	xs:string	Ländercode gemäß ISO 3166-1 alpha-2.
text()	xs:string	Name des Landes.

Beispiele

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

Schema

start = country

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

gd:email

Eine E-Mail-Adresse, die mit der enthaltenden Entität verknüpft ist (normalerweise eine Entität, die eine Person oder einen Standort darstellt).

Attribute

Attribut	Typ	Beschreibung
@address	xs:string	E-Mail-Adresse.
@displayName?	xs:string	Ein Anzeigename der Entität (z.B. eine Person), zu der die E-Mail-Adresse gehört.
@label?	xs:string	Ein einfacher Stringwert, mit dem diese E-Mail-Adresse benannt wird. Auf der Benutzeroberfläche kann ein Label wie „Arbeit“, „Persönlich“ oder „Bevorzugt“ angezeigt werden.
@rel?	xs:string	Ein programmatischer Wert, der den E-Mail-Typ identifiziert. Weitere Informationen finden Sie unten.
@primary?	xs:boolean	Wenn in einer Art von Kontakten mehrere E-Mail-Erweiterungen zu sehen sind, sind die primären Erweiterungen angegeben. Maximal eine E-Mail-Adresse kann als primäre E-Mail-Adresse angegeben werden. Der Standardwert ist "false".

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other	Eine E-Mail-Adresse, die weder privat noch geschäftlich genutzt wird Mit label kann der tatsächliche Typ angegeben werden.
http://schemas.google.com/g/2005#work

Beispiele

<gd:email address="[e-mail]" displayName="Foo Bar" />
<gd:email label="Personal" rel="http://schemas.google.com/g/2005#home" address="[e-mail]" primary="true"/>

Schema

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

Ein logisch verschachtelter Eintrag. Ein <gd:who>-Objekt, das einen Kontakt repräsentiert, kann beispielsweise einen verschachtelten Eintrag aus einem Kontaktfeed haben.

Attribute

Attribut	Typ	Beschreibung
@href?	xs:string	Gibt den URI des Eintrags an. Wenn der verschachtelte Eintrag eingebettet und nicht verknüpft ist, kann dieses Attribut weggelassen werden.
@readOnly?	xs:boolean	Gibt an, ob der enthaltene Eintrag schreibgeschützt ist. Der Standardwert ist "false".
@rel?	xs:string	Gibt die Linkbeziehung an. Ermöglicht dem Dienst, mehrere Arten von Eintragslinks für eine einzelne Entität bereitzustellen. Hat dieselbe Semantik und dieselben zulässigen Werte wie das Attribut rel des Elements <atom:link>.
atom:entry?	atomEntry	Inhalt des Eintrags.

Einschränkungen

• Es muss entweder @href oder <atom:entry> vorhanden sein.
• Wenn atom:entry nicht vorhanden ist, kann der Client den Inhalt aus dem Eingabe-URI in @href abrufen. Wenn atom:entry vorhanden ist, muss der Inhalt mit dem übereinstimmen, der beim Generieren des Eintrags aus @href abgerufen werden würde.
• Wenn ein PUT oder POST ein <gd:entryLink> enthält und das Attribut @href angegeben ist, wird anhand des Werts des Attributs ein Link erstellt. Wenn das Element atom:entry ebenfalls vorhanden ist, wird es ignoriert. Wenn das Attribut @href nicht angegeben ist, wird das atom:entry-Element entweder als eingebetteter Eintrag oder in einem anderen Feed gespeichert und mit diesem verknüpft. Beachten Sie, dass einige Dienste möglicherweise nicht alle diese Optionen unterstützen.

Beispiele

Kontaktdaten innerhalb von <gd:who>:

<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="[e-mail]"/>
      <gd:phoneNumber label="work">[phone]</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

Nur externe Referenz (Lesezugriff):

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

Schema

start = entryLink

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

gd:extendedProperty

Ermöglicht die Speicherung einer begrenzten Anzahl von benutzerdefinierten Daten als Hilfseigenschaft der einschließenden Entität.

Hinweis: Wenn anyForeignElement vorhanden ist, kann der Feed auch beliebige gültige XML-Elemente innerhalb von gd:extendedProperty-Elementen einbetten (sich gegenseitig ausschließend mit value-Attribut).

Attribute

Attribut	Typ	Beschreibung
@name	xs:string	Gibt den Namen der Property als URI an. Erweiterte Property-URIs folgen in der Regel der Konvention {schema}#{local-name}.
@value?	xs:string	Property-Wert.
@realm?	xs:string	Wird von einigen APIs verwendet, um anzugeben, wo die erweiterte Property gilt.

Beispiel

Eine externe Kennung für einen Kalendertermin:

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

Zusätzlicher XML-Code für die Kontakteingabe

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

Schema

start = extendedProperty

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

gd:familieName

Gibt den Familiennamen der Person an, z. B. „Smith“.

Attribute

Attribut	Typ	Beschreibung
@yomi?	xs:string	Phonetische Darstellung.
text()	xs:string	Der Familienname der Person.

Beispiel

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

Schema

start = familyName

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

gd:feedLink

Ein logisch verschachtelter Feed Ein Kalenderfeed kann beispielsweise einen verschachtelten Feed enthalten, der alle Kommentare zu Einträgen darstellt.

Attribute

Attribut	Typ	Beschreibung
@countHint?	xs:unsignedInt	Hinweise auf die Anzahl der Einträge im Feed. Je nach Implementierung ist dieser Wert möglicherweise nicht präzise.
@href?	xs:string	Gibt den Feed-URI an. Wenn der verschachtelte Feed eingebettet und nicht verknüpft ist, kann dieses Attribut weggelassen werden.
@readOnly?	xs:boolean	Gibt an, ob der enthaltene Feed schreibgeschützt ist.
@rel?	xs:string	Gibt die Linkbeziehung an. Ermöglicht dem Dienst, mehrere Arten von Feedlinks für eine einzelne Entität bereitzustellen. Hat dieselbe Semantik und dieselben zulässigen Werte wie das Attribut rel des Elements <atom:link>.
atom:feed?	atomFeed	Inhalt des Feeds.

Einschränkungen

• Es muss entweder @href oder <atom:feed> vorhanden sein.
• Wenn atom:feed nicht vorhanden ist, kann der Client den Inhalt aus dem URI in @href abrufen. Wenn sie vorhanden ist, muss der Inhalt mit dem übereinstimmen, der beim Generieren des Feeds von @href abgerufen werden würde.
• Wenn eine PUT- oder POST-Anfrage eine <gd:feedLink> enthält und das Attribut @href angegeben ist, wird der Wert des Attributs verwendet, um einen Link zu erstellen. Ist das Element <atom:feed> ebenfalls vorhanden, wird es ignoriert. Wenn das Attribut @href nicht angegeben ist, wird das Element <atom:feed> als eingebetteter Feed gespeichert. Beachten Sie, dass einige Dienste möglicherweise nicht alle diese Optionen unterstützen.

Beispiele

Bloggen:

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

Nur externe Referenz:

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

Eingebetteter Feed in einem Atom-Eintrag, der eine Liste darstellt:

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

Schema

start = feedLink

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

gd:geoPt

Ein geografischer Standort (Breitengrad, Längengrad, Höhe)

Veraltet. Dieses Element wurde eingestellt. Verwenden Sie für Geotagging-Daten stattdessen GeoRSS.

Attribute

Attribut	Typ	Beschreibung
@elev?	xs:float	Höhe in Metern. Negative Werte geben die Tiefe unterhalb des Meeresspiegels an.
@label?	xs:string	Ein einfacher Stringwert, mit dem dieser Standort benannt wird. Auf der Benutzeroberfläche kann ein Label wie „Aktuelle Position“ angezeigt werden.
@lat	xs:float	Breitengrad in Grad Positive Werte bedeuten Norden, negative Werte Süden. Der Bereich ist [-90,0, 90,0].
@lon	xs:float	Längengrad in Grad Positive Werte bedeuten Osten, negative Werte Westen. Der Bereich ist [-180,0, 180,0].
@time?	xs:dateTime	Timestamp.

Beispiele

<gd:geoPt lat="40.75" lon="-74.0"/>

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

Schema

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 }?
   }

g:m

Eine Instant Messaging-Adresse, die der enthaltenen Entität zugeordnet ist.

Attribute

Attribut	Typ	Beschreibung
@address	xs:string	IM-Adresse.
@label?	xs:string	Ein einfacher Stringwert, mit dem diese IM-Adresse benannt wird. Auf der Benutzeroberfläche kann ein Label wie „Arbeit“, „Persönlich“ oder „Bevorzugt“ angezeigt werden.
@rel?	xs:string	Ein programmatischer Wert, der den Typ des IM identifiziert. Weitere Informationen finden Sie unten.
@protocol?	xs:string	Identifiziert das IM-Netzwerk. Bei dem Wert kann es sich entweder um einen der unten aufgeführten Standardwerte oder einen URI handeln, der ein proprietäres IM-Netzwerk identifiziert.
@primary?	xs:boolean	Wenn in einer Art von Kontakten mehrere IM-Erweiterungen angezeigt werden, ist die primäre Erweiterung angegeben. Maximal eine IM kann primär sein. Der Standardwert ist "false".

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#netmeeting
http://schemas.google.com/g/2005#other	Eine IM-Adresse, die weder privat noch geschäftlich ist Mit label kann der tatsächliche Typ angegeben werden.
http://schemas.google.com/g/2005#work

Protokollattributwerte

In der folgenden Tabelle sehen Sie einige mögliche Werte für das Attribut „@protokoll“.

Wert	Beschreibung
http://schemas.google.com/g/2005#AIM	AOL Instant Messenger-Protokoll
http://schemas.google.com/g/2005#MSN	MSN Messenger-Protokoll
http://schemas.google.com/g/2005#YAHOO	Yahoo Messenger-Protokoll
http://schemas.google.com/g/2005#SKYPE	Skype-Protokoll
http://schemas.google.com/g/2005#QQ	QQ-Protokoll
http://schemas.google.com/g/2005#GOOGLE_TALK	Google Talk-Protokoll
http://schemas.google.com/g/2005#ICQ	ICQ-Protokoll
http://schemas.google.com/g/2005#JABBER	Jabber-Protokoll

Beispiele

Eine IM-Adresse für MSN Messenger:

<gd:im protocol="http://schemas.google.com/g/2005#MSN" address="[e-mail]" rel="http://schemas.google.com/g/2005#home" primary="true"/>

Eine vom Nutzer bereitgestellte IM-Adresse mit einem nicht spezifizierten Protokoll Eine solche Adresse ist für die Anzeige nützlich, aber in der Praxis schwierig zu handhaben.

<gd:im label="Other" address="[e-mail]"/>

Schema

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

Gibt den angegebenen Namen der Person an, z. B. „Max“.

Attribute

Attribut	Typ	Beschreibung
@yomi?	xs:string	Phonetische Darstellung.
text()	xs:string	Vorname der Person.

Beispiel

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

Schema

start = givenName

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

gd:geld

Gibt einen Geldbetrag in einer bestimmten Währung an.

Attribute

Attribut	Typ	Beschreibung
@amount	xsd:float	Geldbetrag.
@currencyCode	xsd:string	ISO4217-Währungscode.

Beispiel

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

Schema

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

gd:name

Ermöglicht es, den Namen der Person auf strukturierte Weise zu speichern. Besteht aus Vorname, zusätzlicher Name, Familienname, Präfix, Suffix und vollständiger Name

Attribute

Attribut	Typ	Beschreibung
gd:givenName?	givenName	Vorname der Person.
gd:additionalName?	additionalName	Zusätzlicher Name der Person, z. B. zweiter Vorname
gd:familyName?	familyName	Der Familienname der Person.
gd:namePrefix?	namePrefix	Ehrliches Präfix, z. B. „Herr“ oder „Herr“.
gd:nameSuffix?	nameSuffix	Ehrenhaftes Suffix, z. B. „san“ oder „III“.
gd:fullName?	fullName	Unstrukturierte Darstellung des Namens.

Beispiel

Strukturierte Darstellung von Sir Winston Leonard Spencer-Churchill, KG

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

Schema

start = name

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

Einschränkungen

• Die unstrukturierte Komponente des Namens sollte mit der strukturierten Darstellung übereinstimmen.

gd:organisation

Eine Organisation, in der Regel einem Kontakt zugeordnet.

Attribute

Attribut	Typ	Beschreibung
@label?	xs:string	Ein einfacher Stringwert, mit dem diese Organisation benannt wird. Auf den Benutzeroberflächen kann ein Label wie „Arbeit“, „Freiwilliger“, „Professional Society“ usw. angezeigt werden.
gd:orgDepartment?	orgDepartment	Gibt eine Abteilung innerhalb der Organisation an.
gd:orgJobDescription?	orgJobDescription	Beschreibung eines Jobs innerhalb der Organisation.
gd:orgName?	orgName	Der Name der Organisation
gd:orgSymbol?	orgSymbol	Symbol der Organisation.
gd:orgTitle?	orgTitle	Der Titel einer Person innerhalb der Organisation.
@primary?	xs:boolean	Wenn in einer Kontaktart mehrere Organisationserweiterungen angezeigt werden, gibt dies an, welche die primäre Erweiterung ist. Es darf höchstens eine primäre Organisation vorhanden sein. Der Standardwert ist "false".
@rel?	xs:string	Ein programmatischer Wert, der den Typ der Organisation identifiziert. Weitere Informationen finden Sie unten.
gd:where?	where	Ein Ort, der der Organisation zugeordnet ist, z.B. der Bürostandort.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#other	Eine Organisation, die nicht funktioniert. Mit label kann der tatsächliche Typ angegeben werden.
http://schemas.google.com/g/2005#work

Beispiele

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

Schema

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:org-Abteilung

Beschreibt eine Abteilung innerhalb einer Organisation. Muss in einem gd:organization-Element enthalten sein.

Beispiel

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

Schema

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

gd:orgJobBeschreibung

Beschreibt einen Job innerhalb einer Organisation. Muss in einem gd:organization-Element enthalten sein.

Beispiel

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

Schema

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:org-Name

Der Name der Organisation Muss in einem gd:organization-Element enthalten sein.

Attribute

Attribut	Beschreibung
@yomi?	Yomigana (japanisches Lesegerät) für den Namen der Organisation.

Beispiel

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

Schema

start = orgName

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

gd:org-Symbol

Gibt das Symbol einer Organisation an. Muss in einem gd:organization-Element enthalten sein.

Beispiel

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

Schema

start = orgSymbol

orgSymbol = element gd:orgSymbol { xs:string }

gd:orgTitel

Der Titel einer Person innerhalb einer Organisation. Muss in einem gd:organization-Element enthalten sein.

Beispiel

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

Schema

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:originalEreignis

Entspricht der in Abschnitt 4.8.4.4 von RFC 2445 angegebenen Property der Serien-ID. Erscheint bei jedem wiederkehrenden Termin zur Identifizierung des ursprünglichen Termins.

Enthält ein <gd:when>-Element, das die ursprüngliche Startzeit der Instanz angibt, die eine Ausnahme darstellt.

Attribute

Attribut	Typ	Beschreibung
@id	xs:string	Die Ereignis-ID für das ursprüngliche Ereignis.
@href	xs:string	Die Ereignis-Feed-URL für das ursprüngliche Ereignis.

Beispiel

Ursprüngliches Ereignis angeben:

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

Schema

start = originalEvent

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

gd:telefonnummer

Eine Telefonnummer, die der Entität zugeordnet ist, die eine Person oder einen Standort repräsentiert.

Attribute

Attribut	Typ	Beschreibung
@label?	xs:string	Ein einfacher Stringwert, mit dem diese Telefonnummer benannt wird. In den meisten Fällen ist @label nicht erforderlich, da mit @rel eine Nummer eindeutig identifiziert wird und auf der Benutzeroberfläche ein Label wie „Mobil“, „Zuhause“, „Arbeit“ usw. angezeigt wird. Wenn eine Person jedoch (z. B.) mehrere Smartphones hat, kann diese Property zur Unterscheidung herangezogen werden.
@rel?	xs:string	Ein programmatischer Wert, der den Typ der Telefonnummer identifiziert. Weitere Informationen finden Sie unten.
@uri?	xs:string	Ein optionaler „tel URI“ für die formale Darstellung der Nummer, der für den programmatischen Zugriff nützlich ist, z. B. eine VoIP-/PSTN-Brücke. Weitere Informationen zu Tel-URIs finden Sie unter RFC 3966.
@primary?	xs:boolean	Wenn in einer Kontaktart mehrere Telefonnummernerweiterungen angezeigt werden, gibt dies an, welche die Hauptnummer ist. Maximal eine Telefonnummer ist zulässig. Der Standardwert ist "false".
text()	xs:string	Für Menschen lesbare Telefonnummer; in jedem Telefonnummernformat. Voran- und nachgestellte Leerzeichen sind unbedeutend. Zeilenumbrüche innerhalb des Strings sind ebenfalls unbedeutend und können entfernt oder zu einem einzigen Leerzeichen vereinfacht werden.

rel-Werte

Wert	Beschreibung
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	Eine besondere Art von Zahl, für die kein anderer rel-Wert Sinn ergibt. Mit label kann der tatsächliche Typ angegeben werden.
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

Beispiele

Einfache Telefonnummer, die von einem Nutzer eingegeben wurde:

<gd:phoneNumber>[phone] ext. 72585</gd:phoneNumber>

Gleiche Telefonnummer aus einem Verzeichnis:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#work" uri="tel:[phone];ext=52585">
  [phone] ext. 52585
</gd:phoneNumber>

Zahl mit einem Label:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:[phone]">
  [phone]
</gd:phoneNumber>

Schema

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

Eine Postadresse.

Attribute

Attribut	Typ	Beschreibung
@label?	xs:string	Ein einfacher Stringwert, mit dem diese Adresse benannt wird.
@rel?	xs:string	Ein programmatischer Wert, der den Typ der Postanschrift angibt. Weitere Informationen finden Sie unten.
@primary?	xs:boolean	Wenn in einer Kontaktart mehrere Postanschriften angezeigt werden, gibt dies an, welche die primäre Erweiterung ist. Maximal eine Postanschrift ist zulässig. Der Standardwert ist "false".
text()	xs:string	Die Adresse als Text. Voran- und nachgestellte Leerzeichen sind unbedeutend. Zeilenumbrüche innerhalb des Strings sind signifikant.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other	Eine Adresse, die weder Privat- noch Arbeitsadresse ist. Mit label kann der tatsächliche Typ angegeben werden.
http://schemas.google.com/g/2005#work

Beispiele

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

Schema

start = postalAddress

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

gd:rating

Stellt eine numerische Bewertung der einschließenden Entität dar, z. B. einen Kommentar. Für jede Bewertung wird eine eigene Skala verwendet, die jedoch von einem Dienst normalisiert werden kann. Manche Dienste wandeln beispielsweise alle Bewertungen in eine Skala von 1 bis 5 um.

Attribute

Attribut	Typ	Beschreibung
@average?	xs:float	Durchschnittliche Bewertung.
@max	xs:int	Der Höchstwert der Bewertungsskala.
@min	xs:int	Der Mindestwert der Bewertungsskala.
@numRaters?	xs:int	Anzahl der Bewertungen, die bei der Berechnung des Durchschnittswerts berücksichtigt werden
@rel?	xs:string	Gibt den bewerteten Aspekt an. Wenn nicht angegeben, ist die Bewertung eine Gesamtbewertung.
@value?	xs:int	Bewertung.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#overall oder nicht angegeben	Gesamtbewertung. Höhere Werte bedeuten bessere Bewertungen.
http://schemas.google.com/g/2005#price	Preisbewertung. Höhere Werte bedeuten höhere Preise.
http://schemas.google.com/g/2005#quality	Qualitätsbewertung. Höhere Werte bedeuten bessere Qualität.

Beispiele

4/5 der Gesamtbewertung:

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

Höchste Bewertung für die Preisspanne:

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

Von 200 Nutzern mit einer durchschnittlichen Bewertung von 4,65 von 5 bewertet:

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

Schema

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

Die Daten und Uhrzeiten für einen wiederkehrenden Termin.

Die Zeichenfolge, die die Wiederholung definiert, besteht aus einer Reihe von Eigenschaften, von denen jede im iCalendar-Standard (RFC 2445) definiert ist.

Insbesondere beginnt der String normalerweise mit einer DTSTART-Eigenschaft, die die Startzeit der ersten Instanz des Ereignisses angibt, und oft einer DTEND-Eigenschaft oder einer DURATION-Eigenschaft, die angibt, wann die erste Instanz endet. Als nächstes kommen die Properties RRULE, RDATE, EXRULE und/oder EXDATE, die einen wiederkehrenden Termin und seine Ausnahmen zusammenfassen (siehe unten). Weitere Informationen zu den Eigenschaften dieser Wiederholungskomponente findest du in Abschnitt 4.8.5 von RFC 2445. Die letzte Funktion von VGMT enthält detaillierte Zeitzonenregeln für jede Zeitzonen-ID, die in den vorherigen Properties erwähnt wurde.

In Google-Diensten wie Google Kalender werden in der Regel keine EXRULE- und EXDATE-Eigenschaften generiert, um Ausnahmen von wiederkehrenden Terminen darzustellen. Stattdessen werden <gd:recurrenceException>-Elemente generiert. Google-Dienste können jedoch EXRULE- und/oder EXDATE-Eigenschaften enthalten. Nutzer können beispielsweise Termine und Ausnahmen in Google Kalender importieren. Wenn diese importierten Termine EXRULE- oder EXDATE-Eigenschaften enthalten, werden diese Eigenschaften von Google Kalender bereitgestellt, wenn das Element <gd:recurrence> gesendet wird.

Die Verwendung von <gd:recurrenceException> bedeutet, dass du dir bei der Prüfung eines <gd:recurrence>-Elements nicht sicher sein kannst, ob es bei der Serienbeschreibung Ausnahmen gibt. Suchen Sie im Feed nach <gd:recurrenceException>-Elementen und ordnen Sie deren <gd:originalEvent>-Elemente mit <gd:recurrence>-Elementen zu, damit alle Ausnahmen gefunden werden.

Attribute

Attribut	Typ	Beschreibung
text()	xs:string	Wiederholungsbeschreibung.

Beispiel

Ein wiederkehrender Termin, der jeden Morgen von 6:00 bis 7:00 Uhr, Pacific Time, 14. bis 21. März 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>

Schema

start = recurrence

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

gd:recurrenceException

Ein Termin, der eine Ausnahme von einem wiederkehrenden Termin darstellt, also eine Instanz eines wiederkehrenden Termins, bei der einer oder mehrere Aspekte des wiederkehrenden Termins geändert wurden (z. B. Teilnahmeliste, Zeit oder Ort)

Enthält ein <gd:originalEvent>-Element, das das ursprüngliche wiederkehrende Ereignis angibt, von dem dieses Ereignis eine Ausnahme ist.

Wenn Sie eine Instanz eines wiederkehrenden Termins ändern, wird diese zu einer Ausnahme. Je nachdem, welche Änderung Sie vorgenommen haben, verhält sich die Ausnahme auf zwei verschiedene Arten, wenn der ursprüngliche wiederkehrende Termin geändert wird:

• Wenn Sie Kommentare, Teilnehmer oder Teilnehmerantworten hinzufügen, ändern oder entfernen, bleibt die Ausnahme mit dem ursprünglichen Termin verknüpft und durch Änderungen am ursprünglichen Termin ändert sich auch die Ausnahme.
• Wenn Sie weitere Änderungen an der Ausnahme vornehmen (z. B. die Zeit oder den Standort ändern), wird die Instanz auf „Spezialisierung“ umgestellt. Das bedeutet, dass sie nicht mehr so eng mit dem ursprünglichen Termin verbunden ist. Spezielle Ausnahmen ändern sich nicht, wenn Sie das ursprüngliche Ereignis ändern. Siehe unten.

Beispiel: Sie haben jeden Dienstag und Donnerstag um 14:00 Uhr eine Besprechung. Wenn Sie die Teilnahmeliste für die Besprechung am Donnerstag ändern (jedoch nicht für die regelmäßig geplante Besprechung), wird daraus eine Ausnahme. Wenn Sie die Uhrzeit für die Besprechung am Donnerstag (jedoch nicht für die regelmäßig geplante Besprechung) ändern, wird sie speziell.

Eine Ausnahme wird unabhängig davon, ob eine Ausnahme spezialisiert ist oder nicht, wenn Sie etwas tun, das die Instanz löscht, von der die Ausnahme abgeleitet wurde. Wenn Sie den Tag oder die Uhrzeit eines wiederkehrenden Termins ändern, werden alle Instanzen gelöscht und neue erstellt.

Wenn Sie sich zum Beispiel auf die Besprechung am Donnerstag spezialisiert haben, können Sie die wiederkehrende Besprechung so ändern, dass sie am Montag, Mittwoch und Freitag stattfindet. Durch diese Änderung werden alle wiederkehrenden Termine für die Besprechung am Dienstag/Donnerstag gelöscht, einschließlich der speziellen.

Wenn eine bestimmte Instanz eines wiederkehrenden Termins gelöscht wird, wird sie als <gd:recurrenceException> mit einer <gd:entryLink> angezeigt, deren <gd:eventStatus> auf "http://schemas.google.com/g/2005#event.canceled" gesetzt ist. Weitere Informationen zu abgesagten Ereignissen finden Sie unter RFC 2445.

Attribute

Attribut	Typ	Beschreibung
@specialized	xs:boolean	Gibt an, ob die Ausnahme spezifisch ist oder nicht.
gd:entryLink	entryLink	Einen Ereigniseintrag mit Details zur Ausnahme.
gd:originalEvent	originalEvent	Der ursprüngliche wiederkehrende Termin, von dem es sich um eine Ausnahme handelt.

Beispiel

Eine Ausnahme von einem wiederkehrenden Termin (wobei einige Teile zur Verdeutlichung durch kurze, kursiv dargestellte Kennungen ersetzt werden):

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

Schema

start = recurrenceException

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

gd:erinnerung

Am häufigsten verwendet in: <gd:when>

Ein Zeitintervall, das angibt, wie lange vor dem Attribut @startTime oder @dueTime der enthaltenen Entität eine Erinnerung ausgegeben werden soll. Es kann auch ein absoluter Zeitpunkt angegeben werden, zu dem eine Erinnerung ausgegeben werden soll. Gibt auch eine Benachrichtigungsmethode an, die angibt, welches Medium das System zur Erinnerung des Nutzers verwenden soll.

Attribute

Attribut	Typ	Beschreibung
@absoluteTime?	xs:dateTime	Die absolute Zeit, zu der die Erinnerung ausgegeben werden soll. Diese Option wird normalerweise verwendet, wenn ein Nutzer eine Funktion zum Zurückstellen einer vorherigen Erinnerung verwendet. Wenn keine Zeitzone angegeben ist, wird die Ortszeit des Beobachters angenommen.
@method?	xs:string	Die Benachrichtigungsmethode, die die Erinnerung verwenden soll. Kann einen der folgenden Werte haben: alert (veranlasst eine Benachrichtigung, wenn ein Nutzer den Kalender in einem Browser aufruft), email (erhält eine E-Mail-Nachricht) oder sms (eine SMS-Nachricht).
@days?	xs:unsignedInt	Zeitraum vor dem gd:when/@startTime, zu dem eine Erinnerung erstellt werden sollte. Wenn die Zielzeit der übergeordneten Entität ein Datum und nicht eine bestimmte Uhrzeit ist, beziehen sich diese Attribute auf den angegebenen Zeitpunkt um Mitternacht (00:00).
@hours?	xs:unsignedInt
@minutes?	xs:unsignedInt

Beachten Sie beim Erstellen oder Bearbeiten eines <gd:when>-Eintrags die folgenden Konventionen, um bestimmte Ergebnisse zu erzielen:

• Wenn Sie dem Dienst mitteilen möchten, die Standarderinnerungen des Nutzers zu verwenden, fügen Sie das Element <gd:reminder> ohne Attribute ein. Wenn Sie eine Dauer, aber kein method-Attribut angeben, verwendet der Dienst die standardmäßigen Benachrichtigungsmethoden des Nutzers mit der von Ihnen angegebenen Dauer.
• Wenn der Dienst keine Erinnerungen für den Termin erstellen oder beim Aktualisieren eines Termins vorhandene Erinnerungen entfernen soll, nehmen Sie keine <gd:reminder>-Elemente auf.

Einschränkungen

• Es können höchstens @days, @hours, @minutes oder @absoluteTime angegeben werden. Wenn Sie eine gemischte Dauer angeben möchten, konvertieren Sie die Einheit in die genaueste Einheit. Wenn Sie beispielsweise 1 Stunde und 30 Minuten angeben möchten, verwenden Sie @minutes="90".
• Sie können keine negativen Werte für die Attribute verwenden. Wenn Sie also nach der Startzeit eine Erinnerung erhalten möchten, müssen Sie @absoluteTime verwenden.
• Mit einem Termin können maximal fünf Erinnerungen verknüpft sein.
• Wenn Sie einem Termin eine Erinnerung hinzufügen, müssen Sie auch die Dauer alert, email oder sms angeben.

Beispiele

15-minütige Erinnerung für eine Besprechung:

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

Dieselbe Besprechung wie oben, aber nach 16:45 Uhr 10 Minuten lang pausiert:

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

Schema

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:ressourcen-ID

Eine intransparente Ressourcenkennung, die sich von atom:id unterscheidet, da es sich nicht um einen gültigen URI handeln muss. Einige Dienste stellen eine separate Kennung bereit, die beim Erstellen nachfolgender Anfragen verwendet werden kann. Die genaue Nutzung ist dienstspezifisch.

Beispiel

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

Schema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:structuredAddressAddress

Postanschrift in Komponenten aufgeteilt. Damit kann die Adresse in einem anderen Gebietsschema gespeichert werden. Die Felder können interpretiert und zum Generieren einer formatierten, gebietsabhängigen Adresse verwendet werden. Die folgenden Elemente enthalten Adressenteile: Kundenservicemitarbeiter, Hausname, Straße, Postfach, Stadtteil, Stadt, Unterregion, Region, Postleitzahl, Land. Das Element subregion wird nicht für Postanschriften verwendet, sondern nur für die erweiterte Verwendung von Adressen. Wenn Sie eine Postanschrift in einem unstrukturierten Formular speichern möchten, geben Sie eine Adresse an.

Attribute

Attribut	Typ	Beschreibung
@rel?	xs:string	Typ der Adresse. Sofern nicht anders angegeben, wird der Typ work angenommen.
@mailClass?	xs:string	An die Adresse akzeptierte E-Mail-Klassen. Sofern nicht anders angegeben, wird both angenommen.
@usage?	xs:string	Der Kontext, in dem diese Hinzufügung verwendet werden kann. Lokale Adressen können sich im Layout von allgemeinen Adressen unterscheiden und verwenden häufig das lokale Skript (im Gegensatz zum lateinischen Schriftsystem), obwohl das lokale Skript in allgemeinen Adressen zulässig ist. Sofern nicht anders angegeben, wird die general-Nutzung angenommen.
@label?	xs:string	Ein allgemeines Label für die Adresse.
@primary?	xs:boolean	Gibt die Adresse als primär an. Der Standardwert ist false.
gd:agent?	agent	Der Agent, der die E-Mails tatsächlich erhält. Wird in Arbeitsadressen verwendet. Auch für „in Pflege“ oder „c/o“.
gd:housename?	housename	Wird an Orten verwendet, an denen Häuser oder Gebäude Namen haben (und nicht unbedingt Nummern), z. B. „Die Säulen“.
gd:street?	street	Kann eine Straße, eine Straße, eine Straße usw. sein. Dieses Element enthält auch die Hausnummer und die Zimmer-/Wohnungs-/Wohnungs-/Etagennummer.
gd:pobox?	pobox	Deckt Postfächer, Schubladen, verschlossene Taschen usw. ab. Dies schließt in der Regel, aber nicht immer, auch die Straße aus.
gd:neighborhood?	neighborhood	Wird verwendet, um eine Adresse eindeutig zu machen, wenn eine Stadt mehrere Straßen mit demselben Namen enthält, oder um einen kleinen Ort anzugeben, dessen E-Mails über einen größeren Ort geleitet werden. In China kann es sich um einen Landkreis oder eine kleinere Stadt handeln.
gd:city?	city	Kann eine Stadt, ein Dorf oder ein Stadtteil sein. Hierbei handelt es sich um den Postort und nicht zwangsläufig um den Wohnsitz oder den Geschäftssitz.
gd:subregion?	subregion	Verwaltet Verwaltungsbezirke wie die Countys der USA oder des Vereinigten Königreichs, die nicht für die Adressierung von Postdiensten verwendet werden Die Unterregion ist nicht für Lieferadressen vorgesehen.
gd:region?	region	Ein Bundesland, eine Provinz, ein Landkreis (in Irland), ein Land (in Deutschland), ein Departement (in Frankreich) usw.
gd:postcode?	postcode	Postleitzahl. Normalerweise landesweit, aber manchmal speziell für die Stadt (z.B. „2“ in „Dublin 2, Irland“).
gd:country?	country	Der Name oder Code des Landes.
gd:formattedAddress?	formattedAddress	Die vollständige, unstrukturierte Postanschrift.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#work	Arbeitsadresse. Sofern nicht anders angegeben, ist dies der Standardwert.
http://schemas.google.com/g/2005#home	Privatadresse.
http://schemas.google.com/g/2005#other	Sonstige Adressen

mailClass-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#both	Pakete und Briefe können an die Adresse gesendet werden. Sofern nicht anders angegeben, ist dies der Standardwert.
http://schemas.google.com/g/2005#letters	An die Adresse dürfen nur Buchstaben gesendet werden.
http://schemas.google.com/g/2005#parcels	An die Adresse dürfen nur Pakete gesendet werden.
http://schemas.google.com/g/2005#neither	Die Adresse ist rein standortbezogen und kann nicht für E-Mails verwendet werden.

Nutzungswerte

Wert	Beschreibung
http://schemas.google.com/g/2005#general	Diese Adresse ist für die allgemeine Nutzung vorgesehen. Sofern nicht anders angegeben, ist dies der Standardwert.
http://schemas.google.com/g/2005#local	Diese Adresse ist für die lokale Nutzung vorgesehen.

Beispiele

Adresse des Unternehmens:

mr. John Doe

Google Inc.

1600 Amphitheatre Parkway

Mountain View, CA 94043, USA

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

Privatadresse:

Madame Duval

27, rue Pasteur

14390 CABOURG

FRANKREICH

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

Schema

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? )
}

Einschränkungen

• Es ist nicht zulässig, sowohl "gd:postalAddress" als auch "gd:structuredPostalAddress" in einer Entität zu haben.
• Es kann nur eine strukturierte Adresse als primäre Adresse angegeben werden.
• Die unstrukturierte Postanschrift muss mit den strukturierten Daten übereinstimmen.

gd:wann

Ein Zeitraum oder ein Instant.

Attribute

Attribut	Typ	Beschreibung
@endTime?	xs:dateTime oder xs:date	Beschreibt, wann das Ereignis endet. Wenn keine Zeitzone angegeben ist, wird die lokale Zeitzone des Beobachters angenommen.
@startTime	xs:dateTime oder xs:date	Beschreibt, wann das Ereignis beginnt bzw. (bei Null-Sekunden-Ereignissen), wenn es auftritt. Wenn keine Zeitzone angegeben ist, wird die lokale Zeitzone des Beobachters angenommen.
@valueString?	xs:string	Ein einfacher Stringwert, der diesen Zeitraum repräsentieren kann.

Einschränkungen

• In startTime/endTime ist es nicht möglich, xs:dateTime mit xs:date zu mischen.
• Wenn endTime nicht angegeben ist, wird der Termin als sofortiger Zeitpunkt (wenn @startTime eine Uhrzeit enthält) oder als eintägiger Termin betrachtet (wenn @startTime nur ein Datum ist).

Beispiele

Eintägiger Termin:

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

Alternative Darstellung eines eintägigen Termins:

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

Ein zweitägiges Ereignis (am 6. und 7. Juni) mit einer Stringbeschreibung:

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

Einstündige Besprechung:

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

Ein Ereignis von null Dauer:

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

Schema

start = when

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

gd:wo

Ein Ort (z. B. ein Veranstaltungsort), der der enthaltenen Entität zugeordnet ist. Die Art der Verknüpfung wird durch das Attribut rel bestimmt. Die Details des Standorts sind in einem eingebetteten oder mit dem Kontakt verknüpften Eintrag enthalten.

Ein <gd:where>-Element ist allgemeiner als ein <gd:geoPt>-Element. Ersterer identifiziert einen Ort anhand einer Textbeschreibung und/oder einem Kontakteintrag, während Letzterer einen Ort anhand eines bestimmten geografischen Standorts identifiziert.

Attribute

Attribut	Typ	Beschreibung
@label?	xs:string	Gibt ein für Nutzer lesbares Label an, um diesen Standort von anderen zu unterscheiden.
@rel?	xs:string	Gibt die Beziehung zwischen der enthaltenen Entität und dem enthaltenen Standort an. Mögliche Werte (siehe unten) werden durch andere Elemente definiert. Beispiel: <gd:when> definiert http://schemas.google.com/g/2005#event.
@valueString?	xs:string	Ein einfacher Stringwert, der diesen Standort repräsentieren kann.
gd:entryLink?	entryLink	Eintrag, der Standortdetails darstellt. Dieser Eintrag sollte die Art Contact implementieren.

rel-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#event oder nicht angegeben	Ort, an dem das einschließende Ereignis stattfindet.
http://schemas.google.com/g/2005#event.alternate	Ein sekundärer Standort. Das kann beispielsweise eine Remote-Website mit einem Link zur Videokonferenz sein.
http://schemas.google.com/g/2005#event.parking	Ein nahe gelegener Parkplatz.

Beispiele

Veranstaltungsort:

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

Komplexerer Veranstaltungsort:

<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>[phone]</gd:phoneNumber>
      <gd:email address="[e-mail]"/>
    </gd:entry>
  </gd:entryLink>
</gd:where>

Veranstaltung mit mehreren Standorten:

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

Schema

start = where

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

gd:wer

Eine Person, die der enthaltenen Entität zugeordnet ist. Die Art der Verknüpfung wird durch das Attribut rel bestimmt. Die Details zur Person sind in einem eingebetteten oder mit einem Kontakt verknüpften Eintrag enthalten.

Mit dem Element <gd:who> können E-Mail-Absender und -Empfänger, Organisatoren von Kalenderterminen usw. angegeben werden.

Attribute

Attribut	Typ	Beschreibung
@email?	xs:string	E-Mail-Adresse. Diese Eigenschaft wird normalerweise verwendet, wenn <gd:entryLink> nicht angegeben ist. Die Adresse muss RFC 2822, Abschnitt 3.4.1, erfüllen.
@rel?	xs:string	Gibt die Beziehung zwischen der enthaltenen Entität und der enthaltenen Person an. Mögliche Werte finden Sie unten.
@valueString?	xs:string	Ein einfacher Stringwert, der als Darstellung dieser Person verwendet werden kann.
gd:attendeeStatus?	gEnumConstruct	Status des Terminteilnehmers. Erweiterbare Aufzählung unten.
gd:attendeeType?	gEnumConstruct	Art des Terminteilnehmers. Erweiterbare Aufzählung unten.
gd:entryLink?	entryLink	Eintrag für die Person. Dieser Eintrag sollte die Art Contact implementieren. In vielen Fällen stammt dieser Eintrag aus einem Kontaktfeed.

rel-Werte

Die gültigen Werte für @rel hängen davon ab, in welcher Art das Element <gd:who> erscheint.

Wert	Art	Beschreibung
http://schemas.google.com/g/2005#event.attendee	Ereignis	Ein allgemeiner Besprechungs-/Veranstaltungsteilnehmer.
http://schemas.google.com/g/2005#event.organizer	Ereignis	Organisator der Veranstaltung. Ein Organisator ist nicht unbedingt ein Teilnehmer.
http://schemas.google.com/g/2005#event.performer	Ereignis	Künstler. Ähnlich wie http://schemas.google.com/g/2005#event.speaker, aber mit mehr Schwerpunkt auf Kunst als mit Spracherkennung.
http://schemas.google.com/g/2005#event.speaker	Ereignis	Lautsprecher.
http://schemas.google.com/g/2005#message.bcc	Botschaft	BCC-Empfänger der Nachricht.
http://schemas.google.com/g/2005#message.cc	Botschaft	CC-Empfänger der Nachricht.
http://schemas.google.com/g/2005#message.from	Botschaft	Absender der Nachricht (E-Mail oder IM).
http://schemas.google.com/g/2005#message.reply-to	Botschaft	Vorgesehener Empfänger einer Antwortnachricht.
http://schemas.google.com/g/2005#message.to	Botschaft	Primärer Empfänger der Nachricht.

gd:attendeeType Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#event.optional	Optionaler Teilnehmer.
http://schemas.google.com/g/2005#event.required	Erforderlicher Teilnehmer.

gd:attendeeStatus-Werte

Wert	Beschreibung
http://schemas.google.com/g/2005#event.accepted	Der Teilnehmer hat zugestimmt.
http://schemas.google.com/g/2005#event.declined	Der Teilnehmer hat abgelehnt.
http://schemas.google.com/g/2005#event.invited	Die Einladung wurde gesendet, aber die Person hat die Einladung nicht angenommen.
http://schemas.google.com/g/2005#event.tentative	Der Teilnehmer hat vorläufig akzeptiert.

Beispiele

E-Mail-Empfänger:

<gd:who rel="http://schemas.google.com/g/2005#message.from" email="[e-mail]"/>
<gd:who rel="http://schemas.google.com/g/2005#message.to" valueString="Elizabeth" email="[e-mail]"/>

Besprechungsteilnehmer:

<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="[e-mail]"/>
      <gd:phoneNumber label="work">[phone]</gd:phoneNumber>
    </entry>
  </gd:entryLink>
</gd:who>

Organisator des Termins:

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

Schema

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 }?)
   }

Nach oben

Änderungen seit Version 1.0

Änderungen an der Kontaktart

Die folgenden Elemente, die in Version 1.0 nicht vorhanden sind, wurden in Version 2.0 der Art des Kontakts hinzugefügt:

• gd:name
• gd:structuredPostalAddress
• gd:where

Die folgenden Telefontypen, die in Version 1.0 nicht vorhanden waren, wurden in Version 2.0 hinzugefügt:

• 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

Der folgende IM-Typ, der in Version 1.0 nicht vorhanden ist, wurde in Version 2.0 hinzugefügt:

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

Die folgenden Elemente der Kontaktart 1.0 werden nicht mehr unterstützt:

• atom:title: ist immer noch in Einträgen vorhanden, die vom Server zurückgegeben, aber bei PUT- und POST-Anfragen ignoriert werden. Ersetzt durch gd:name.
• gd:postalAddress – ersetzt durch gd:structuredPostalAddress.

Änderungen an gd:email

Das neue Attribut „@displayName“ wurde in „gd:email“ in Version 2.0 hinzugefügt

Änderungen an gd:organization

Die folgenden Unterelemente von gd:organization wurden in 2.0 eingeführt:

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

Änderungen an gd:orgName

In Version 2.0 wurde das Element gd:orgName durch Hinzufügen des Attributs @yomi optimiert.

Nach oben