Introducción

A menudo, es útil para los servicios que usan las API de datos de Google poder proporcionar un conjunto coherente de información acerca de un tipo particular de elemento.

Por ejemplo, varios servicios de Google Data API (o “GData”) pueden proporcionar información de contacto para una persona u organización; tiene sentido que todos esos servicios utilicen el mismo conjunto de elementos de información de contacto.

La colección de elementos que, en conjunto, describen a un contacto se denomina "tipo" de contacto. Algunos de los elementos en la categoría Contact son elementos atómicos o RSS comunes; Google define otros en un espacio de nombres llamado "Espacio de nombres de datos de Google". Por convención, generalmente se hace referencia al espacio de nombres de datos de Google en código XML usando el alias gd:; por ejemplo, el elemento que contiene un número de teléfono o de fax es <gd:phoneNumber>. La URL del esquema del espacio de nombres de datos de Google es http://schemas.google.com/g/2005.

Google también define otros tipos: Evento (una colección de elementos estandarizados que representan un evento de calendario) y Mensaje (una colección de elementos que representan un mensaje de correo electrónico, una publicación de grupo de discusión o algún otro mensaje).

Existen varios tipos de espacios de nombres de datos de Google que se usan en varios tipos. Por ejemplo, el elemento <gd:who> asocia una persona (que se describe en <gd:who>) con la entrada que contiene el elemento <gd:who>. Este elemento se usa en la categoría Evento para especificar los organizadores, los asistentes, etc. También se usa en el tipo de mensaje para especificar los remitentes y destinatarios.

Cuando una entrada en un feed de la API de datos de Google usa una categoría determinada, contiene un elemento <atom:category> con su atributo scheme establecido en "http://schemas.google.com/g/2005#kind" y su atributo term establecido en el nombre de la URL del esquema seguido del nombre de la categoría. Por ejemplo, una entrada de Contacto incluye el siguiente elemento:

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

Esto permite que los clientes determinen con rapidez y facilidad qué tipo de datos contiene la entrada, es decir, para determinar la semántica de la entrada. (si lo prefieres, puedes usar RSS en lugar de Atom; consulta el documento de referencia del protocolo para obtener los elementos RSS correspondientes a los elementos Atom).

Este documento es una referencia para algunos tipos comunes y los elementos que contienen.

Elementos sin documentar

No incluimos información sobre los elementos estándar de <atom:entry> en tipos que tienen su significado estándar. Por ejemplo, <atom:id>, <atom:published> y <atom:updated> tienen su significado estándar cuando aparecen en categorías.

Tampoco incluimos información sobre elementos Atom estándar que no tengan sentido en el contexto dado. Por ejemplo, no se usa <atom:summary> en el tipo de contacto, y aunque <atom:author> es un elemento obligatorio en una entrada (a menos que se especifique en el feed superior), no tiene un significado útil en el tipo de contacto.

Crea tipos

Puede ser difícil determinar exactamente qué información debes incluir cuando creas una entrada de un tipo en particular, en especial porque algunos elementos de los tipos contienen otros.

Un enfoque que podría ayudar es usar las bibliotecas cliente que proporcionamos, en lugar de intentar crear tipos a mano. Las bibliotecas cliente proporcionan varios métodos para agregar y cambiar datos en una entrada de un tipo determinado. Consulta la documentación de la biblioteca cliente para obtener más detalles.

Extensibilidad

La información de este documento no abarca todas las propiedades y los valores de atributos posibles para las categorías. Los servicios pueden extender tipos, por lo que un servicio en particular puede usar propiedades y valores no incluidos en este documento.

Convenciones tipográficas

En las tablas de este documento, usamos las siguientes convenciones para los elementos obligatorios y opcionales:

elementoName	Elemento obligatorio
elementoName?	Elemento opcional
elementoName*	Elemento opcional, se permiten varias instancias

Los elementos y los atributos se presentan en notación XPath estándar.

Tipo de contacto

Representa a un contacto: una persona, un lugar, como un club, un restaurante o una organización.

Elemento de categoría: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>

Propiedades

Propiedad	Descripción
atom:category*	Categorías. Las instancias con el atributo @label se tratan como etiquetas. Para obtener información sobre el uso del atributo @scheme, consulta la nota al comienzo de esta sección.
atom:content	Notas sobre el contacto.
atom:link*	Vínculos a información relacionada Específicamente, atom:link[@rel='alternate'] establece un vínculo a una página HTML que describe el contacto.
atom:title	Nombre del contacto
gd:email*	Direcciones de correo electrónico.
gd:im*	direcciones IM.
gd:phoneNumber*	Números de teléfono y fax
gd:postalAddress*	Direcciones postales
gd:organization*	Organización
gd:extendedProperty*	Propiedad extendida.
gContact:groupMembershipInfo*	Información sobre la pertenencia a grupos
gd:deleted*	Se borró el estado de la entrada de contacto.

Ejemplos

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

Tipo de evento

Representa un evento de calendario. La ubicación del evento está representada por un tipo de Contacto incorporado en un elemento <gd:where> (o vinculado desde él); los planificadores de eventos y los asistentes se representan como tipos de Contacto incorporados en los elementos <gd:who> o integrados desde el mismo.

Elemento de categoría: <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>

Propiedades

