Se usó la API de Cloud Translation para traducir esta página.

Elementos comunes: "Clases"

Advertencia: Esta página trata sobre las API anteriores de Google, las API de datos de Google, y solo es relevante para las API que aparecen en el directorio de las API de datos de Google, muchas de las cuales se reemplazaron con API más nuevas. Para obtener información sobre una API nueva específica, consulta la documentación de la API nueva. Para obtener información sobre cómo autorizar solicitudes con una API más reciente, consulta Autenticación y autorización de cuentas de Google.

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

Nota: Si usas la categoría de contacto en el contexto de la API de Contactos, recuerda que la versión 2.0 de la categoría de contactos (que se describe en este documento) la usa la API de Contactos desde la versión 3.0 de la API.

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 Este campo es de solo lectura. Para modificar el nombre del contacto, consulta `gd:name`.
`gd:email`*	Direcciones de correo electrónico.
`gd:extendedProperty`*	Propiedad extendida.
¿`gd:deleted`?	La presencia de este elemento indica que se borró esta entrada de contacto.
`gd:im`*	direcciones IM.
¿`gd:name`?	Nombre del contacto en forma estructurada.
`gd:organization`*	Organización
`gd:phoneNumber`*	Números de teléfono y fax
`gd:structuredPostalAddress`*	Dirección postal del contacto en formato estructurado.
¿`gd:where`?	Un lugar asociado con el 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 perfil

Representa un perfil asociado a un usuario de Google o a otra entidad. El tipo de perfil comparte mucha estructura con el Tipo de contacto. Sin embargo, tiene algunas diferencias: no puede contener propiedades extendidas ni marcarse como borradas.

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

El tipo de perfil se introdujo en la versión 3.0 de la API de Contactos.

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 "Elemento de categoría" al comienzo de esta sección.
`atom:content`	Notas sobre el perfil.
`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 perfil.
`atom:title`	Nombre del perfil Este campo es de solo lectura.
`gd:email`*	Direcciones de correo electrónico.
`gd:im`*	direcciones IM.
¿`gd:name`?	Nombre, en el formato estructurado.
`gd:organization`*	Organización
`gd:phoneNumber`*	Números de teléfono y fax
`gd:structuredPostalAddress`*	Dirección postal en formato estructurado.
¿`gd:where`?	Un lugar asociado con el perfil.

Ejemplos

<entry xmlns='http://www.w3.org/2005/Atom'
xmlns:gContact='http://schemas.google.com/contact/2008'
xmlns:batch='http://schemas.google.com/gdata/batch'
xmlns:gd='http://schemas.google.com/g/2005'
  <category scheme='http://schemas.google.com/g/2005#kind'
  term='http://schemas.google.com/contact/2008#profile' />
  <title>Elizabeth Bennett</title>
  <gd:name>
    <gd:givenName>Elizabeth</gd:givenName>
    <gd:familyName>Bennett</gd:familyName>
  </gd:name>
  <gd:structuredPostalAddress rel='http://schemas.google.com/g/2005#work'>
    <gd:formattedAddress>Longbourne, Nr. Meryton, Hertfordshire, England</gd:formattedAddress>
  </gd:structuredPostalAddress>
</entry>

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:extendedProperty`*	Propiedad extendida.
¿`gd:originalEvent`?	Es el identificador original de los eventos recurrentes.
¿`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:additionalName
gd:comentarios
gd:país
gd:eliminado
gd:email
gd:entryLink
gd:extendedProperty
gd:nombredefamilia
gd:feedLink
gd:geoPt
gd:givenName
gd:im
gd:organización
gd:orgDepartment
gd:orgJobDescription
gd:orgName
gd:orgSymbol
gd:orgTitle
gd:originalEvent
gd:phoneNumber
gd:postalAddress
gd:calificación
gd:recurrencia
gd:recurrenceException
gd:recordatorio
gd:structuredPostalAddress.
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:nombreadicional

Especifica el nombre adicional (p. ej., del medio) de la persona, p. ej., "Susan".

Propiedades

Propiedad	Tipo	Descripción
¿`@yomi`?	`xs:string`	Representación neta.
`text()`	`xs:string`	Apellido de la persona.

Ejemplo

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

Esquema

start = additionalName

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

gd:comentarios

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

Propiedades

Propiedad	Tipo	Descripción
¿`@rel`?	`xs: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:país

Nombre del país junto con el código de país opcional. Esto último se proporciona de acuerdo con la norma ISO 3166-1 alpha-2.

Propiedades

Propiedad	Tipo	Descripción
¿`@code`?	`xs:string`	Corresponde al código de país, como en ISO 3166-1 alpha-2.
`text()`	`xs:string`	Nombre del país.

