Elementos comuns: "Kinds"

Introdução

Muitas vezes, é útil para os serviços que usam as APIs de dados do Google fornecerem um conjunto consistente de informações sobre um tipo específico de item.

Por exemplo, vários serviços da API Google Data (ou "GData") podem fornecer dados de contato para uma pessoa ou organização. Faz sentido que todos esses serviços usem o mesmo conjunto de elementos de dados de contato.

O conjunto de elementos que descrevem um contato juntos é chamado de "tipo de contato". Alguns dos elementos do tipo de contato são elementos Atom ou RSS comuns. Outros são definidos pelo Google em um namespace chamado "namespace de dados do Google". Por convenção, o namespace dos dados do Google geralmente é mencionado no código XML usando o alias gd:. Por exemplo, o elemento que contém um número de telefone ou fax é <gd:phoneNumber>. O URL do esquema para o namespace dos dados do Google é http://schemas.google.com/g/2005.

O Google também define outros tipos: evento (uma coleção de elementos padronizados que representam um evento da agenda) e mensagens (uma coleção de elementos que representam uma mensagem de e-mail, postagem de grupo de discussão ou outra mensagem).

Alguns elementos do namespace de dados do Google são usados por vários tipos. Por exemplo, o elemento <gd:who> associa uma pessoa (descrita no <gd:who>) à entrada que contém o elemento <gd:who>. Esse elemento é usado no tipo "Evento" para especificar organizadores, participantes e assim por diante. Também é usado no tipo de Mensagem para especificar remetentes e destinatários.

Quando uma entrada em um feed da API Google Data usa um determinado tipo, ela contém um elemento <atom:category> com o atributo scheme definido como "http://schemas.google.com/g/2005#kind" e o atributo term definido com o nome do URL do esquema seguido pelo nome do tipo. Por exemplo, uma entrada de contato inclui o seguinte elemento:

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

Isso permite que os clientes determinem de maneira rápida e fácil os tipos de dados contidos na entrada, ou seja, determinem a semântica da entrada. Você pode usar o RSS em vez do Atom se preferir. Consulte o documento de referência de protocolo para ver os elementos RSS correspondentes aos elementos do Atom.

Este documento é uma referência para alguns tipos comuns e os elementos que eles contêm.

Elementos não documentados

Não incluímos informações sobre os elementos padrão da <atom:entry> em tipos que têm os significados padrão. Por exemplo, <atom:id>, <atom:published> e <atom:updated> têm os significados padrão quando aparecem em tipos.

Também não incluímos informações sobre elementos Atom padrão que não teriam sentido no contexto fornecido. Por exemplo, <atom:summary> não é usado no tipo de contato e, embora <atom:author> seja um elemento obrigatório em uma entrada (a menos que seja especificado no feed pai), ele não tem um significado útil no tipo de contato.

Como criar tipos

Pode ser difícil descobrir exatamente quais informações você precisa incluir ao criar uma entrada de um tipo específico, especialmente porque alguns elementos dos tipos contêm outros tipos.

Uma abordagem que pode ajudar é usar as bibliotecas de cliente que fornecemos, em vez de tentar criar tipos manualmente. As bibliotecas de cliente oferecem vários métodos para adicionar e alterar dados em uma entrada de um determinado tipo. Consulte a documentação da biblioteca de cliente para mais detalhes.

Extensibilidade

As informações neste documento não cobrem todas as propriedades e valores de atributo possíveis para tipos. Os serviços podem estender tipos, portanto, um serviço específico pode usar propriedades e valores não incluídos neste documento.

Convenções tipográficas

Nas tabelas deste documento, usamos as seguintes convenções para os elementos obrigatórios e opcionais:

NomedoElemento Elemento obrigatório
Nome do elemento? Elemento opcional
Nomedoelemento* Elemento opcional, várias instâncias permitidas

Os elementos e atributos são apresentados na notação XPath padrão.

Tipo de contato

Representa um contato: uma pessoa, um local (como um clube ou restaurante) ou uma organização.

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

Propriedades

Propriedade Descrição
atom:category* Categorias. As instâncias com o atributo @label são tratadas como tags. Para mais informações sobre como usar o atributo @scheme, consulte a observação no início desta seção.
atom:content Observações sobre o contato.
atom:link* Links para informações relacionadas. Especificamente, atom:link[@rel='alternate'] é vinculado a uma página HTML que descreve o contato.
atom:title Nome do contato.
gd:email* Endereços de e-mail.
gd:im* endereços IM.
gd:phoneNumber* Números de telefone e fax.
gd:postalAddress* Endereços postais.
gd:organization* Organização
gd:extendedProperty* Propriedade estendida.
gContact:groupMembershipInfo* Informações de associação ao grupo.
gd:deleted* Estado da entrada de contato excluído.