Propiedad	Descripción
atom:author	Persona que creó este evento.
atom:category*	Categorías. Las instancias con el atributo @label se tratan como etiquetas. Para obtener información sobre el uso del atributo @scheme, consulta la nota al comienzo de esta sección.
atom:content	Descripción más larga del evento.
atom:link*	Vínculos: Específicamente, atom:link[@rel='alternate'] proporciona un vínculo a una página HTML que describe el evento.
atom:title	Título breve del evento.
¿gd:comments?	Feed de comentarios
¿gd:eventStatus?	La enumeración extensible se documenta a continuación.
¿gd:recurrence?	Regla de recurrencia.
¿gd:transparency?	Es una enumeración extensible documentada a continuación, que corresponde a la propiedad TRANSP definida en RFC 2445.
¿gd:visibility?	La enumeración extensible se documenta a continuación.
gd:when*	Hora del evento. Se deben establecer los atributos startTime y endTime, aunque para los eventos que duran todo un día, esos atributos son solo fechas y no hay horarios.
gd:when/gd:reminder*	Recordatorios del evento.
gd:where*	Ubicación del evento o artículos cercanos, como estacionamiento. Si se especifica un elemento <gd:where> en el nivel del feed, pero no hay un elemento <gd:where> en el nivel de la entrada, las entradas heredan el valor <gd:where> en el nivel del feed.
gd:who*	Personas asociadas con el evento: organizador, asistentes, oradores, artistas, etc.
¿gd:who/gd:attendeeStatus?	Estado de aceptación.
¿gd:who/gd:attendeeType?	Tipo de asistentes: required o optional.

valores de rel en gd:where

valor relativo	Descripción
http://schemas.google.com/g/2005#event o no se especificó.	Lugar donde se realiza el evento.
http://schemas.google.com/g/2005#event.alternate	Una ubicación secundaria. Por ejemplo, un sitio remoto con un vínculo de videoconferencia al sitio principal.
http://schemas.google.com/g/2005#event.parking	Estacionamiento cercano.

Valores de gd:eventStatus

Valor	Descripción
http://schemas.google.com/g/2005#event.canceled	Se canceló el evento.
http://schemas.google.com/g/2005#event.confirmed	El evento está planificado.
http://schemas.google.com/g/2005#event.tentative	El evento solo está provisoriamente programado.

valores de gd:visibility

Valor	Descripción
http://schemas.google.com/g/2005#event.confidential	Permite que algunos lectores vean el evento.
http://schemas.google.com/g/2005#event.default	Hereda el comportamiento de las preferencias del propietario del calendario en el que aparece el evento.
http://schemas.google.com/g/2005#event.private	Permite que la menor cantidad de lectores pueda ver el evento.
http://schemas.google.com/g/2005#event.public	Permite que la mayoría de los lectores vean el evento.

valores de gd:transparency

Valor	Descripción
http://schemas.google.com/g/2005#event.opaque	Indica que el evento consume tiempo en el calendario; el horario del evento se marcará como ocupado en una búsqueda libre/ocupado.
http://schemas.google.com/g/2005#event.transparent	Indica que el evento no consume tiempo en el calendario; el tiempo del evento no se marcará como ocupado en una búsqueda libre/ocupado.

Ejemplos

Reunión:

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

Evento en línea:

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

Tipo de mensaje

Representa un mensaje, como un correo electrónico, la publicación de un grupo de discusión o un comentario.

Elemento de categoría: <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>

Propiedades

Propiedad	Descripción
atom:category*	Categorías. Las instancias con el atributo @label se tratan como etiquetas. Para obtener información sobre el uso del atributo @scheme, consulta la nota al comienzo de esta sección. Para obtener información sobre el uso del atributo @term, consulta la siguiente tabla.
atom:content	Cuerpo del mensaje.
atom:link*	Archivos adjuntos de mensajes. Específicamente, para subir un archivo adjunto, usa <link rel="enclosure"> y coloca su contenido en una colección multimedia de Atom.
atom:title	Asunto del mensaje
¿gd:geoPt?	Indica la ubicación geográfica desde donde se publicó el mensaje.
¿gd:rating?	Calificación de calidad (según lo define la aplicación).
gd:who*	Personas asociadas a este mensaje. La semántica exacta depende del valor @rel. Consulta la tabla a continuación.

Categoría @términos

Todas las categorías que aparecen a continuación se encuentran en el esquema http://schemas.google.com/g/2005.

Término	Descripción
http://schemas.google.com/g/2005#message.chat	El mensaje es una transcripción de una sesión de chat.
http://schemas.google.com/g/2005#message.inbox	El mensaje se marcará como perteneciente a la carpeta Recibidos.
http://schemas.google.com/g/2005#message.sent	El mensaje se marcó como enviado.
http://schemas.google.com/g/2005#message.spam	El mensaje se considera spam.
http://schemas.google.com/g/2005#message.starred	El mensaje se marcó como destacado.
http://schemas.google.com/g/2005#message.unread	El mensaje no está leído.

valores de rel en gd:who

Propiedad	Descripción
http://schemas.google.com/g/2005#message.bcc	Enviar un mensaje al destinatario en CCO
http://schemas.google.com/g/2005#message.cc	Mensaje para enviar mensajes a Cc.
http://schemas.google.com/g/2005#message.from	Remitente del mensaje (correo electrónico o IM).
http://schemas.google.com/g/2005#message.reply-to	Destinatario de mensajes de respuesta.
http://schemas.google.com/g/2005#message.to	Destinatario principal del mensaje.