Ejemplos

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

Esquema

start = country

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

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.
¿`@displayName`?	`xs:string`	Un nombre visible de la entidad (p. ej., una persona) a la que pertenece la 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" displayName="Foo Bar" />
<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 displayName { 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. Por lo general, los URI de propiedades extendidas siguen la convención {schema}#{local-name}.
¿`@value`?	`xs:string`	Valor de la propiedad.
¿`@realm`?	`xs:string`	Algunas API lo usan para especificar dónde se aplica la propiedad extendida.

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*),
      attribute realm { xs:string } ?
   }

gd:nombredefamilia

Especifica el apellido de la persona, p. ej., “Pérez”.

Propiedades

Propiedad	Tipo	Descripción
¿`@yomi`?	`xs:string`	Representación fonética.
`text()`	`xs:string`	Apellido de la persona.

Ejemplo

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

Esquema

start = familyName

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

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#netmeeting`
`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:givenName

Especifica el nombre de la persona, p. ej., "Juan".

Propiedades

Propiedad	Tipo	Descripción
¿`@yomi`?	`xs:string`	Representación fonética.
`text()`	`xs:string`	Nombre de la persona.

Ejemplo

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

Esquema

start = givenName

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

gd:dinero

Especifica el importe en una moneda específica.

Propiedades

Propiedad	Tipo	Descripción
`@amount`	`xsd:float`	Cantidad de dinero
`@currencyCode`	`xsd:string`	Código de moneda ISO4217.

Ejemplo

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

Esquema

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

gd:nombre

Permite almacenar el nombre de la persona de forma estructurada. Consiste en nombre de pila, nombre adicional, nombre de familia, prefijo, sufijo y nombre completo.

Propiedades

Propiedad	Tipo	Descripción
¿`gd:givenName`?	`givenName`	Nombre de la persona.
¿`gd:additionalName`?	`additionalName`	Nombre adicional de la persona, p. ej., segundo nombre.
¿`gd:familyName`?	`familyName`	Apellido de la persona.
¿`gd:namePrefix`?	`namePrefix`	Prefijo honorífico, p. ej., "Sr." o "Sra."
¿`gd:nameSuffix`?	`nameSuffix`	Sufijo honorífico, p. ej., "san" o "III".
¿`gd:fullName`?	`fullName`	Representación no estructurada del nombre.

Ejemplo

Representación estructurada de Sir Winston Leonard Spencer-Churchill, KG

<gd:name>
  <gd:givenName>Winston</gd:givenName>
  <gd:additionalName>Leonard</gd:additionalName>
  <gd:familyName>Spencer-Churchill</gd:familyName>
  <gd:namePrefix>Sir</gd:namePrefix>
  <gd:nameSuffix>OG</gd:nameSuffix>
</gd:name>

Esquema

start = name

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

Restricciones

El componente no estructurado del nombre debe ser coherente con su representación estructurada.

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.
¿`gd:orgDepartment`?	`orgDepartment`	Especifica un departamento dentro de la organización.
¿`gd:orgJobDescription`?	`orgJobDescription`	Descripción de un trabajo dentro de la organización.
¿`gd:orgName`?	`orgName`	Es el nombre de la organización.
¿`gd:orgSymbol`?	`orgSymbol`	Símbolo de la organización.
¿`gd:orgTitle`?	`orgTitle`	Es el nombre de una persona dentro de la 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"`.
¿`@rel`?	`xs:string`	Es un valor programático que identifica el tipo de organización. Consulta los detalles a continuación.
¿`gd:where`?	`where`	Un lugar asociado con la organización, p.ej., la ubicación de la oficina.

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:orgJobDescription>Writes documentation</gd:orgJobDescription>
  <gd:orgDepartment>Software Development</gd:orgDepartment>
  <gd:orgSymbol>GOOG</gd:orgSymbol>
</gd:organization>

Esquema

start = organization

organization =
   element gd:organization {
      attribute label { xs:string }?,
      attribute rel { xs:string }?,
      attribute primary { xs:boolean }?,
      ( orgDepartment? &
      orgJobDescription? &
      orgName? &
      orgSymbol? &
      orgTitle? &
      where? )
   }

gd:orgDepartment

Describe un departamento dentro de una organización. Debe aparecer dentro de un elemento gd:organization.

Ejemplo

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

Esquema

start = orgDepartment

orgDepartment = element gd:orgDepartment { xs:string }

descripción de gd:orgJob

Describe un trabajo dentro de una organización. Debe aparecer dentro de un elemento gd:organization.

Ejemplo

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

Esquema

start = orgJobDescription