Exemplos

<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 um evento da agenda. O local do evento é representado por um tipo de contato incorporado em um elemento <gd:where> ou vinculado a ele. Os planejadores e participantes do evento são representados como tipos de contato incorporados em um elemento <gd:who> ou vinculados a ele.

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

Propriedades

Propriedade Descrição
atom:author Pessoa que criou o evento.
atom:category* Categorias. As instâncias com o atributo @label são tratadas como tags. Para mais informações sobre como usar o atributo @scheme, consulte a observação no início desta seção.
atom:content Descrição mais longa do evento.
atom:link* Links: Especificamente, atom:link[@rel='alternate'] fornece um link para uma página HTML que descreve o evento.
atom:title Título curto do evento.
gd:comments? Feed de comentários.
gd:eventStatus? Enumeração extensível documentada abaixo.
gd:recurrence? Regra de recorrência.
gd:transparency? A enumeração extensível documentada abaixo, que corresponde à propriedade TRANSP definida no RFC 2445.
gd:visibility? Enumeração extensível documentada abaixo.
gd:when* Tempo do evento. Os atributos startTime e endTime precisam ser definidos. No entanto, para eventos de dia inteiro, esses atributos são apenas datas, sem horários.
gd:when/gd:reminder* Lembretes do evento.
gd:where* O local do evento ou áreas próximas, como estacionamento. Se um elemento <gd:where> for especificado no nível do feed, mas não houver um elemento <gd:where> no nível da entrada, as entradas vão herdar o valor <gd:where> no nível do feed.
gd:who* Pessoas associadas ao evento: organizadores, participantes, palestrantes, artistas etc.
gd:who/gd:attendeeStatus? Status de aceitação.
gd:who/gd:attendeeType? Tipo de participante: required ou optional.

valores rel para gd:where

valor de rel Descrição
http://schemas.google.com/g/2005#event ou não especificado. Lugar em que o evento ocorre.
http://schemas.google.com/g/2005#event.alternate Um local secundário. Por exemplo, um site remoto com um link de videoconferência para o site principal.
http://schemas.google.com/g/2005#event.parking Estacionamentos nas proximidades.

Valores de gd:eventStatus

Valor Descrição
http://schemas.google.com/g/2005#event.canceled O evento foi cancelado.
http://schemas.google.com/g/2005#event.confirmed O evento é planejado.
http://schemas.google.com/g/2005#event.tentative O evento é apenas de maneira programada.

Valores de gd:visibilidade

Valor Descrição
http://schemas.google.com/g/2005#event.confidential Permita que alguns leitores vejam o evento.
http://schemas.google.com/g/2005#event.default Herdam o comportamento das preferências do proprietário da agenda na qual o evento é exibido.
http://schemas.google.com/g/2005#event.private Permita que poucos leitores vejam o evento.
http://schemas.google.com/g/2005#event.public Permita que a maioria dos leitores veja o evento.

gd:valores de transparência

Valor Descrição
http://schemas.google.com/g/2005#event.opaque Indica que o evento consome tempo na agenda; o horário do evento será marcado como ocupado em uma pesquisa de disponibilidade.
http://schemas.google.com/g/2005#event.transparent Indica que o evento não consome tempo algum na agenda; o horário do evento não será marcado como ocupado em uma pesquisa de disponibilidade.

Exemplos

Reunião:

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

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

Representa uma mensagem, como um e-mail, uma postagem em grupo de discussão ou um comentário.

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

Propriedades

Propriedade Descrição
atom:category* Categorias. As instâncias com o atributo @label são tratadas como tags. Para mais informações sobre como usar o atributo @scheme, consulte a observação no início desta seção. Para mais informações sobre como usar o atributo @term, consulte a tabela abaixo.
atom:content Corpo da mensagem.
atom:link* Anexos de mensagens. Mais especificamente, para fazer upload de um anexo, use <link rel="enclosure"> e coloque o conteúdo dele em uma coleção de mídia Atom.
atom:title Assunto da mensagem.
gd:geoPt? A localização geográfica de onde a mensagem foi postada.
gd:rating? É a avaliação de qualidade definida pelo aplicativo.
gd:who* Pessoas associadas a esta mensagem. A semântica exata depende do valor @rel. Veja a tabela abaixo.

Valores da categoria @term

Todas as categorias abaixo estão no esquema http://schemas.google.com/g/2005.

Termo Descrição
http://schemas.google.com/g/2005#message.chat A mensagem é uma transcrição de uma sessão de chat.
http://schemas.google.com/g/2005#message.inbox A mensagem está marcada como pertencente à Caixa de entrada.
http://schemas.google.com/g/2005#message.sent A mensagem está marcada como enviada.
http://schemas.google.com/g/2005#message.spam A mensagem é considerada spam.
http://schemas.google.com/g/2005#message.starred A mensagem está marcada com estrela.
http://schemas.google.com/g/2005#message.unread A mensagem não foi lida.