Ejemplo

Mensaje de correo electrónico:

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

Referencia del elemento de espacio de nombres de datos de Google

El resto de este documento consta de material de referencia para los elementos utilizados por las categorías.

• Enumeraciones
• gdCommonProperties
• gd:comentarios
• gd:eliminado
• gd:email
• gd:entryLink
• gd:extendedProperty
• gd:feedLink
• gd:geoPt
• gd:im
• gd:organización
• gd:orgName
• gd:orgTitle
• gd:originalEvent
• gd:phoneNumber
• gd:postalAddress
• gd:calificación
• gd:recurrencia
• gd:recurrenceException
• gd:recordatorio
• gd:cuándo
• gd:where
• gd:quién

Enumeradores

Algunos elementos de la extensión deben especificar propiedades cuyos valores provengan de un conjunto enumerado. La forma general de tales propiedades es la siguiente:

<gd:propertyName value="propertyValue">

Si el valor de la propiedad proviene del espacio de nombres de datos de Google, debe tener el formato http://schemas.google.com/g/2005#{kind}.{value}. Por ejemplo: http://schemas.google.com/g/2005#event.tentative. Si el espacio de valor es extensible, los valores también pueden estar en forma de URI. El formato recomendado para los URI de valores extendidos es {schema URI}#{value}. Por ejemplo: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

Propiedades comunes que se usan en todos los tipos de Google Ten en cuenta que la presencia de anyAttribute y anyElement en el esquema permite extender todos los elementos del espacio de nombres de datos de Google que usan propiedades comunes en cualquier espacio de nombres. En particular, es legal anidar cualquier elemento gd o cualquier elemento Atom/RSS dentro de cualquier otro elemento gd. Esto se debe hacer con criterio y, en la mayoría de los casos, dicho uso se debe documentar como una propiedad explícita del tipo "gd" del elemento que los contiene.

Propiedades

Propiedad	Tipo	Descripción
@xml:base	uri	Construcción de XML estándar para describir la base de URI relativos anidados.
@xml:lang	text	Idioma de las strings anidadas.

Esquema

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

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

gd:comentarios

Contiene un feed de comentarios para la entrada adjunta (como un evento de calendario).

Propiedades

Propiedad	Tipo	Descripción
¿@rel?	string	Tipo de comentarios incluidos. Por el momento, existe una distinción entre los comentarios regulares y los comentarios.
¿gd:feedLink?	feedLink	Feed de comentarios Este feed debe implementar la categoría Message.

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#regular o no se especificó	Comentarios habituales (de los usuarios)
http://schemas.google.com/g/2005#reviews	Opiniones profesionales.

Ejemplos

Feed de comentarios:

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

Feed de opiniones:

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

Esquema

start = comments

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

gd:eliminado

Un elemento marcador que, cuando está presente, indica que se borró la entrada contenedora.

Propiedades

Ninguna

Esquema

start = deleted

deleted =
   element gd:deleted

gd:correo electrónico

Una dirección de correo electrónico asociada con la entidad contenedora (que normalmente es una entidad que representa a una persona o una ubicación).

Propiedades

Propiedad	Tipo	Descripción
@address	xs:string	Dirección de correo electrónico.
¿@label?	xs:string	Es un valor de string simple que se usa para nombrar esta dirección de correo electrónico. Permite que las IU muestren etiquetas, como "Trabajo", "Personal", "Preferida", etc.
¿@rel?	xs:string	Un valor programático que identifica el tipo de correo electrónico; consulta los detalles a continuación.
¿@primary?	xs:boolean	Cuando aparecen varias extensiones de correo electrónico en un tipo de contacto, indica cuál es la principal. Como máximo, un correo electrónico puede ser el principal. El valor predeterminado es "false".

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other	Una dirección de correo electrónico que no sea ni tu casa ni el trabajo. label se puede usar para indicar el tipo real.
http://schemas.google.com/g/2005#work

Ejemplos

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

Esquema

start = email

email =
   element gd:email {
      attribute address { xs:string },
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?
   }

gd:entradadevínculo

Representa una entrada anidada de forma lógica. Por ejemplo, un objeto <gd:who> que representa un contacto puede tener una entrada anidada de un feed de contacto.

Propiedades

Propiedad	Tipo	Descripción
¿@href?	xs:string	Especifica el URI de entrada. Si la entrada anidada está incorporada y no está vinculada, se puede omitir este atributo.
¿@readOnly?	xs:boolean	Especifica si la entrada contenida es de solo lectura. El valor predeterminado es "false".
¿@rel?	xs:string	Especifica la relación de vinculación; permite que el servicio proporcione varios tipos de vínculos de entrada para una sola entidad. Tiene la misma semántica y los valores permitidos que tiene el atributo rel del elemento <atom:link>.
¿atom:entry?	atomEntry	Contenido de la entrada.

Restricciones

