本頁面由 Cloud Translation API 翻譯而成。

常見元素：「種類」

簡介

使用 Google Data API 的服務，往往能為一組特定項目提供一致的資訊。

舉例來說，各種 Google Data API (或稱「GData」) 服務可能會為個人或機構提供聯絡資訊，讓所有這類服務都使用同一組聯絡資訊元素是很合理的做法。

構成聯絡人的元素集合就稱為「種類」。「聯絡人」種類中的某些元素是一般的 Atom 或 RSS 元素，而其他元素則是由 Google 於名為「Google Data 命名空間」的命名空間中定義。按照慣例，Google 資料命名空間通常會以 gd: 別名，在 XML 程式碼中使用，例如，包含電話或傳真號碼的元素是 <gd:phoneNumber>。Google Data 命名空間的結構定義網址是 http://schemas.google.com/g/2005。

Google 也定義了其他種類：活動 (由一個代表標準日曆活動的標準化元素集合) 和「訊息」(代表電子郵件、討論群組訊息或其他訊息的元素集合)。

Google 資料命名空間的部分元素會用於各種類型。例如，<gd:who> 元素會將使用者 (如 <gd:who> 中所述) 與包含 <gd:who> 元素的項目建立關聯。這個事件可在活動種類中指定主辦人、參與者等等。且在「郵件」種類中使用，用於指定寄件者與收件者。

如果 Google Data API 資訊提供中的項目使用指定種類，該元素會包含 <atom:category> 元素，並將 scheme 屬性設為 "http://schemas.google.com/g/2005#kind"，並將 term 屬性設定為結構定義網址的名稱，後面接著種類名稱。舉例來說，「聯絡人」項目包含下列元素：

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

這樣一來，用戶端就能迅速輕鬆地判斷項目包含的資料類型，也就是判斷項目的語意。(您也可以選擇使用 RSS，而不是 Atom；請參閱與 Atom 元素對應的 RSS 元素適用的通訊協定參考資料文件)。

本文件提供了一些常見種類及其包含的參考資料。

未記錄的元素

即使 <atom:entry> 的標準元素具有標準意義，我們並不會納入相關資訊。舉例來說，<atom:id>、<atom:published> 和 <atom:updated> 都是採用種類時的標準。

我們也未在特定內容中提供無意義的標準 Atom 元素相關資訊；舉例來說，<atom:summary> 並未用於 Contact 種類，而且 <atom:author> 是項目中必要的元素 (除非已在上層動態饋給中指定該元素)，但對於「聯絡人」種類並沒有什麼意義。

建立種類

要建立特定類型的項目可能並不容易，特別是某些種類的元素包含其他種類。

建議您使用我們提供的用戶端程式庫，而不要手動建立種類。用戶端程式庫會提供許多方法來新增和變更資料項目的方法；詳情請參閱用戶端程式庫說明文件。

擴充性

本文件中的資訊並未涵蓋所有可能的屬性種類和屬性值。服務可能會擴充種類，因此特定服務可以使用本文件未包含的屬性和值。

字體排放慣例

在本文件的表格中，我們針對必要及選用元素採用下列慣例：

元素名稱	必要元素
<元素名稱>？	選用元素
<元素名稱>*	選用元素，允許多個執行個體

元素和屬性會以標準 XPath 標記法呈現。

聯絡種類

代表聯絡人：一個人、一個場地 (例如俱樂部或餐廳)，或是機構。

類別元素：<atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#contact"/>

屬性

屬性	說明
`atom:category`*	類別：系統會將 `@label` 屬性的執行個體視為標記。如要進一步瞭解如何使用 `@scheme` 屬性，請參閱本節開頭的注意事項。
`atom:content`	有關聯絡人的附註。
`atom:link`*	相關資訊的連結。具體來說，`atom:link[@rel='alternate']` 會連結至描述聯絡人的 HTML 網頁。
`atom:title`	聯絡人名稱。
`gd:email`*	電子郵件地址。
`gd:im`*	IM 位址的地址。
`gd:phoneNumber`*	電話和傳真號碼。
`gd:postalAddress`*	郵寄地址。
`gd:organization`*	彙整作品
`gd:extendedProperty`*	擴充屬性。
`gContact:groupMembershipInfo`*	群組成員資訊。
`gd:deleted`*	已刪除聯絡人狀態。

範例

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

事件種類

代表日曆活動。活動地點是以嵌入 (或連結至) <gd:where> 元素中的聯絡種類表示，活動規劃人員和參與者會以內嵌 (或連結) <gd:who> 元素中的內嵌種類表示。

類別元素：<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#event"/>

屬性