valores rel para gd:who

Propriedade Descrição
http://schemas.google.com/g/2005#message.bcc Destinatário do campo Cco da mensagem.
http://schemas.google.com/g/2005#message.cc Destinatário da mensagem de texto.
http://schemas.google.com/g/2005#message.from Remetente da mensagem (e-mail ou mensagem instantânea).
http://schemas.google.com/g/2005#message.reply-to Destinatário pretendido de uma mensagem de resposta.
http://schemas.google.com/g/2005#message.to Destinatário principal da mensagem.

Exemplo

Mensagem de e-mail:

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

Referência a elementos do namespace de dados do Google

O restante deste documento consiste em material de referência para os elementos usados pelos tipos.

Enums

Alguns elementos de extensão precisam especificar propriedades com valores que vêm de um conjunto enumerado. A forma geral dessas propriedades é:

<gd:propertyName value="propertyValue">

Se o valor da propriedade vem do namespace dos dados do Google, o formato é http://schemas.google.com/g/2005#{kind}.{value}. Por exemplo: http://schemas.google.com/g/2005#event.tentative. Se o espaço de valores for extensível, os valores também poderão estar na forma de um URI. O formato recomendado para URIs de valor estendido é {schema URI}#{value}. Por exemplo: http://www.example.com/attendeeStatus#AudioConference.

gEnumConstruct =
   attribute value { text },
   anyAttribute*

Propriedades_com_gd

Propriedades comuns usadas para todos os tipos do Google. A presença de anyAttribute e anyElement no esquema permite que todos os elementos do namespace de dados do Google que usam propriedades comuns sejam estendidos em qualquer namespace. Especificamente, é legal aninhar qualquer elemento gd ou Atom/RSS em qualquer outro elemento gd. Isso deve ser feito com cuidado e, na maioria dos casos, esse uso deve ser documentado como uma propriedade explícita do tipo de elemento gd contido.

Propriedades

Propriedade Tipo Descrição
@xml:base uri Construção XML padrão para descrever a base de URIs relativos aninhados.
@xml:lang text Idioma de strings aninhadas.

Esquema

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

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

gd:comments

Contém um feed de comentários para a entrada de inclusão (como um evento da agenda).

Propriedades

Propriedade Tipo Descrição
@rel? string Tipo de comentários contidos em. Atualmente, há uma diferença entre comentários regulares e avaliações.
gd:feedLink? feedLink Feed de comentários. Esse feed deve implementar o tipo Message.

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#regular ou não especificado Comentários frequentes (de usuários).
http://schemas.google.com/g/2005#reviews Avaliações profissionais.

Exemplos

Feed de comentários:

<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 avaliações:

<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:excluído

Um elemento de marcador que, quando presente, indica a entrada que foi excluída.

Propriedades

Nenhuma.

Esquema

start = deleted

deleted =
   element gd:deleted

gd:e-mail

Um endereço de e-mail associado à entidade que contém a entidade, que geralmente é uma entidade que representa uma pessoa ou um local.

Propriedades

Propriedade Tipo Descrição
@address xs:string Endereço de e-mail.
@label? xs:string Um valor de string simples usado para nomear este endereço de e-mail. Ele permite que as IUs mostrem um rótulo como "Trabalho", "Pessoal", "Preferido" etc.
@rel? xs:string Um valor programático que identifica o tipo de e-mail. Veja mais detalhes abaixo.
@primary? xs:boolean Quando várias extensões de e-mail aparecem em um tipo de contato, indica qual é a principal. No máximo, um e-mail pode ser principal. O valor padrão é "false".

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other Um endereço de e-mail que não é sua casa nem seu trabalho. label pode ser usado para indicar o tipo real.
http://schemas.google.com/g/2005#work

Exemplos

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

Representa uma entrada logicamente aninhada. Por exemplo, um <gd:who> que representa um contato pode ter uma entrada aninhada de um feed de contatos.

Propriedades

Propriedade Tipo Descrição
@href? xs:string Especifica o URI de entrada. Se a entrada aninhada for incorporada e não vinculada, esse atributo poderá ser omitido.
@readOnly? xs:boolean Especifica se a entrada contida é somente leitura. O valor padrão é "false".
@rel? xs:string Especifica a relação do link, permitindo que o serviço forneça vários tipos de links de entrada para uma única entidade. Tem a mesma semântica e valores permitidos que o atributo rel do elemento <atom:link>.
atom:entry? atomEntry Conteúdo da entrada.