• Deben estar presentes @href o <atom:entry>.
• Si atom:entry no está presente, el cliente puede recuperar el contenido del URI de entrada en @href. Si atom:entry está presente, el contenido debe ser el mismo que se recuperaría de @href en el momento en que se generó la entrada.
• Cuando un elemento PUT o POST contiene una <gd:entryLink> y se especifica el atributo @href, el valor del atributo se usa para crear un vínculo. Si el elemento atom:entry también está presente, se ignora. Si no se especifica el atributo @href, el elemento atom:entry se almacena como una entrada incorporada o se almacena en otro feed y se vincula a él. Ten en cuenta que es posible que algunos servicios no admitan todas estas opciones.

Ejemplos

Información de contacto de <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>

Solo referencia externa (entrada de solo lectura):

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

Esquema

start = entryLink

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

propiedad gd:extendedProperty

Te permite almacenar una cantidad limitada de datos personalizados como una propiedad auxiliar de la entidad que la contiene.

Ten en cuenta que la presencia de anyForeignElement permite que el feed incorpore de manera opcional cualquier XML válido dentro del elemento gd:extendedProperty (exclusivo de forma mutua con el atributo value).

Propiedades

Propiedad	Tipo	Descripción
@name	xs:string	Especifica el nombre de la propiedad expresada como un URI. Los URI de propiedades extendidas suelen seguir la convención {scheme}#{local-name}.
¿@value?	xs:string	Valor de la propiedad.

Ejemplo

Un identificador externo para un evento del calendario:

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

XML adicional para entrada de contacto

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

Esquema

start = extendedProperty

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

gd:feedLink

Representa un feed anidado anidado en lógica. Por ejemplo, un feed de calendario podría tener un feed anidado que represente todos los comentarios de las entradas.

Propiedades

Propiedad	Tipo	Descripción
¿@countHint?	xs:unsignedInt	Sugerencias en la cantidad de entradas del feed. Según la implementación, es posible que no sea un recuento exacto.
¿@href?	xs:string	Especifica el URI del feed. Si el feed anidado está incorporado y no está vinculado, es posible que se omita este atributo.
¿@readOnly?	xs:boolean	Especifica si el feed contenido es de solo lectura.
¿@rel?	xs:string	Especifica la relación de vinculación; permite que el servicio proporcione varios tipos de vínculos de feed para una sola entidad. Tiene la misma semántica y los valores permitidos que tiene el atributo rel del elemento <atom:link>.
¿atom:feed?	atomFeed	Contenidos del feed.

Restricciones

• Deben estar presentes @href o <atom:feed>.
• Si atom:feed no está presente, el cliente puede recuperar el contenido del URI en @href. Si está presente, el contenido debe ser el mismo que se recuperaría de @href en el momento en que se generó el feed.
• Cuando un PUT o un POST contienen un <gd:feedLink> y se especifica el atributo @href, el valor del atributo se usa para crear un vínculo. Si el elemento <atom:feed> también está presente, se ignora. Si no se especifica el atributo @href, el elemento <atom:feed> se almacena como un feed incorporado. Ten en cuenta que es posible que algunos servicios no admitan todas estas opciones.

Ejemplos

Blogs:

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

Solo referencia externa:

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

Feed incorporado dentro de una entrada Atom que representa una lista:

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

Esquema

start = feedLink

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

gd:geoPt

Una ubicación geográfica (latitud, longitud y elevación).

Obsoleto. Este elemento es obsoleto. Para datos de etiquetado geográfico, usa GeoRSS en su lugar.

Propiedades

Propiedad	Tipo	Descripción
¿@elev?	xs:float	Elevación en metros. Los valores negativos indican que las profundidades están por debajo del nivel del mar.
¿@label?	xs:string	Es un valor de string simple que se usa para nombrar esta ubicación. Permite que las IU muestren una etiqueta como "Posición actual".
@lat	xs:float	Es la latitud en grados. Los valores positivos significan el norte, los negativos, el sur. El rango es [-90.0, 90.0].
@lon	xs:float	Es la longitud en grados. Los valores positivos significan el este, mientras que los negativos, el oeste. El rango es [-180.0, 180.0].
¿@time?	xs:dateTime	Marca de tiempo

Ejemplos

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

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

Esquema

start = geoPt

geoPt =
   element gd:geoPt {
      attribute label { xs:string }?,
      attribute lat { xs:float },
      attribute lon { xs:float },
      attribute elev { xs:float }?,
      attribute time { xs:dateTime }?
   }

gd:im

Una dirección de mensajería instantánea asociada con la entidad contenedora.

Propiedades

Propiedad	Tipo	Descripción
@address	xs:string	IM.
¿@label?	xs:string	Un valor de string simple para asignar un nombre a esta dirección de IM. Permite que las IU muestren etiquetas, como "Trabajo", "Personal", "Preferida", etc.
¿@rel?	xs:string	Es un valor programático que identifica el tipo de IM. Consulta la siguiente información para obtener más detalles.
¿@protocol?	xs:string	Identifica la red de IM. El valor puede ser uno de los valores estándar (que se muestra a continuación) o un URI que identifica una red de IM de propiedad exclusiva.
¿@primary?	xs:boolean	Cuando aparecen varias extensiones de IM en un tipo de contacto, indica cuál es la principal. Un IM puede ser principal. El valor predeterminado es "false".

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other	Una dirección de IM que no es una dirección particular ni de trabajo. label se puede usar para indicar el tipo real.
http://schemas.google.com/g/2005#work

