Diese Seite wurde von der Cloud Translation API übersetzt.

Gängige Elemente: „Kinds“

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

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
`gd:email`*	E-Mail-Adressen.
`gd:im`*	IM-Adressen.
`gd:phoneNumber`*	Telefon- und Faxnummern.
`gd:postalAddress`*	Postanschriften.
`gd:organization`*	Organisation.
`gd:extendedProperty`*	Erweiterte Property.
`gContact:groupMembershipInfo`*	Informationen zur Gruppenmitgliedschaft.
`gd:deleted`*	Status des Kontakteintrags gelöscht.

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

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

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

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

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:Kommentare
gd:Gelöscht
gd:E-Mail
gd:entryLink
gd:extendedProperty,
gd:feedLink
gd:geoPt
gd:im
gd:Organisation
gd:orgName
gd:orgTitel
gd:originalEvent
gd:phoneNumber
gd:Postadresse
gd:rating
gd:recurrence
gd:recurrenceException
gd:Erinnerung
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:kommentare

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

Attribute

Attribut	Typ	Beschreibung
`@rel`?	`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: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.
`@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="foo@bar.example.com"/>
<gd:email label="Personal" rel="http://schemas.google.com/g/2005#home" address="fubar@gmail.com" primary="true"/>

Schema

start = email

email =
   element gd:email {
      attribute address { 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="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</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 {scheme}#{local-name}.
`@value`?	`xs:string`	Property-Wert.

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

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#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="foo@bar.msn.com" 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="foo@baz.example.com"/>

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: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.
`@rel`?	`xs:string`	Ein programmatischer Wert, der den Typ der Organisation identifiziert.
`@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"`.
`gd:orgName`?	`orgName`	Der Name der Organisation
`gd:orgTitle`?	`orgTitle`	Der Titel einer Person innerhalb der Organisation.

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

Schema

start = organzation

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

gd:org-Name

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

Beispiel

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

Schema

start = orgName

orgName =
   element gd:orgName { 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#fax`
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#home_fax`
`http://schemas.google.com/g/2005#mobile`
`http://schemas.google.com/g/2005#other`	Eine besondere Art von Zahl, für die kein anderer `rel`-Wert Sinn ergibt. z. B. ein TTY-Gerät Mit `label` kann der tatsächliche Typ angegeben werden.
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`

Beispiele

Einfache Telefonnummer, die von einem Nutzer eingegeben wurde:

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

Gleiche Telefonnummer aus einem Verzeichnis:

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

Zahl mit einem Label:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212">
  +1 206 555 1212
</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: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>(212) 555-1212</gd:phoneNumber>
      <gd:email address="info@joespub.com"/>
    </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="jo@example.com"/>
<gd:who rel="http://schemas.google.com/g/2005#message.to" valueString="Elizabeth" email="liz@example.com"/>

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="jo@example.com"/>
      <gd:phoneNumber label="work">(650) 555-1212</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 { xsd:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

Nach oben