Restrições

  • É preciso que um dos dois ou ambos @href ou <atom:entry> estejam presentes.
  • Se atom:entry não estiver presente, o cliente poderá buscar o conteúdo do URI de entrada em @href. Se atom:entry estiver presente, o conteúdo precisará ser o mesmo que seria recuperado de @href no momento em que a entrada foi gerada.
  • Quando um PUT ou um POST contém um <gd:entryLink> e o atributo @href é especificado, o valor do atributo é usado para criar um link. Se o elemento atom:entry também estiver presente, ele será ignorado. Se o atributo @href não for especificado, o elemento atom:entry será armazenado como uma entrada incorporada ou armazenado em outro feed e vinculado a ele. Talvez alguns serviços não sejam compatíveis com todas essas opções.

Exemplos

Dados de contato em <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>

Somente referência externa (entrada somente leitura):

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

gd:extendedProperty

Permite armazenar uma quantidade limitada de dados personalizados como uma propriedade auxiliar da entidade presente.

Observe que a presença de anyForeignElement permite que o feed incorpore, opcionalmente, qualquer XML válido no elemento gd:extendedProperty (mutuamente exclusivo com o atributo value).

Propriedades

Propriedade Tipo Descrição
@name xs:string Especifica o nome da propriedade expressa como um URI. Os URIs de propriedade estendidos geralmente seguem a convenção de {scheme}#{local-name}.
@value? xs:string Valor da propriedade.

Exemplo

Identificador externo de um evento da agenda:

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

XML adicional para entrada de contato

<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 um feed logicamente aninhado. Por exemplo, um feed de agenda pode ter um feed aninhado representando todos os comentários nas entradas.

Propriedades

Propriedade Tipo Descrição
@countHint? xs:unsignedInt Dicas sobre o número de entradas no feed. Dependendo da implementação, pode não ser uma contagem precisa.
@href? xs:string Especifica o URI do feed. Se o feed aninhado estiver incorporado e não estiver vinculado, esse atributo poderá ser omitido.
@readOnly? xs:boolean Especifica se o feed contido é somente leitura.
@rel? xs:string Especifica a relação de vinculação. Permite que o serviço forneça vários tipos de links de feed para uma única entidade. Tem a mesma semântica e valores permitidos que o atributo rel do elemento <atom:link>.
atom:feed? atomFeed Conteúdo do feed.

Restrições

  • É preciso que um dos dois ou ambos @href ou <atom:feed> estejam presentes.
  • Se atom:feed não estiver presente, o cliente poderá buscar o conteúdo do URI em @href. Se estiver presente, o conteúdo precisará ser o mesmo que seria recuperado de @href no momento em que o feed foi gerado.
  • Quando um PUT ou um POST contém um <gd:feedLink> e o atributo @href é especificado, o valor do atributo é usado para criar um link. Se o elemento <atom:feed> também estiver presente, ele será ignorado. Se o atributo @href não for especificado, o elemento <atom:feed> será armazenado como um feed incorporado. Talvez alguns serviços não sejam compatíveis com todas essas opções.

Exemplos

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>

Somente referência externa:

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

Feed incorporado em uma entrada do Atom que representa uma 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

Um local geográfico (latitude, longitude, elevação).

Obsoleto. Este elemento foi descontinuado. Para dados de geo-tag, use GeoRSS.

Propriedades

Propriedade Tipo Descrição
@elev? xs:float Elevação em metros. Valores negativos indicam profundidades abaixo do nível do mar médio.
@label? xs:string Um valor de string simples usado para nomear este local. Ela permite que as IUs mostrem um rótulo como "Posição atual".
@lat xs:float Latitude em graus. Valores positivos significam norte, e valores negativos significam sul. O intervalo é [-90,0, 90,0].
@lon xs:float Longitude em graus. Valores positivos significam leste, e valores negativos significam oeste. O intervalo é [-180.0, 180.0].
@time? xs:dateTime Carimbo de data/hora

Exemplos

<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

Um endereço de mensagem instantânea associado à entidade que contém a entidade.

Propriedades

Propriedade Tipo Descrição
@address xs:string Endereço de mensagem instantânea.
@label? xs:string Um valor de string simples usado para nomear este endereço de mensagem instantânea. Ele permite que as IUs mostrem um rótulo como "Trabalho", "Pessoal", "Preferido" etc.
@rel? xs:string Um valor programático que identifica o tipo de mensagem instantânea. Veja os detalhes abaixo.
@protocol? xs:string Identifica a rede do IM. O valor pode ser um dos valores padrão (mostrados abaixo) ou um URI que identifica uma rede de mensagens instantâneas proprietária.
@primary? xs:boolean Quando várias extensões de mensagens instantâneas aparecem em um tipo de contato, indica qual é a principal. No máximo, uma mensagem instantânea pode ser a principal. O valor padrão é "false".

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other Um endereço de IM que não é casa nem trabalho. label pode ser usado para indicar o tipo real.
http://schemas.google.com/g/2005#work

