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.

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