屬性	說明
`atom:author`	建立這項活動的使用者。
`atom:category`*	類別：系統會將 `@label` 屬性的執行個體視為標記。如要進一步瞭解如何使用 `@scheme` 屬性，請參閱本節開頭的注意事項。
`atom:content`	活動的詳細說明。
`atom:link`*	連結。具體來說，`atom:link[@rel='alternate']` 提供可描述活動的 HTML 網頁連結。
`atom:title`	事件的簡短標題。
`gd:comments`？	留言資訊提供。
`gd:eventStatus`？	可擴充的列舉項目如下所述。
`gd:recurrence`？	重複規則。
`gd:transparency`？	可擴充的列舉項目如下，對應於 RFC 2445 中定義的 TRANSP 屬性。
`gd:visibility`？	可擴充的列舉項目如下所述。
`gd:when`*	事件時間。`startTime` 和 `endTime` 屬性都必須設定，不過對於全天活動而言，這些屬性只是日期，不含時間。
`gd:when/gd:reminder`*	活動提醒。
`gd:where`*	活動地點或附近必需品，例如停車場。如果動態饋給層級指定了 `<gd:where>` 元素，但項目層級沒有 `<gd:where>` 元素，則這些項目將沿用動態饋給層級的 `<gd:where>` 值。
`gd:who`*	與活動相關的人：發起人、與會者、講者、表演者等
`gd:who/gd:attendeeStatus`？	接受狀態。
`gd:who/gd:attendeeType`？	參與者類型：`required` 或 `optional`。

gd:where 的 rel 值

rel 值	說明
`http://schemas.google.com/g/2005#event` 或未指定。	活動地點。
`http://schemas.google.com/g/2005#event.alternate`	次要位置。例如，含有視訊會議連結的遠端網站。
`http://schemas.google.com/g/2005#event.parking`	附近停車場。

gd:eventStatus 值

值	說明
`http://schemas.google.com/g/2005#event.canceled`	這個活動已取消。
`http://schemas.google.com/g/2005#event.confirmed`	規劃活動。
`http://schemas.google.com/g/2005#event.tentative`	此活動只是暫時性的。

gd:visibility 值

值	說明
`http://schemas.google.com/g/2005#event.confidential`	允許部分讀者查看活動。
`http://schemas.google.com/g/2005#event.default`	從活動所屬日曆的偏好設定中沿用原本的行為。
`http://schemas.google.com/g/2005#event.private`	允許最小的讀者查看活動。
`http://schemas.google.com/g/2005#event.public`	允許多數讀者查看活動。

gd:transparency 值

值	說明
`http://schemas.google.com/g/2005#event.opaque`	表示日曆上的活動時間；在有空/忙碌搜尋中，活動時間會標示為忙碌。
`http://schemas.google.com/g/2005#event.transparent`	表示活動沒有安排時間；有空/忙碌搜尋時不會將活動時間標示為忙碌。

範例

會議：

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

線上活動：

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

訊息種類

代表訊息，例如電子郵件、討論群組訊息或留言。

類別元素：<atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/g/2005#message"/>

屬性

屬性	說明
`atom:category`*	類別：系統會將 `@label` 屬性的執行個體視為標記。如要進一步瞭解如何使用 `@scheme` 屬性，請參閱本節開頭的注意事項。如要進一步瞭解如何使用 `@term` 屬性，請參閱下表。
`atom:content`	郵件內文。
`atom:link`*	郵件附件。具體來說，如要上傳附件，請使用 `<link rel="enclosure">` 並將附件內容放入 Atom 媒體集合中。
`atom:title`	郵件主旨。
`gd:geoPt`？	訊息的地理位置。
`gd:rating`？	品質評分 (由應用程式定義)。
`gd:who`*	與這則訊息相關的使用者。確切的語意則取決於 `@rel` 值。請參閱下表。

類別 @term 值

下列所有類別均屬於 http://schemas.google.com/g/2005 架構。

字詞	說明
`http://schemas.google.com/g/2005#message.chat`	這則訊息是即時通訊工作階段的轉錄稿。
`http://schemas.google.com/g/2005#message.inbox`	郵件會歸入收件匣中。
`http://schemas.google.com/g/2005#message.sent`	郵件會標示為已送出。
`http://schemas.google.com/g/2005#message.spam`	郵件為垃圾郵件。
`http://schemas.google.com/g/2005#message.starred`	郵件已加上星號。
`http://schemas.google.com/g/2005#message.unread`	郵件為未讀取。

gd:who 的 rel 值

屬性	說明
`http://schemas.google.com/g/2005#message.bcc`	郵件的密件副本收件者。
`http://schemas.google.com/g/2005#message.cc`	郵件副本收件者。
`http://schemas.google.com/g/2005#message.from`	郵件 (電子郵件或即時訊息) 寄件者。
`http://schemas.google.com/g/2005#message.reply-to`	回覆郵件的預期收件者。
`http://schemas.google.com/g/2005#message.to`	郵件的主要收件者。