valores de atributos do protocolo

A tabela a seguir mostra alguns possíveis valores possíveis para o atributo @protocol.

Valor Descrição
http://schemas.google.com/g/2005#AIM Protocolo do AOL Instant Messenger
http://schemas.google.com/g/2005#MSN Protocolo do Messenger Messenger
http://schemas.google.com/g/2005#YAHOO Protocolo do 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 do Google Talk
http://schemas.google.com/g/2005#ICQ Protocolo ICQ
http://schemas.google.com/g/2005#JABBER Protocolo Jabber

Exemplos

Um endereço de IM para o Messenger 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"/>

Um endereço IM fornecido pelo usuário com um protocolo não especificado. Esse endereço é útil para fins de exibição, mas é difícil de processar de forma 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:organização

É uma organização, normalmente associada a um contato.

Propriedades

Propriedade Tipo Descrição
@label? xs:string Um valor de string simples usado para nomear esta organização. Ele permite que as IUs exibam um rótulo como "Trabalho", "Voluntário", "Sociedade profissional" etc.
@rel? xs:string Um valor programático que identifica o tipo de organização.
@primary? xs:boolean Quando várias extensões de organizações aparecem em um tipo de contato, indica qual é a principal. No máximo, uma organização pode ser a principal. O valor padrão é "false".
gd:orgName? orgName É o nome da organização.
gd:orgTitle? orgTitle É o cargo de uma pessoa na organização.

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#other Uma organização que não funciona. label pode ser usado para indicar o tipo real.
http://schemas.google.com/g/2005#work

Exemplos

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

É o nome da organização. Precisa aparecer em um elemento gd:organization.

Exemplo

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

Esquema

start = orgName

orgName =
   element gd:orgName { xs:string }

gd:orgTitle

É o cargo de uma pessoa em uma organização. Precisa aparecer em um elemento gd:organization.

Exemplo

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

Esquema

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:Evento original

Equivalente à propriedade de ID de recorrência especificada na seção 4.8.4.4 da RFC 2445. Aparece em todas as ocorrências de um evento recorrente para identificar o evento original.

Contém um elemento <gd:when> que especifica o horário de início original da instância que se tornou uma exceção.

Propriedades

Propriedade Tipo Descrição
@id xs:string É o ID do evento original.
@href xs:string O URL do feed de eventos do evento original.

Exemplo

Como especificar um 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:telefoneNúmero

Um número de telefone associado à entidade que contém a entidade. Geralmente, é uma entidade que representa uma pessoa ou um local.

Propriedades

Propriedade Tipo Descrição
@label? xs:string Um valor de string simples usado para nomear este número de telefone. Na maioria dos casos, @label não é necessário, porque @rel identifica um número de maneira exclusiva e permite que as IUs mostrem um rótulo adequado, como "Dispositivo móvel", "Casa", "Trabalho" etc. No entanto, quando uma pessoa tem (por exemplo) vários smartphones, essa propriedade pode ser usada para diferenciar isso.
@rel? xs:string Um valor programático que identifica o tipo de número de telefone. Veja mais detalhes abaixo.
@uri? xs:string Um "URI de telefone" opcional usado para representar o número de maneira formal, útil para acesso programático, como uma ponte VoIP/PSTN. Consulte RFC 3966 para mais informações sobre URIs de tel.
@primary? xs:boolean Quando várias extensões de número de telefone aparecem em um tipo de contato, indica qual é a principal. No máximo, um número de telefone pode ser principal. O valor padrão é "false".
text() xs:string Número de telefone legível; pode estar em qualquer formato de número de telefone. O espaço em branco inicial e final é insignificante. As novas linhas na string também são insignificantes e podem ser removidas ou niveladas em um único espaço.

valores de rel

Valor Descrição
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 Um tipo especial de número para o qual nenhum outro valor de rel faz sentido. Por exemplo, um dispositivo TTD. label pode ser usado para indicar o tipo real.
http://schemas.google.com/g/2005#pager
http://schemas.google.com/g/2005#work
http://schemas.google.com/g/2005#work_fax

Exemplos

Número de telefone simples inserido pelo usuário:

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

Mesmo número de telefone extraído de um diretório:

<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 com um marcador:

<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:EndereçoEndereço

Um endereço postal.

Propriedades

Propriedade Tipo Descrição
@label? xs:string Um valor de string simples usado para nomear este endereço.
@rel? xs:string Um valor programático que identifica o tipo de endereço postal. Veja mais detalhes abaixo.
@primary? xs:boolean Quando várias extensões de endereço postal aparecem em um tipo de contato, indica qual é a principal. No máximo, um endereço postal pode ser principal. O valor padrão é "false".
text() xs:string O endereço como texto. O espaço em branco inicial e final é insignificante. As novas linhas na string são significativas.

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#home
http://schemas.google.com/g/2005#other Um endereço que não é casa nem trabalho. label pode ser usado para indicar o tipo real.
http://schemas.google.com/g/2005#work