valores de atributos de protocolo

La siguiente tabla muestra algunos valores posibles para el atributo @protocol.

Valor	Descripción
http://schemas.google.com/g/2005#AIM	Protocolo de mensajería instantánea de AOL
http://schemas.google.com/g/2005#MSN	Protocolo MSN Messenger
http://schemas.google.com/g/2005#YAHOO	Protocolo de Yahoo Messenger
http://schemas.google.com/g/2005#SKYPE	Protocolo Skype
http://schemas.google.com/g/2005#QQ	Protocolo QQ
http://schemas.google.com/g/2005#GOOGLE_TALK	Protocolo de Google Talk
http://schemas.google.com/g/2005#ICQ	Protocolo ICQ
http://schemas.google.com/g/2005#JABBER	Protocolo Jabber

Ejemplos

Una dirección IM para 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"/>

Una dirección IM que proporciona el usuario con un protocolo no especificado. Esa dirección es útil para fines de visualización, pero es difícil de manejar de manera programática.

<gd:im label="Other" address="foo@baz.example.com"/>

Esquema

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:organización

Una organización, generalmente asociada con un contacto.

Propiedades

Propiedad	Tipo	Descripción
¿@label?	xs:string	Un valor de string simple que se usa para nombrar esta organización. Permite que las IU muestren etiquetas como "Trabajo", "Voluntario", "Sociedad profesional", etc.
¿@rel?	xs:string	Es un valor programático que identifica el tipo de organización.
¿@primary?	xs:boolean	Cuando aparecen varias extensiones de organización en un tipo de contacto, indica cuál es la principal. Como máximo, una organización puede ser principal. El valor predeterminado es "false".
¿gd:orgName?	orgName	Es el nombre de la organización.
¿gd:orgTitle?	orgTitle	Es el nombre de una persona dentro de la organización.

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#other	Una organización que no funciona. label se puede usar para indicar el tipo real.
http://schemas.google.com/g/2005#work

Ejemplos

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

Esquema

start = organzation

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

gd:nombredelorg

Es el nombre de la organización. Debe aparecer dentro de un elemento gd:organization.

Ejemplo

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

Esquema

start = orgName

orgName =
   element gd:orgName { xs:string }

gd:orgTítulo

Es el nombre de una persona dentro de una organización. Debe aparecer dentro de un elemento gd:organization.

Ejemplo

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

Esquema

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:originalEvento

Equivalente a la propiedad de ID de recurrencia especificada en la sección 4.8.4.4 de RFC 2445. Aparece en cada instancia de un evento recurrente para identificar el evento original.

Contiene un elemento <gd:when> que especifica la hora de inicio original de la instancia que se convirtió en una excepción.

Propiedades

Propiedad	Tipo	Descripción
@id	xs:string	El ID del evento original.
@href	xs:string	La URL del feed de eventos del evento original.

Ejemplo

Cómo especificar un evento original:

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

Esquema

start = originalEvent

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

gd:númerodeteléfono

Un número de teléfono asociado con la entidad que lo contiene (que suele ser una entidad que representa a una persona o una ubicación)

Propiedades

Propiedad	Tipo	Descripción
¿@label?	xs:string	Es un valor de string simple para nombrar este número de teléfono. En la mayoría de los casos, @label no es necesario, ya que @rel identifica de forma única un número y permite que las IU muestren una etiqueta adecuada, como "Dispositivo móvil", "Casa", "Trabajo", etc. Sin embargo, en el caso de que una persona tenga (por ejemplo) varios teléfonos celulares, esta propiedad se puede usar para desambiguarlas.
¿@rel?	xs:string	Es un valor programático que identifica el tipo de número de teléfono. Consulte la siguiente información para obtener más detalles.
¿@uri?	xs:string	Un "URI de teléfono" opcional que se usa para representar el número de manera formal y útil para el acceso programático, como un puente VoIP/PSTN. Consulta RFC 3966 para obtener más información sobre los URI de teléfono.
¿@primary?	xs:boolean	Cuando aparecen varias extensiones de número de teléfono en un tipo de contacto, indica cuál es la principal. Como máximo, un número de teléfono puede ser el principal. El valor predeterminado es "false".
text()	xs:string	Número de teléfono legible. Puede estar en cualquier formato de número de teléfono. Los espacios en blanco iniciales y finales no son significativos. Las líneas nuevas dentro de la string también son insignificantes y se pueden quitar o compactar en un solo espacio.

valores relativos

Valor	Descripción
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	Tipo de número especial para el que no tiene sentido ningún otro valor de rel Por ejemplo, un dispositivo TTY. label se puede usar para indicar el tipo real.
http://schemas.google.com/g/2005#pager
http://schemas.google.com/g/2005#work
http://schemas.google.com/g/2005#work_fax

Ejemplos

Número de teléfono simple que ingresó un usuario:

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

El mismo número de teléfono extraído de un directorio:

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

Número con etiqueta:

<gd:phoneNumber rel="http://schemas.google.com/g/2005#mobile" label="Personal calls only" uri="tel:+12065551212">
  +1 206 555 1212
</gd:phoneNumber>

Esquema

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

Una dirección postal.

Propiedades