範例

電子郵件內文：

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

Google Data 命名空間元素參考資料

本文件的其餘部分，則包含種類使用的元素的參考資料。

列舉
gdCommonProperties
gd:comments
gd:deleted
gd:email
gd:entryLink
gd:extendedProperty
gd:feedLink
gd:geoPt
gd:im
gd:organization
gd:orgName
gd:orgTitle
gd:originalEvent
gd:phoneNumber
gd:postalAddress
gd:rating
gd:重複
gd:recurrenceException
gd:提醒
gd:when
gd:where
gd:who

列舉

部分擴充功能元素需要指定其值來自列舉的集合。這類屬性的一般形式如下：

<gd:propertyName value="propertyValue">

如果屬性值來自 Google 資料命名空間，則採用 http://schemas.google.com/g/2005#{Kind}.{value} 的格式。例如：http://schemas.google.com/g/2005#event.tentative。如果值空間可延伸，其值也可能是 URI 格式。擴充值 URI 的建議格式為 {結構定義 URI}#{value}。例如：http://www.example.com/attendeeStatus#AudioConference。

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

適用於所有 Google 類型的常見屬性。請注意，結構定義中存在 anyAttribute 和 anyElement 時，所有使用通用屬性的 Google Data 命名空間元素都能進一步在所有命名空間中加以擴充。具體來說，將任何 gd 元素或任何 Atom/RSS 元素建立於其他 gd 元素的巢狀結構，是屬於合法行為。您必須審慎確認，在大部分情況下，應該將這類用途記錄在內含 gd 元素類型的明確屬性中。

屬性

屬性	類型	說明
`@xml:base`	`uri`	用於說明巢狀相對 URI 基礎的標準 XML 結構。
`@xml:lang`	`text`	巢狀字串的語言。

結構定義

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

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

gd:comments

包含封閉項目 (例如日曆活動) 的評論資訊提供。

屬性

屬性	類型	說明
`@rel`？	`string`	包含的留言類型。目前區分一般評論和評論。
`gd:feedLink`？	`feedLink`	留言資訊提供。這個動態饋給應實作 Message 種類。

rel 值

值	說明
`http://schemas.google.com/g/2005#regular` 或未指定	一般使用者留言 (來自使用者)。
`http://schemas.google.com/g/2005#reviews`	專業評論：

範例

留言資訊提供：

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

評論資訊提供：

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

結構定義

start = comments

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

gd:deleted

標記元素存在時，表示包含的項目會遭到刪除。

屬性

無。

結構定義

start = deleted

deleted =
   element gd:deleted

gd:email

與所屬實體相關的電子郵件地址，通常是代表個人或地點的實體。

屬性

屬性	類型	說明
`@address`	`xs:string`	電子郵件地址。
`@label`？	`xs:string`	用來為這個電子郵件地址命名的簡單字串值。讓使用者介面可以顯示「工作」、「個人」、「偏好」等標籤。
`@rel`？	`xs:string`	用來識別電子郵件類型的程式輔助值；詳情請參閱下方說明。
`@primary`？	`xs:boolean`	如果某個聯絡人同時顯示多個電子郵件額外資訊，請指明哪個電子郵件額外資訊是主要的。最多只能有一個電子郵件地址。預設值為 `"false"`。

rel 值

值	說明
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	不屬於住家或公司的電子郵件地址。`label` 可用來表示實際類型。
`http://schemas.google.com/g/2005#work`

範例

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

結構定義

start = email

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

gd:entryLink

代表邏輯巢狀項目。舉例來說，代表聯絡人的 <gd:who> 可能包含來自聯絡人資訊提供的巢狀項目。

屬性

屬性	類型	說明
`@href`？	`xs:string`	指定項目 URI。如果嵌入的巢狀項目未經過連結，系統可能會省略這項屬性。
`@readOnly`？	`xs:boolean`	指定所含項目是否為唯讀項目。預設值為 `"false"`。
`@rel`？	`xs:string`	指定連結關係；允許服務為單一實體提供多種輸入連結。具有相同的語意和允許的值，與 `<atom:link>` 元素的 `rel` 屬性相同。
`atom:entry`？	`atomEntry`	項目內容。

限制

@href 或 <atom:entry> 必須同時存在，或兩者皆有。
如果沒有 atom:entry，用戶端可以從 @href 的項目 URI 中擷取內容。如果 atom:entry 存在，其內容必須與擷取項目時從 @href 擷取的內容相同。
當 PUT 或 POST 包含 <gd:entryLink> 且指定了 @href 屬性時，系統會使用屬性值來建立連結；如果同時有 atom:entry 元素，則系統會忽略該值。如果未指定 @href 屬性，系統會將 atom:entry 元素儲存為內嵌項目，或儲存在其他動態饋給中並建立連結。提醒您，部分服務可能不支援部分選項。

