Esta página foi traduzida pela API Cloud Translation.

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
gdCommonProperties (em inglês)
gd:comentários
gd:excluído
gd:e-mail
gd:entradaLink
gd:extendedProperty
gd:feedLink (link em inglês)
gd:geoPt (link em inglês)
gd:im (link em inglês)
gd:organização
gd:orgName (link em inglês)
gd:orgTitle (link em inglês)
gd:originalEvent
gd:telefoneNúmero
gd:postalAddress (link em inglês)
gd:rating (em inglês)
gd:corrência
gd:renewalException
gd:lembrete
gd:quando
gd:onde
gd:quem

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