Propiedad	Tipo	Descripción
¿@label?	xs:string	Es un valor de string simple que se usa para nombrar esta dirección.
¿@rel?	xs:string	Es un valor programático que identifica el tipo de dirección postal; consulta los detalles a continuación.
¿@primary?	xs:boolean	Cuando aparecen varias extensiones de dirección postal en un tipo de contacto, indica cuál es la principal. Como máximo, una dirección postal puede ser principal. El valor predeterminado es "false".
text()	xs:string	La dirección como texto Los espacios en blanco iniciales y finales no son significativos. Las líneas nuevas dentro de la string son significativas.

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other	Una dirección que no es ni tu casa ni tu trabajo. label se puede usar para indicar el tipo real.
http://schemas.google.com/g/2005#work

Ejemplos

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

Esquema

start = postalAddress

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

calificación de gd

Representa una calificación numérica de la entidad que la contiene, como un comentario. Cada calificación proporciona su propia escala, aunque puede ser normalizada por un servicio. Por ejemplo, algunos servicios pueden convertir todas las calificaciones en una escala del 1 al 5.

Propiedades

Propiedad	Tipo	Descripción
¿@average?	xs:float	Calificación promedio.
@max	xs:int	El valor máximo de la escala de calificación
@min	xs:int	El valor mínimo de la escala de calificación
¿@numRaters?	xs:int	Cantidad de calificaciones que se tienen en cuenta al calcular el valor promedio
¿@rel?	xs:string	Especifica el aspecto que se está calificando. Si no se especifica, la calificación es una calificación general.
¿@value?	xs:int	Valor de la calificación.

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#overall o no se especificó	Calificación general Los valores más altos implican mejores calificaciones.
http://schemas.google.com/g/2005#price	Calificación de precio Los valores más altos implican precios más altos.
http://schemas.google.com/g/2005#quality	Calificación: Los valores más altos implican una mejor calidad.

Ejemplos

Calificación general de 4/5:

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

Calificación del intervalo de precios más costoso:

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

Calificado por 200 usuarios con una calificación promedio de 4.65 de 5:

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

Esquema

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

Representa las fechas y horas en las que se realiza un evento recurrente.

La string que define la recurrencia consiste en un conjunto de propiedades, cada una de las cuales está definida en el estándar iCalendar (RFC 2445).

Específicamente, la string suele comenzar con una propiedad DTSTART que indica la hora de inicio de la primera instancia del evento y, a menudo, una propiedad DTEND o una propiedad DURATION para indicar cuándo termina la primera instancia. A continuación, se encuentran las propiedades RRULE, RDATE, EXRULE o EXDATE, que definen colectivamente un evento recurrente y sus excepciones (pero se muestran a continuación). (Consulta la sección 4.8.5 de RFC 2445 para obtener más información sobre estas propiedades de recurrencia). Por último, se incluye un componente VTIMEZONE, que proporciona reglas de zona horaria detalladas para cualquier ID de zona horaria mencionado en las propiedades anteriores.

Por lo general, los servicios de Google, como Calendario de Google, no generan propiedades EXRULE y EXDATE para representar excepciones a los eventos recurrentes. En cambio, generan elementos <gd:recurrenceException>. Sin embargo, los servicios de Google pueden incluir propiedades EXRULE o EXDATE de todos modos. Por ejemplo, los usuarios pueden importar eventos y excepciones a Calendario y, si esos eventos importados contienen propiedades EXRULE o EXDATE, Calendario proporcionará esas propiedades cuando envíe un elemento <gd:recurrence>.

Ten en cuenta que el uso de <gd:recurrenceException> implica que no puedes estar seguro de solo examinar un elemento <gd:recurrence> si hay excepciones a la descripción de la recurrencia. Para asegurarte de encontrar todas las excepciones, busca los elementos <gd:recurrenceException> en el feed y usa sus elementos <gd:originalEvent> para buscar coincidencias con los elementos <gd:recurrence>.

Propiedades

Propiedad	Tipo	Descripción
text()	xs:string	Descripción de la recurrencia.

Ejemplo

Un evento recurrente que se realiza todas las mañanas de 6:00 a.m. a 7:00 a.m., Hora del Pacífico, del 14 de marzo al 21 de marzo de 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>

Esquema

start = recurrence

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

gd:recurrenciaExcepción

Representa un evento que es una excepción a un evento recurrente, es decir, una instancia de un evento recurrente en el que se modificaron uno o más aspectos del evento (como la lista de asistencia, la hora o la ubicación).

Contiene un elemento <gd:originalEvent> que especifica el evento recurrente original al que este evento es una excepción.

Cuando cambias una instancia de un evento recurrente, esa instancia se convierte en una excepción. Según el cambio que hayas hecho, la excepción se comporta de dos maneras diferentes cuando se modifica el evento original original:

• Si agregas, cambias o quitas comentarios, asistentes o respuestas de asistentes, la excepción permanecerá vinculada al evento original y los cambios en el evento original también cambiarán la excepción.
• Si realiza cualquier otro cambio en la excepción (como cambiar la hora o la ubicación), la instancia se volverá "especializada", lo que significa que ya no está tan estrechamente vinculado al evento original. Si cambia el evento original, las excepciones especializadas no se modificarán. Pero consulta a continuación.