orgJobDescription = element gd:orgJobDescription { xs:string }

gd:nombredelorg

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

Propiedades

Propiedad	Descripción
¿`@yomi`?	Yomigana (ayuda de lectura japonesa) para el nombre de la organización.

Ejemplo

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

Esquema

start = orgName

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

gd:orgSímbolo

Indica el símbolo de una organización. Debe aparecer dentro de un elemento gd:organization.

Ejemplo

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

Esquema

start = orgSymbol

orgSymbol = element gd:orgSymbol { 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#assistant`
`http://schemas.google.com/g/2005#callback`
`http://schemas.google.com/g/2005#car`
`http://schemas.google.com/g/2005#company_main`
`http://schemas.google.com/g/2005#fax`
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#home_fax`
`http://schemas.google.com/g/2005#isdn`
`http://schemas.google.com/g/2005#main`
`http://schemas.google.com/g/2005#mobile`
`http://schemas.google.com/g/2005#other`	Tipo de número especial para el que no tiene sentido ningún otro valor de `rel` `label` se puede usar para indicar el tipo real.
`http://schemas.google.com/g/2005#other_fax`
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#radio`
`http://schemas.google.com/g/2005#telex`
`http://schemas.google.com/g/2005#tty_tdd`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`
`http://schemas.google.com/g/2005#work_mobile`
`http://schemas.google.com/g/2005#work_pager`

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

La dirección postal se dividió en componentes. Permite almacenar la dirección en un formato independiente de configuración regional. Los campos se pueden interpretar y usar para generar una dirección con formato y que dependa de la configuración regional. Los siguientes elementos representan las partes de la dirección: agente, nombre de la casa, calle, apartado postal, barrio, ciudad, subregión, región, código postal y país. El elemento subregion no se usa para las direcciones postales; se proporciona solo para usos extendidos de direcciones. Para almacenar la dirección postal en un formulario no estructurado, se proporciona un campo con la dirección con formato.

Propiedades

Propiedad	Tipo	Descripción
¿`@rel`?	`xs:string`	Tipo de la dirección. A menos que se asuma el tipo `work` especificado.
¿`@mailClass`?	`xs:string`	Se aceptan las clases de correo en la dirección. A menos que se especifique `both`.
¿`@usage`?	`xs:string`	El contexto en el que se puede usar esta dirección. Las direcciones locales pueden diferir en cuanto al diseño de las direcciones generales y, además, suelen usar secuencias de comandos locales (a diferencia del alfabeto latino) aunque también se permite en las direcciones generales. A menos que se use el uso de `general` especificado.
¿`@label`?	`xs:string`	Una etiqueta general para la dirección.
¿`@primary`?	`xs:boolean`	Especifica la dirección como principal. El valor predeterminado es `false`.
¿`gd:agent`?	`agent`	El agente que realmente recibe el correo electrónico Se usa en las direcciones de trabajo. También para "a cargo de" o "c/o".
¿`gd:housename`?	`housename`	Se usa en lugares donde las casas o los edificios tienen nombres (y no necesariamente números), p. ej., “Los Pilares”.
¿`gd:street`?	`street`	Puede ser calle, avenida, carretera, etc. Este elemento también incluye el número de la casa, el departamento o el departamento.
¿`gd:pobox`?	`pobox`	Cubre apartados postales, cajones, bolsos cerrados, etc. Por lo general, esto no siempre es mutuamente excluyente de las calles.
¿`gd:neighborhood`?	`neighborhood`	Se utiliza para eliminar la ambigüedad de la dirección postal cuando una ciudad incluye más de una calle con el mismo nombre, o para especificar un lugar pequeño cuyo correo se dirige a través de un pueblo postal más grande. En China, puede ser un condado o una ciudad menor.
¿`gd:city`?	`city`	Puede ser ciudad, pueblo, pueblo, municipio, etc. Es el código postal y no necesariamente el lugar de residencia o el lugar de la empresa.
¿`gd:subregion`?	`subregion`	Gestiona los distritos administrativos, como los condados de los Estados Unidos o el Reino Unido, que no se utilizan con fines de direccionamiento por correo. La subregión no está destinada a las direcciones de entrega.
¿`gd:region`?	`region`	Un estado, una provincia, un condado (en Irlanda), una tierra (en Alemania), un departamento (en Francia), etc.
¿`gd:postcode`?	`postcode`	Código postal. Por lo general, es de todo el país, pero a veces es específico de la ciudad (p.ej., "2" en las direcciones de "Dublín 2, Irlanda").
¿`gd:country`?	`country`	El nombre o el código del país.
¿`gd:formattedAddress`?	`formattedAddress`	Es la dirección postal completa y no estructurada.

valores relativos

Valor	Descripción
`http://schemas.google.com/g/2005#work`	Dirección de trabajo. A menos que otro valor sea el predeterminado.
`http://schemas.google.com/g/2005#home`	Dirección particular.
`http://schemas.google.com/g/2005#other`	Cualquier otro tipo de dirección

valores de mailClass

Valor	Descripción
`http://schemas.google.com/g/2005#both`	Puedes enviar paquetes o cartas a esta dirección. A menos que otro valor sea el predeterminado.
`http://schemas.google.com/g/2005#letters`	Solo se pueden enviar letras a la dirección.
`http://schemas.google.com/g/2005#parcels`	Solo se pueden enviar paquetes a la dirección.
`http://schemas.google.com/g/2005#neither`	La dirección corresponde únicamente a un lugar y no se puede utilizar para el correo electrónico.

valores de uso

Valor	Descripción
`http://schemas.google.com/g/2005#general`	Esta dirección es para uso general. A menos que otro valor sea el predeterminado.
`http://schemas.google.com/g/2005#local`	Esta dirección es para uso local.

Ejemplos

Dirección empresarial:

Sr. Juan Pérez

Google Inc.

1600 Amphitheatre Parkway

Mountain View, CA 94043

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#letters' label='John at Google'>
  <gd:street>1600 Amphitheatre Parkway</gd:street>
  <gd:city>Mountain View</gd:city>
  <gd:region>CA</gd:region>
  <gd:postcode>94043</gd:postcode>
</gd:structuredPostalAddress>

Dirección privada:

Madame Duval

27, rue Pasteur

14390 CABOURG

FRANCIA

<gd:structuredPostalAddress mailClass='http://schemas.google.com/g/2005#both' label='Madame Duval'>
  <gd:street>27, rue Pasteur</gd:street>
  <gd:city>CABOURG</gd:city>
  <gd:postcode>14390</gd:postcode>
  <gd:country>FRANCE</gd:country>
</gd:structuredPostalAddress>

Esquema

start = structuredPostalAddress

structuredPostalAddress =
   element gd:structuredPostalAddress {
      attribute label { xs:string }?,
      attribute mailClass { xs:string }?,
      attribute primary { xs:boolean }?,
      attribute rel { xs:string }?,
      attribute usage { xs:string }?,
      (agent?
       & housename?
       & street?
       & poBox?
       & neighborhood?
       & city?
       & subregion?
       & region?
       & postcode?
       & country?
       & formattedAddress? )
}

Restricciones

Está prohibido tener "gd:postalAddress" y "gd:structuredPostalAddress" en una entidad.
Solo se puede especificar una dirección estructurada como principal.
La dirección postal no estructurada debe ser coherente con los datos estructurados.

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 { xs:string }?,
      (entryLink?
       & element gd:attendeeType { gEnumConstruct }?
       & element gd:attendeeStatus { gEnumConstruct }?)
   }