範例

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

僅限外部參考資料 (唯讀項目)：

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

結構定義

start = entryLink

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

gd:extendedProperty

可讓您將有限的自訂資料儲存為封閉式實體的輔助屬性。

請注意，使用 anyForeignElement 時，動態饋給可選擇性地將任何有效的 XML 嵌入 gd:extendedProperty 元素中 (與 value 屬性互斥)。

屬性

屬性	類型	說明
`@name`	`xs:string`	指定以 URI 表示的屬性名稱。擴充屬性 URI 通常會遵循「{scheme}」#{local-name}慣例。
`@value`？	`xs:string`	屬性值。

範例

日曆活動的外部 ID：

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

用於聯絡人項目的額外 XML 檔案

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

結構定義

start = extendedProperty

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

gd:feedLink

代表邏輯巢狀資訊提供。例如，日曆資訊提供可以有一個巢狀資訊提供，代表項目的所有評論。

屬性

屬性	類型	說明
`@countHint`？	`xs:unsignedInt`	代表資訊提供中的項目數量。視導入方式而定，可能不是精確的計數。
`@href`？	`xs:string`	指定資訊提供 URI。如果內嵌的動態消息未嵌入，則系統可能不會略過這項屬性。
`@readOnly`？	`xs:boolean`	指定內含的動態饋給是否處於唯讀狀態。
`@rel`？	`xs:string`	指定連結關係；允許服務為單一實體提供多種資訊提供連結。具有相同的語意和允許的值，與 `<atom:link>` 元素的 `rel` 屬性相同。
`atom:feed`？	`atomFeed`	動態饋給的內容。

限制

@href 或 <atom:feed> 必須同時存在，或兩者皆有。
如果沒有 atom:feed，用戶端可以從 @href 的 URI 中擷取內容。如果存在的話，內容必須與擷取動態饋給時從 @href 擷取的內容相同。
當 PUT 或 POST 包含 <gd:feedLink> 且指定了 @href 屬性時，系統會使用屬性值來建立連結；如果 <atom:feed> 元素也存在，系統會忽略該值。如果未指定 @href 屬性，系統會將 <atom:feed> 元素儲存為內嵌動態饋給。提醒您，部分服務可能不支援部分選項。

範例

網誌：

<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:feedLink href="http://example.com/Jo/posts/MyFirstPost/comments"
            countHint="10"/>

代表清單的 Atom 項目內內嵌的資訊提供：

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

結構定義

start = feedLink

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

gd:geoPt

地理位置 (緯度、經度、海拔高度)。

已淘汰。這個元素已淘汰。如需地理標記資料，請改用 GeoRSS。

屬性

屬性	類型	說明
`@elev`？	`xs:float`	海拔高度 (單位為公尺)。負值表示深度低於平均海平面。
`@label`？	`xs:string`	用於為這個位置命名的簡單字串值。可讓 UI 顯示「目前位置」等標籤。
`@lat`	`xs:float`	緯度度數。正值表示北方，負值代表南方。範圍為 [-90.0, 90.0]。
`@lon`	`xs:float`	經度度數。正值表示東方，負值代表西方。範圍為 [-180.0, 180.0]。
`@time`？	`xs:dateTime`	時間戳記。

範例

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

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

結構定義

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

與所屬實體相關聯的即時通訊地址。

屬性

屬性	類型	說明
`@address`	`xs:string`	IM 位址。
`@label`？	`xs:string`	用於為這個 IM 位址命名的簡單字串值。讓使用者介面可以顯示「工作」、「個人」、「偏好」等標籤。
`@rel`？	`xs:string`	識別 IM 類型的程式輔助值；詳情請參閱下方說明。
`@protocol`？	`xs:string`	用於識別 IM 網路。這個值可以是標準值 (如下方所示) 或 URI 來識別專屬 IM 網路。
`@primary`？	`xs:boolean`	聯絡人種類出現多個 IM 擴充功能時，請指定哪一個類型的主要電話號碼。最多只能有一個 IM 做為主要 IM。預設值為 `"false"`。

rel 值

值	說明
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	可以是住家或公司專用的 IM 地址。`label` 可用來表示實際類型。
`http://schemas.google.com/g/2005#work`

通訊協定屬性值

下表列出 @protocol 屬性的可能值。