Exemplos

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

gd:rating

Representa uma classificação numérica da entidade presente, como um comentário. Cada avaliação fornece a própria escala, embora possa ser normalizada por um serviço. Por exemplo, alguns serviços podem converter todas as avaliações para uma escala de 1 a 5.

Propriedades

Propriedade Tipo Descrição
@average? xs:float Classificação média.
@max xs:int O valor máximo da escala de avaliação.
@min xs:int O valor mínimo da escala de avaliação.
@numRaters? xs:int Número de classificações consideradas ao calcular o valor médio.
@rel? xs:string Especifica o aspecto que está sendo avaliado. Se não for especificada, a classificação será geral.
@value? xs:int Valor da classificação.

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#overall ou não especificado Classificação geral. Valores mais altos significam melhores classificações.
http://schemas.google.com/g/2005#price Classificação de preço. Valores mais altos significam preços mais altos.
http://schemas.google.com/g/2005#quality Classificação de qualidade. Valores mais altos significam melhor qualidade.

Exemplos

Classificação geral de 4/5:

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

Classificação de faixa de preço mais cara:

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

Classificado por 200 usuários com uma classificação média 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:recorrência

Representa as datas e horas em que um evento recorrente ocorre.

A string que define a recorrência consiste em um conjunto de propriedades, cada uma definida no padrão iCalendar (RFC 2445).

Especificamente, a string geralmente começa com uma propriedade DTSTART que indica o horário de início da primeira instância do evento e, geralmente, uma propriedade DTEND ou DURATION para indicar quando a primeira instância termina. Em seguida, vêm as propriedades RRULE, RDATE, EXRULE e/ou EXDATE, que definem coletivamente um evento recorrente e as exceções (mas abaixo). Consulte a seção 4.8.5 da RFC 2445 para mais informações sobre essas propriedades do componente de recorrência. Por último, há um componente VvCPM, que fornece regras detalhadas de fuso horário para qualquer ID de fuso horário mencionado nas propriedades anteriores.

Os serviços do Google, como o Google Agenda, geralmente não geram propriedades EXRULE e EXDATE para representar exceções em eventos recorrentes. Em vez disso, eles geram elementos <gd:recurrenceException>. No entanto, os serviços do Google podem incluir as propriedades EXRULE e/ou EXDATE mesmo assim. Por exemplo, os usuários podem importar eventos e exceções para o Agenda. Se esses eventos importados tiverem propriedades EXRULE ou EXDATE, o Agenda fornecerá essas propriedades quando enviar um elemento <gd:recurrence>.

O uso de <gd:recurrenceException> significa que não é possível ter certeza de apenas examinar um elemento <gd:recurrence> se há exceções à descrição de recorrência. Para encontrar todas as exceções, procure os elementos <gd:recurrenceException> no feed e use os elementos <gd:originalEvent> para fazer a correspondência com elementos <gd:recurrence>.

Propriedades

Propriedade Tipo Descrição
text() xs:string Descrição da recorrência.

Exemplo

Um evento recorrente que acontece todas as manhãs, das 6h às 7h, Horário do Pacífico, de 14 a 21 de março 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:correnteexceção

Representa um evento que é uma exceção a um evento recorrente, ou seja, uma instância de um evento recorrente em que um ou mais aspectos do evento recorrente (como lista de participação, hora ou local) foram alterados.

Contém um elemento <gd:originalEvent> que especifica o evento recorrente original ao qual este evento é uma exceção.

Quando você altera uma instância de um evento recorrente, essa instância se torna uma exceção. Dependendo da mudança feita, a exceção se comporta de duas maneiras diferentes quando o evento recorrente original é alterado:

  • Se você adicionar, alterar ou remover comentários, participantes ou respostas dos participantes, a exceção permanecerá vinculada ao evento original, e as alterações feitas no evento original também serão alteradas.
  • Se você fizer outras alterações na exceção (como mudar o horário ou o local), a instância se tornará "especializada", ou seja, ela não estará mais vinculada ao evento original. Se você alterar o evento original, as exceções especializadas não serão alteradas. Veja abaixo.

Por exemplo, digamos que você tenha uma reunião às terças e quintas às 14h. Se você alterar a lista de participação para a reunião desta quinta-feira (mas não para a reunião programada regularmente), ela se tornará uma exceção. Se você mudar o horário da reunião de quinta-feira (e não da reunião programada regularmente), ela será especializada.