Por ejemplo, supongamos que tienes una reunión todos los martes y jueves a las 2:00 p.m. Si cambias la lista de asistencia para la reunión de este jueves (pero no para la reunión habitual programada), se convierte en una excepción. Si cambia el horario de esta reunión del jueves (pero no la de la reunión que se programó de forma regular), se especializará.

Independientemente de si una excepción es especializada o no, si haces algo que borra la instancia de la que se deriva la excepción, entonces se borra la excepción. Ten en cuenta que cambiar el día o la hora de un evento recurrente borra todas las instancias y crea otras nuevas.

Por ejemplo, después de que se especializó la reunión de este jueves, supongamos que cambia la reunión recurrente para que se realice el lunes, miércoles y viernes. Ese cambio borra todas las instancias recurrentes de la reunión de martes y jueves, incluida la especializada.

Si se borra una instancia en particular de un evento recurrente, esa instancia aparece como una <gd:recurrenceException> que contiene un <gd:entryLink> que tiene su <gd:eventStatus> establecido en "http://schemas.google.com/g/2005#event.canceled". (Para obtener más información sobre los eventos cancelados, consulte RFC 2445).

Propiedades

Propiedad	Tipo	Descripción
@specialized	xs:boolean	Indica si la excepción es especializada o no.
gd:entryLink	entryLink	Una entrada de evento que proporciona los detalles de la excepción
gd:originalEvent	originalEvent	Evento recurrente original al que esta es una excepción.

Ejemplo

Una excepción a un evento recurrente (se reemplazan algunas partes por breves identificadores en cursiva para brindar mayor claridad):

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

Esquema

start = recurrenceException

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

gd:recordatorio

Más utilizado en: <gd:when>

Un intervalo que indica el tiempo que debe transcurrir antes de que se emita un recordatorio antes del atributo @startTime o @dueTime de la entidad que lo contiene También puede especificar una hora absoluta en la que se debe emitir un recordatorio. También especifica un método de notificación que indica el medio que el sistema debe utilizar para recordar al usuario.

Propiedades

Propiedad	Tipo	Descripción
¿@absoluteTime?	xs:dateTime	Hora absoluta en la que se debe emitir el recordatorio. Por lo general, se usa cuando un usuario utiliza la función "posponer" para retrasar un recordatorio anterior. Si no se especifica la zona horaria, se usa la hora local del observador.
¿@method?	xs:string	El método de notificación que debe usar el recordatorio Puede tener cualquiera de los siguientes valores: alert (hace que aparezca una alerta cuando un usuario ve el calendario en un navegador), email (le envía un mensaje de correo electrónico al usuario) o sms (que le envía un mensaje de texto SMS).
¿@days?	xs:unsignedInt	Período de tiempo antes del gd:when/@startTime en el que se debe emitir un recordatorio. Si la hora objetivo de la entidad principal es una fecha en lugar de una hora específica, estos atributos están relacionados con la medianoche (00:00) de esa fecha.
¿@hours?	xs:unsignedInt
¿@minutes?	xs:unsignedInt

Cuando crees o edites una entrada <gd:when>, usa las siguientes convenciones para lograr resultados específicos:

• Para indicarle al servicio que use los recordatorios predeterminados del usuario, incluye un elemento <gd:reminder> sin atributos. Si especificas una duración, pero no un atributo method, el servicio usará los métodos de notificación predeterminados del usuario con la duración que especificaste.
• Para indicarle al servicio que no emita ningún recordatorio del evento (o que quite los recordatorios existentes durante la actualización de un evento), no incluyas ningún elemento <gd:reminder>.

Restricciones

• Se puede especificar como máximo @days, @hours, @minutes o @absoluteTime. Para especificar una duración mixta, conviértela en la unidad más precisa. Por ejemplo, para especificar 1 hora y 30 minutos, usa @minutes="90".
• No puede usar valores negativos en los atributos (por lo tanto, si desea que se produzca un recordatorio después de la hora de inicio, debe usar @absoluteTime).
• Un evento determinado no puede tener más de cinco recordatorios asociados.
• Cuando agregas un recordatorio a un evento, si especificas los métodos alert, email o sms, también debes especificar una duración.

Ejemplos

Un recordatorio de 15 minutos para una reunión:

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

La misma reunión anterior, pero pospuesta 10 minutos después del recordatorio a las 4:45 p.m.:

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

Esquema

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

Un identificador de recurso opaco, distinto del atom:id, ya que no necesita ser un URI válido. Algunos servicios proporcionan un identificador independiente que se usará para construir solicitudes posteriores. El uso exacto es específico del servicio.

Ejemplo

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

Esquema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:cuándo

Representa un período o un instante.

Propiedades

Propiedad	Tipo	Descripción
¿@endTime?	xs:dateTime o xs:date	Indica cuándo termina el evento. Si no se especifica la zona horaria, se supone que corresponde a la zona horaria local del observador.
@startTime	xs:dateTime o xs:date	Describe cuándo comienza el evento o (en el caso de los eventos de duración cero) cuándo ocurre. Si no se especifica la zona horaria, se supone que corresponde a la zona horaria local del observador.
¿@valueString?	xs:string	Un valor de string simple que se puede usar como representación de este período.

Restricciones

• No es posible combinar xs:dateTime con xs:date en startTime/endTime.
• Si no se especifica endTime, se considera que el evento es instantáneo en el tiempo (si @startTime incluye una hora) o un evento de un día (si @startTime es solo una fecha).