值	說明
`http://schemas.google.com/g/2005#AIM`	AOL 即時 Messenger 通訊協定
`http://schemas.google.com/g/2005#MSN`	MSN Messenger 通訊協定
`http://schemas.google.com/g/2005#YAHOO`	Yahoo Messenger 通訊協定
`http://schemas.google.com/g/2005#SKYPE`	Skype 通訊協定
`http://schemas.google.com/g/2005#QQ`	QQ 通訊協定
`http://schemas.google.com/g/2005#GOOGLE_TALK`	Google Talk 通訊協定
`http://schemas.google.com/g/2005#ICQ`	ICQ 通訊協定
`http://schemas.google.com/g/2005#JABBER`	Jabber 通訊協定

範例

MSN Messenger 的 IM 位址：

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

使用者提供的 IM 位址和未指定的通訊協定。這類位址有助於顯示，但難以透過程式處理。

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

結構定義

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

機構，通常與聯絡人相關聯。

屬性

屬性	類型	說明
`@label`？	`xs:string`	用於為這個機構命名的簡單字串值。讓使用者介面可以顯示「工作」、「志工」、「專業協會」等標籤。
`@rel`？	`xs:string`	用來識別機構類型的程式輔助值。
`@primary`？	`xs:boolean`	如果有聯絡人類別出現在多個聯絡人清單中，請指定哪一個機構的主要額外資訊。主要機構可能只有一個機構。預設值為 `"false"`。
`gd:orgName`？	`orgName`	機構名稱。
`gd:orgTitle`？	`orgTitle`	機構內使用者的名稱。

rel 值

值	說明
`http://schemas.google.com/g/2005#other`	機構無效。`label` 可用來表示實際類型。
`http://schemas.google.com/g/2005#work`

範例

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

結構定義

start = organzation

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

gd:orgName

機構名稱。必須出現在 gd:organization 元素中。

範例

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

結構定義

start = orgName

orgName =
   element gd:orgName { xs:string }

gd:orgTitle

機構內成員的名稱。必須出現在 gd:organization 元素中。

範例

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

結構定義

start = orgTitle

orgTitle =
   element gd:orgTitle { xs:string }

gd:originalEvent

等同於 RFC 2445 第 4.8.4.4 節中指定的週期性 ID 屬性。顯示在週期性活動的每個例項中，以識別原始事件。

包含 <gd:when> 元素，指定已成為例外狀況的執行個體原始開始時間。

屬性

屬性	類型	說明
`@id`	`xs:string`	原始事件的事件 ID。
`@href`	`xs:string`	原始事件的事件資訊提供網址。

範例

指定原始事件：

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

結構定義

start = originalEvent

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

gd:phoneNumber

與內含實體 (通常是代表某人或位置的實體) 相關聯的電話號碼。

屬性

屬性	類型	說明
`@label`？	`xs:string`	用於為這個電話號碼命名的簡單字串值。在大多數情況下，`@label` 並非必要，因為 `@rel` 可明確識別一組數字，並讓 UI 顯示適當的標籤，例如「行動裝置」、「住家」、「公司」等。不過，如果一人使用 (例如) 多支手機，就可以利用這個屬性來區分它們。
`@rel`？	`xs:string`	用來識別電話號碼類型的程式輔助值；詳情請參閱下方說明。
`@uri`？	`xs:string`	選用的「tel URI」，以正式方式呈現數字，在程式輔助存取 (如 VoIP/PSTN 橋接器) 方面相當實用。如要進一步瞭解 tel URI，請參閱 RFC 3966。
`@primary`？	`xs:boolean`	聯絡人種類出現多則來電額外資訊時，請指定哪一種主要額外資訊。最多只能有一個電話號碼做為主要電話號碼。預設值為 `"false"`。
`text()`	`xs:string`	使用者可理解的電話號碼，可以是任何電話號碼格式。開頭與結尾的空白字元並不重要。字串中的換行符號也不具意義，因此可以移除或分割成單一空格。

rel 值

值	說明
`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`	沒有其他 `rel` 值可解讀的特殊類型類型。例如 TTY 裝置。`label` 可用來表示實際類型。
`http://schemas.google.com/g/2005#pager`
`http://schemas.google.com/g/2005#work`
`http://schemas.google.com/g/2005#work_fax`

範例

使用者輸入的簡單電話號碼：

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

目錄上有相同的電話號碼：

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

含標籤的數字：

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

結構定義

start = phoneNumber

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

gd:postalAddress

一個郵寄地址。

屬性

屬性	類型	說明
`@label`？	`xs:string`	用來為這個地址命名的簡單字串值。
`@rel`？	`xs:string`	識別郵政地址類型的程式輔助值；詳情請參閱下方說明。
`@primary`？	`xs:boolean`	聯絡人種類出現多個郵政地址額外資訊時，請指定主要地址。最多只能有一個主要地址。預設值為 `"false"`。
`text()`	`xs:string`	以文字形式輸入地址。開頭與結尾的空白字元並不重要。字串中的換行符號非常重要。

rel 值