Volver al principio

Cambios desde 1.0

Cambios en el tipo de contacto

Los siguientes elementos que no están presentes en la versión 1.0 se agregaron en la versión 2.0 del tipo de contacto:

gd:name
gd:structuredPostalAddress
gd:where

Los siguientes tipos de teléfono que no están presentes en la versión 1.0 se agregaron en la versión 2.0:

http://schemas.google.com/g/2005#assistant
http://schemas.google.com/g/2005#callback
http://schemas.google.com/g/2005#car
http://schemas.google.com/g/2005#company_main
http://schemas.google.com/g/2005#isdn
http://schemas.google.com/g/2005#main
http://schemas.google.com/g/2005#other_fax
http://schemas.google.com/g/2005#radio
http://schemas.google.com/g/2005#telex
http://schemas.google.com/g/2005#tty_tdd
http://schemas.google.com/g/2005#work_mobile
http://schemas.google.com/g/2005#work_pager

El siguiente tipo de IM que no está presente en la versión 1.0 se agregó en la versión 2.0:

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

Ya no se admiten los siguientes elementos del tipo de contacto 1.0:

atom:title: aún está presente en las entradas que muestra el servidor, pero se ignora en las solicitudes PUT y POST. Se reemplazó por gd:name.
gd:postalAddress: Reemplazado por gd:structuredPostalAddress.

Cambios en `gd:email`

El nuevo atributo @displayName se agregó en gd:email en 2.0

Cambios en `gd:organization`

Los siguientes subelementos de gd:organization se introdujeron en la versión 2.0:

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

Cambios en `gd:orgName`

En la versión 2.0, se mejoró el elemento gd:orgName agregando el atributo @yomi.

Volver al principio