Ejemplos

Un evento de un día:

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

Representación alternativa de un evento de un día:

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

Un evento de dos días (6 y 7 de junio) con una descripción en cadena:

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

Una reunión de una hora:

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

Un evento de duración cero:

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

Esquema

start = when

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

gd:dónde

Un lugar (como la ubicación de un evento) asociado con la entidad que lo contiene. El tipo de asociación está determinado por el atributo rel; los detalles de la ubicación se encuentran en una entrada de contacto incorporada o vinculada a ella.

Un elemento <gd:where> es más general que un elemento <gd:geoPt>. El primero identifica un lugar usando una descripción de texto o una entrada de contacto, mientras que el segundo identifica un lugar usando una ubicación geográfica específica.

Propiedades

Propiedad	Tipo	Descripción
¿@label?	xs:string	Especifica una etiqueta legible por el usuario para distinguirla de otras.
¿@rel?	xs:string	Especifica la relación entre la entidad que contiene y la ubicación contenida. Otros valores pueden definir los valores posibles (ver más abajo). Por ejemplo, <gd:when> define http://schemas.google.com/g/2005#event.
¿@valueString?	xs:string	Es un valor de string simple que se puede usar como representación de esta ubicación.
¿gd:entryLink?	entryLink	Entrada que representa los detalles de la ubicación. Esta entrada debe implementar el tipo Contact.

valores relativos

Valor	Descripción
http://schemas.google.com/g/2005#event o no se especificó	Lugar donde se realiza el evento de cierre
http://schemas.google.com/g/2005#event.alternate	Una ubicación secundaria. Por ejemplo, un sitio remoto con un vínculo de videoconferencia al sitio principal.
http://schemas.google.com/g/2005#event.parking	Un estacionamiento cercano

Ejemplos

Ubicación del evento:

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

Ubicación del evento más complicada:

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

Evento con varias ubicaciones:

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

Esquema

start = where

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

gd

Una persona asociada con la entidad que lo contiene. El tipo de asociación se determina mediante el atributo rel; los detalles sobre la persona se encuentran en una entrada de contacto incorporada o vinculada a ella.

El elemento <gd:who> se puede usar para especificar remitentes y destinatarios de correo electrónico, organizadores de eventos de calendario, etc.

Propiedades

Propiedad	Tipo	Descripción
¿@email?	xs:string	Dirección de correo electrónico. Por lo general, esta propiedad se usa cuando no se especifica <gd:entryLink>. La dirección debe cumplir con RFC 2822, sección 3.4.1.
¿@rel?	xs:string	Especifica la relación entre la entidad que contiene y la persona que la contiene. Consulte los posibles valores a continuación.
¿@valueString?	xs:string	Un valor de string simple que se puede usar como una representación de esta persona.
¿gd:attendeeStatus?	gEnumConstruct	Estado del asistente al evento. La enumeración extensible se documenta a continuación.
¿gd:attendeeType?	gEnumConstruct	Tipo de asistente al evento. La enumeración extensible se documenta a continuación.
¿gd:entryLink?	entryLink	Entrada que representa los detalles de la persona. Esta entrada debe implementar el tipo Contact. En muchos casos, esta entrada provendrá de un feed de contacto.

valores relativos

Los valores válidos de @rel dependen del tipo en el que aparece el elemento <gd:who>.

Valor	Tipo	Descripción
http://schemas.google.com/g/2005#event.attendee	Evento	Un asistente a una reunión o evento general
http://schemas.google.com/g/2005#event.organizer	Evento	Organizador del evento. Los organizadores no son necesariamente asistentes.
http://schemas.google.com/g/2005#event.performer	Evento	Artista. Similar a http://schemas.google.com/g/2005#event.speaker, pero con mayor énfasis en el arte que en la entrega de discursos.
http://schemas.google.com/g/2005#event.speaker	Evento	Altavoz.
http://schemas.google.com/g/2005#message.bcc	Mensaje	Enviar un mensaje al destinatario en CCO
http://schemas.google.com/g/2005#message.cc	Mensaje	Mensaje para enviar mensajes a Cc.
http://schemas.google.com/g/2005#message.from	Mensaje	Remitente del mensaje (correo electrónico o IM).
http://schemas.google.com/g/2005#message.reply-to	Mensaje	Destinatario de mensajes de respuesta.
http://schemas.google.com/g/2005#message.to	Mensaje	Destinatario principal del mensaje.

Valores de gd:attendeeType

Valor	Descripción
http://schemas.google.com/g/2005#event.optional	Asistente opcional.
http://schemas.google.com/g/2005#event.required	Asistente obligatorio

Valores de gd:attendeeStatus

Valor	Descripción
http://schemas.google.com/g/2005#event.accepted	El asistente aceptó.
http://schemas.google.com/g/2005#event.declined	El asistente rechazó la invitación.
http://schemas.google.com/g/2005#event.invited	Se envió la invitación, pero la persona no la aceptó.
http://schemas.google.com/g/2005#event.tentative	El asistente aceptó provisoriamente.

Ejemplos

Destinatarios de correo electrónico:

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

Asistente a la reunión:

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

Organizador del evento:

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

Esquema

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

Volver al principio