值	說明
`http://schemas.google.com/g/2005#home`
`http://schemas.google.com/g/2005#other`	這兩個地址不是住家或公司的地址。`label` 可用來表示實際類型。
`http://schemas.google.com/g/2005#work`

範例

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

結構定義

start = postalAddress

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

gd:rating

代表封閉實體的數值評分，例如評論。雖然每個評分都有專屬的分級標準，但可能因為服務而經過標準化處理；舉例來說，某些服務可能會將所有評分轉換為 1 到 5 的等比例計。

屬性

屬性	類型	說明
`@average`？	`xs:float`	平均評分。
`@max`	`xs:int`	分級量表的最大值。
`@min`	`xs:int`	分級量表的最小值。
`@numRaters`？	`xs:int`	計算平均值時考量的評分次數。
`@rel`？	`xs:string`	指定要評分的方面。如未指定，則評分為整體評分。
`@value`？	`xs:int`	評分值。

rel 值

值	說明
`http://schemas.google.com/g/2005#overall` 或未指定	整體評分。值越大，評分越高。
`http://schemas.google.com/g/2005#price`	價格評分。值越大表示價格越高。
`http://schemas.google.com/g/2005#quality`	品質評分。值越大代表品質越高。

範例

4/5 整體評分：

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

價格最高的價格範圍：

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

由 200 名用者評分，平均評分為 4.65（評分 5 分）：

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

結構定義

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:週期性

代表進行週期性活動的日期與時間。

定義重複欄位的字串由一組屬性組成，每個屬性都是在 iCalendar 標準 (RFC 2445) 中定義的。

具體來說，字串通常會以表示第一個事件開始時間的 DTSTART 屬性開始，且通常為表示第一個執行個體的結束時間的 DTEND 屬性或 DURATION 屬性。接下來是 RRULE、RDATE、EXRULE 和/或 EXDATE 屬性，它們共同定義週期性活動及其例外 (請見下方說明)。（有為為瞭解為為重複分量特性的更多信息，見 RFC 2445 的第 4.8.5 部分。）最後一個是 VGMT 元件，提供上述屬性中提及的任何時區 ID 的詳細時區規則。

Google 日曆等 Google 服務通常不會產生週期性活動的 EXRULE 和 EXDATE 屬性，而是產生 <gd:recurrenceException> 元素。不過，Google 服務可能仍含 EXRULE 和/或 EXDATE 屬性。舉例來說，使用者可以將活動和例外狀況匯入 Google 日曆；如果匯入的事件包含 EXRULE 或 EXDATE 屬性，則 Google 日曆傳送 <gd:recurrence> 元素時會提供這些屬性。

請注意，使用 <gd:recurrenceException> 代表您僅不確定檢查 <gd:recurrence> 元素是否有重複說明。為確保您能找到所有例外狀況，請在動態饋給中尋找 <gd:recurrenceException> 元素，並使用其 <gd:originalEvent> 元素來比對 <gd:recurrence> 元素。

屬性

屬性	類型	說明
`text()`	`xs:string`	週期說明。

範例

每天早上 6:00 至 7:00 進行的週期性活性，太平洋時間，2006 年 3 月 14 日至 3 月 21 日：

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

結構定義

start = recurrence

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

gd:recurrenceException

表示週期性活動的例外情況，也就是重複活動的其中一或多個活動 (例如出席狀況清單、時間或地點) 已改變。

包含 <gd:originalEvent> 元素，用來指定此事件為例外狀況的原始週期性事件。

當您變更週期性活動的執行個體時，該執行個體將成為例外狀況。視您對該變更進行的變更而定，當原始的週期性活動變更時，例外狀況會有以下兩種方法之一：

如果您新增、變更或移除留言、參與者或參與者的回覆，則例外狀況會與原始活動保持關聯，而對原始活動所做的變更也會變更例外狀況。
如果您對例外狀況進行其他變更 (例如變更時間或位置)，執行個體會變為「特殊」狀態，這表示執行個體與原始事件之間並無任何關聯。如果您變更原始活動，特殊例外情況則不會改變。不過，請參閱下方說明。

例如，假設您每週二和週四下午 2 點有會議，如果您在本週四的會議中更改出席狀況清單 (但不安排定期會議)，那麼就會成為例外。如果你變更本週會議的會議時間 (但不包括定期會議)，會議就會變成特殊參與者。

無論例外狀況是否具有特殊性，如果您執行的是刪除例外狀況的執行個體，則系統會刪除例外狀況。請注意，變更週期性活動的日期或時間會刪除所有活動，並建立新的活動。

舉例來說，假設您在下週四次開會後，將週期性會議安排在週一、週三和週五，這項變更會刪除星期二/週四會議中所有週期性的活動，包括特別會議。