Independentemente de uma exceção ser especializada ou não, se você fizer algo que exclui a instância da qual a exceção foi derivada, a exceção será excluída. Alterar o dia ou a hora de um evento recorrente exclui todas as instâncias e cria novas.

Por exemplo, depois de se especializar na reunião de quinta-feira, digamos que você mude a reunião recorrente para segunda, quarta e sexta-feira. Essa mudança exclui todas as ocorrências recorrentes da reunião de terça/quinta, incluindo a especializada.

Se uma instância específica de um evento recorrente for excluída, ela vai aparecer como uma <gd:recurrenceException> contendo uma <gd:entryLink> que tem o <gd:eventStatus> definido como "http://schemas.google.com/g/2005#event.canceled". Para mais informações sobre eventos cancelados, consulte a RFC 2445.

Propriedades

Propriedade Tipo Descrição
@specialized xs:boolean Indica se a exceção é especializada ou não.
gd:entryLink entryLink Uma entrada de evento que fornece detalhes sobre a exceção.
gd:originalEvent originalEvent O evento recorrente original ao qual isso é uma exceção.

Exemplo

Exceção para eventos recorrentes (com algumas partes substituídas por breves identificadores em itálico para maior clareza):

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

Usado com mais frequência em: <gd:when>

Um intervalo de tempo, indicando quanto tempo antes da transmissão do atributo @startTime ou @dueTime da entidade que contém um lembrete deve ser emitido. Você também pode especificar um horário absoluto para a emissão de um lembrete. Especifica também um método de notificação, indicando qual mídia o sistema deve usar para lembrar o usuário.

Propriedades

Propriedade Tipo Descrição
@absoluteTime? xs:dateTime Horário absoluto em que o lembrete será emitido. Isso geralmente é usado quando um usuário usa o recurso "adiar" para atrasar um lembrete anterior. Se o fuso horário não for especificado, o horário local do observador será presumido.
@method? xs:string O método de notificação que o lembrete deve usar. Pode ter qualquer um dos seguintes valores: alert (faz com que um alerta seja exibido quando um usuário vê a agenda em um navegador), email (envia uma mensagem de e-mail ao usuário) ou sms (envia uma mensagem de texto SMS ao usuário).
@days? xs:unsignedInt Período antes de gd:when/@startTime em que um lembrete será emitido. Se o horário de destino da entidade pai for uma data em vez de um horário específico, esses atributos serão relativos à meia-noite (00:00) dessa data.
@hours? xs:unsignedInt
@minutes? xs:unsignedInt

Ao criar ou editar uma entrada <gd:when>, use as seguintes convenções para alcançar resultados específicos:

  • Para instruir o serviço a usar os lembretes padrão do usuário, inclua um elemento <gd:reminder> sem atributos. Se você especificar uma duração, mas nenhum atributo method, o serviço usará os métodos de notificação padrão do usuário com a duração especificada.
  • Para instruir o serviço a não emitir lembretes (ou remover lembretes atuais) ao atualizar um evento, não inclua elementos <gd:reminder>.

Restrições

  • É possível especificar no máximo @days, @hours, @minutes ou @absoluteTime. Para especificar uma duração mista, converta para a unidade mais precisa. Por exemplo, para especificar 1 hora e 30 minutos, use @minutes="90".
  • Não é possível usar valores negativos para os atributos. Portanto, se você quiser que um lembrete seja exibido após o horário de início, use @absoluteTime.
  • Um determinado evento não pode ter mais de cinco lembretes associados a ele.
  • Ao adicionar um lembrete a um evento, você precisa especificar uma duração caso especifique os métodos alert, email ou sms.

Exemplos

Um lembrete de 15 minutos para uma reunião:

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

Mesma reunião que você disse acima, mas foi adiado por 10 minutos após o lembrete às 16h45:

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

Um identificador de recurso opaco, diferente de atom:id, porque não precisa ser um URI válido. Alguns serviços fornecem um identificador separado a ser usado ao construir solicitações subsequentes. O uso exato é específico do serviço.

Exemplo

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

Esquema

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:quando

Representa um período de tempo ou um instante.

Propriedades

Propriedade Tipo Descrição
@endTime? xs:dateTime ou xs:date Descreve quando o evento termina. Se o fuso horário não for especificado, o fuso local do observador será usado.
@startTime xs:dateTime ou xs:date Descreve quando o evento começa ou, no caso de eventos de duração zero, quando ocorre. Se o fuso horário não for especificado, o fuso local do observador será usado.
@valueString? xs:string Um valor de string simples que pode ser usado como uma representação desse período.

Restrições

  • Não é possível misturar xs:dateTime com xs:date em startTime/endTime.
  • Se endTime não for especificado, o evento será considerado um evento instantâneo (se @startTime incluir um horário) ou um evento de um dia (se @startTime for apenas uma data).