如果刪除週期性活動的特定執行個體，該執行個體會顯示為 <gd:recurrenceException>，其中包含其 <gd:entryLink> 的 <gd:eventStatus> 設為 "http://schemas.google.com/g/2005#event.canceled"。(如要進一步瞭解已取消的活動，請參閱 RFC 2445)。

屬性

屬性	類型	說明
`@specialized`	`xs:boolean`	指出是否為特殊例外狀況。
`gd:entryLink`	`entryLink`	提供例外狀況詳情的事件項目。
`gd:originalEvent`	`originalEvent`	此為例外的定期週期性事件。

範例

週期性活動的例外情況 (部分部分以簡短斜體識別碼表示)：

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

結構定義

start = recurrenceException

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

gd:提醒

最常用於：<gd:when>

時間間隔，用於表示包含實體的 @startTime 或 @dueTime 屬性應發出提醒的時間長度。或者，也可以指定要發出提醒的確切時間。同時指定通知方式，指出系統應使用哪種媒介提醒使用者。

屬性

屬性	類型	說明
`@absoluteTime`？	`xs:dateTime`	應發出提醒的絕對時間。這通常是因為使用者透過「延後」功能延後先前的提醒。如未指定時區，系統會採用觀測器的當地時間。
`@method`？	`xs:string`	提醒應使用的通知方式。可以是下列任一值：`alert` (當使用者在瀏覽器中檢視日曆時顯示快訊)、`email` (傳送電子郵件給使用者) 或 `sms` (傳送簡訊給使用者)。
`@days`？	`xs:unsignedInt`	應在 `gd:when/@startTime`前發出提醒的時段。如果父系實體的目標時間是日期，而不是特定時間，這些屬性會以該日期的午夜 (00:00) 為準。
`@hours`？	`xs:unsignedInt`
`@minutes`？	`xs:unsignedInt`

建立或編輯 <gd:when> 項目時，請使用下列慣例來達到特定結果：

如要讓服務使用使用者的預設提醒，請加入不含屬性的 <gd:reminder> 元素。如果您指定時間長度，但沒有 method 屬性，服務就會採用您指定時間長度的使用者預設通知方法。
如果要讓服務不發出任何事件提醒 (或是在更新活動時移除現有提醒)，請不要加入任何 <gd:reminder> 元素。

限制

最多可以指定 @days、@hours、@minutes 或 @absoluteTime 其中之一。如要指定混合時間長度，請轉換為最精確的單位。舉例來說，如要指定 1 小時 30 分鐘，請使用 @minutes="90"。
屬性不得使用負值的值；因此，如果您想在開始時間之後收到提醒，就必須使用 @absoluteTime。
某個活動最多只能有五個提醒。
新增活動提醒時，如果您指定了 alert、email 或 sms 方法，也必須指定時間長度。

範例

會議 15 分鐘提醒：

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

同理，但在提醒 16:45 後提醒 10 分後：

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

結構定義

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

不透明的資源識別碼，與 atom:id 不同，因為它們不需要有效的 URI。部分服務會提供獨立 ID，用來建構後續的要求。確切用量會因服務而異。

範例

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

結構定義

start = resourceId

resourceId =
   element gd:resourceId { xs:string }

gd:when

代表一段時間或瞬間。

屬性

屬性	類型	說明
`@endTime`？	`xs:dateTime`或`xs:date`	說明活動的結束時間。如未指定時區，系統會採用觀測器的當地時區。
`@startTime`	`xs:dateTime`或`xs:date`	說明活動的開始時間或 0-00 秒的事件。如未指定時區，系統會採用觀測器的當地時區。
`@valueString`？	`xs:string`	可用於這個時間範圍的簡單字串值。

限制

無法在 startTime/endTime 中使用 xs:dateTime 與 xs:date 的混合。
如未指定 endTime，系統會將事件視為即時狀態 (如果 @startTime 含有時間) 或一日活動 (如果 @startTime 僅為日期)。

範例

為期一天的活動：

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

一日活動的替代活動：

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

為期 2 天的活動 (6 月 6 日 - 6 月 7 日)，包含字串說明：

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

一小時的會議：

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

持續時間為 0 的事件：

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

結構定義

start = when

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

gd:where

與內含實體相關的地點 (例如活動地點)。關聯的類型取決於 rel 屬性；位置詳細資訊包含在已嵌入或連結的「聯絡人」項目中。

<gd:where> 元素比 <gd:geoPt> 元素更為通用。前者會使用文字說明和/或「聯絡人」項目來辨識地點，後者則使用特定地理位置來辨識地點。

屬性