Exemplos

Um evento de um dia:

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

Representação alternativa de um evento de um dia:

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

Um evento de dois dias (em 6 e 7 de junho) com uma descrição de string:

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

Uma reunião de uma hora:

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

Um evento de duração zero:

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

Um lugar, como um local de evento, associado à entidade que o contém. O tipo de associação é determinado pelo atributo rel. Os detalhes do local estão contidos em uma entrada de contato incorporada ou vinculada.

Um elemento <gd:where> é mais geral do que um elemento <gd:geoPt>. O primeiro identifica um local usando uma descrição de texto e/ou uma entrada de contato e o segundo identifica um local usando uma localização geográfica específica.

Propriedades

Propriedade Tipo Descrição
@label? xs:string Especifica um rótulo legível pelo usuário para diferenciar esse local de outros.
@rel? xs:string Especifica a relação entre a entidade e o local. Os valores possíveis (veja abaixo) são definidos por outros elementos. Por exemplo, <gd:when> define http://schemas.google.com/g/2005#event.
@valueString? xs:string Um valor de string simples que pode ser usado como uma representação desse local.
gd:entryLink? entryLink Entrada que representa os detalhes do local. Essa entrada precisa implementar o tipo Contact.

valores de rel

Valor Descrição
http://schemas.google.com/g/2005#event ou não especificado Lugar onde ocorre o evento incluído.
http://schemas.google.com/g/2005#event.alternate Um local secundário. Por exemplo, um site remoto com um link de videoconferência para o site principal.
http://schemas.google.com/g/2005#event.parking Um estacionamento próximo.

Exemplos

Local do evento:

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

Local do evento mais complicado:

<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 com vários locais:

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

Uma pessoa associada à entidade que contém a entidade. O tipo de associação é determinado pelo atributo rel. Os detalhes sobre a pessoa estão em uma entrada de contato incorporada ou vinculada.

O elemento <gd:who> pode ser usado para especificar remetentes e destinatários de e-mails, organizadores de eventos da agenda e assim por diante.

Propriedades

Propriedade Tipo Descrição
@email? xs:string Endereço de e-mail. Essa propriedade normalmente é usada quando <gd:entryLink> não é especificado. O endereço precisa estar em conformidade com o RFC 2822, seção 3.4.1.
@rel? xs:string Especifica a relação entre a entidade e a pessoa contida. Veja abaixo os possíveis valores.
@valueString? xs:string Um valor de string simples que pode ser usado como uma representação dessa pessoa.
gd:attendeeStatus? gEnumConstruct Status do convidado do evento. Enumeração extensível documentada abaixo.
gd:attendeeType? gEnumConstruct Tipo de participante do evento. Enumeração extensível documentada abaixo.
gd:entryLink? entryLink Entrada que representa os detalhes da pessoa. Essa entrada precisa implementar o tipo Contact. Em muitos casos, essa entrada virá de um feed de contatos.

valores de rel

Os valores válidos para @rel dependem do tipo em que o elemento <gd:who> aparece.

Valor Tipo Descrição
http://schemas.google.com/g/2005#event.attendee Evento Um participante geral da reunião/evento.
http://schemas.google.com/g/2005#event.organizer Evento Organizador do evento. Um organizador não é necessariamente um convidado.
http://schemas.google.com/g/2005#event.performer Evento Artista. Semelhante a http://schemas.google.com/g/2005#event.speaker, mas com mais ênfase na arte do que na fala.
http://schemas.google.com/g/2005#event.speaker Evento Palestrante.
http://schemas.google.com/g/2005#message.bcc Mensagem Destinatário do campo Cco da mensagem.
http://schemas.google.com/g/2005#message.cc Mensagem Destinatário da mensagem de texto.
http://schemas.google.com/g/2005#message.from Mensagem Remetente da mensagem (e-mail ou mensagem instantânea).
http://schemas.google.com/g/2005#message.reply-to Mensagem Destinatário pretendido de uma mensagem de resposta.
http://schemas.google.com/g/2005#message.to Mensagem Destinatário principal da mensagem.

Valores de gd:attendeeType

Valor Descrição
http://schemas.google.com/g/2005#event.optional Participante opcional.
http://schemas.google.com/g/2005#event.required Participante obrigatório.

Valores de gd:attendeeStatus

Valor Descrição
http://schemas.google.com/g/2005#event.accepted O convidado aceitou.
http://schemas.google.com/g/2005#event.declined O convidado recusou.
http://schemas.google.com/g/2005#event.invited O convite foi enviado, mas a pessoa não aceitou.
http://schemas.google.com/g/2005#event.tentative O convidado aceitou temporariamente.

Exemplos

Destinatários de e-mail:

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

Participante da reunião:

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

Voltar ao início