屬性	類型	說明
`@label`？	`xs:string`	指定使用者可理解的標籤，以便區分此位置與其他位置。
`@rel`？	`xs:string`	指定包含實體與包含位置之間的關係。可能的值 (見下文) 是由其他元素定義。例如，`<gd:when>` 定義 `http://schemas.google.com/g/2005#event`。
`@valueString`？	`xs:string`	可用來代表此位置的簡單字串值。
`gd:entryLink`？	`entryLink`	代表位置詳細資料的項目。此項目應實作 Contact 種類。

rel 值

值	說明
`http://schemas.google.com/g/2005#event` 或未指定	封閉式活動的地點。
`http://schemas.google.com/g/2005#event.alternate`	次要位置。例如，含有視訊會議連結的遠端網站。
`http://schemas.google.com/g/2005#event.parking`	附近的停車場。

範例

活動地點：

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

較複雜的活動地點：

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

包含多個地點的活動：

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

結構定義

start = where

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

gd:who

與內含實體相關聯的人。關聯的類型取決於 rel 屬性；使用者的詳細資料包含在嵌入或連結的聯絡人項目中。

<gd:who> 元素可用來指定電子郵件寄件者和收件者、日曆活動主辦者等等。

屬性

屬性	類型	說明
`@email`？	`xs:string`	電子郵件地址。如 `<gd:entryLink>` 未指定，則通常會使用這個屬性。地址必須符合 RFC 2822 第 3.4.1 節。
`@rel`？	`xs:string`	指定包含實體和包含對象之間的關係。可能的值請見下方。
`@valueString`？	`xs:string`	可用來代表這個人物的簡單字串值。
`gd:attendeeStatus`？	`gEnumConstruct`	活動參與者的狀態。可擴充的列舉項目如下所述。
`gd:attendeeType`？	`gEnumConstruct`	活動參與者的類型。可擴充的列舉項目如下所述。
`gd:entryLink`？	`entryLink`	代表人詳細資料的項目。此項目應實作 Contact 種類。在許多情況下，此項目可能來自聯絡人資訊提供。

rel 值

@rel 的有效值取決於出現 <gd:who> 元素的種類。

值	種類	說明
`http://schemas.google.com/g/2005#event.attendee`	事件	一般會議/活動參與者。
`http://schemas.google.com/g/2005#event.organizer`	事件	活動主辦人。發起人不一定是參與者。
`http://schemas.google.com/g/2005#event.performer`	事件	執行者。與 `http://schemas.google.com/g/2005#event.speaker` 類似，但前者的用力比語音傳送更強調。
`http://schemas.google.com/g/2005#event.speaker`	事件	喇叭
`http://schemas.google.com/g/2005#message.bcc`	訊息	郵件的密件副本收件者。
`http://schemas.google.com/g/2005#message.cc`	訊息	郵件副本收件者。
`http://schemas.google.com/g/2005#message.from`	訊息	郵件 (電子郵件或即時訊息) 寄件者。
`http://schemas.google.com/g/2005#message.reply-to`	訊息	回覆郵件的預期收件者。
`http://schemas.google.com/g/2005#message.to`	訊息	郵件的主要收件者。

gd:attendeeType 值

值	說明
`http://schemas.google.com/g/2005#event.optional`	選填參與者。
`http://schemas.google.com/g/2005#event.required`	必要的參與者。

gd:attendeeStatus 值

值	說明
`http://schemas.google.com/g/2005#event.accepted`	參與者已接受。
`http://schemas.google.com/g/2005#event.declined`	參與者已拒絕。
`http://schemas.google.com/g/2005#event.invited`	已傳送邀請，但對方尚未接受。
`http://schemas.google.com/g/2005#event.tentative`	出席者已暫時接受。

範例

電子郵件收件者：

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

會議參與者：

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

活動主辦人：

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

結構定義

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

返回頁首

常見元素：「種類」 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

簡介

未記錄的元素

建立種類

擴充性

字體排放慣例

聯絡種類

屬性

範例

事件種類

屬性

gd:where 的 rel 值

gd:eventStatus 值

gd:visibility 值

gd:transparency 值

範例

訊息種類

屬性

類別 @term 值

gd:who 的 rel 值

範例

Google Data 命名空間元素參考資料

列舉

gdCommonProperties

屬性

結構定義

gd:comments

屬性

rel 值

範例

結構定義

gd:deleted

屬性

結構定義

gd:email

屬性

rel 值

範例

結構定義

gd:entryLink

屬性

限制

範例

結構定義

gd:extendedProperty

屬性

範例

結構定義

gd:feedLink

屬性

限制

範例

結構定義

gd:geoPt

屬性

範例

結構定義

gd:im

屬性

rel 值

通訊協定屬性值

範例

結構定義

gd:organizations

屬性

rel 值

範例

結構定義

gd:orgName

範例

結構定義

gd:orgTitle

範例

結構定義

gd:originalEvent

屬性

範例

結構定義

gd:phoneNumber

屬性

常見元素：「種類」