共通要素: 「種類」

はじめに

Google Data API を使用するサービスで、特定の種類のアイテムに関する一貫した情報のセットを提供できると役に立つことがよくあります。

たとえば、さまざまな Google Data API(または「GData」)サービスは、個人や組織の連絡先情報を提供することがあります。このようなサービスでは、同じ連絡先情報要素のセットを使用するのが合理的です。

連絡先を表す要素をまとめて「連絡先の種類」と呼びます。Contact 型の要素の一部は、通常の Atom 要素または RSS 要素です。その他の要素は、「Google Data 名前空間」という名前空間で Google によって定義されます。慣例により、Google データ名前空間は通常、gd: エイリアスを使用して XML コードで参照されます。たとえば、電話番号またはファックス番号を含む要素は <gd:phoneNumber> です。Google Data 名前空間のスキーマ URL は http://schemas.google.com/g/2005 です。

Google では、イベント(カレンダーの予定を表す標準化された要素の集合)とメッセージ(メール、ヘルプグループの投稿、その他のメッセージを表す要素の集合)も定義します。

Google Data 名前空間の一部の要素は複数の種類で使用されます。たとえば、<gd:who> 要素は、ユーザー(<gd:who> を参照)を <gd:who> 要素を含むエントリに関連付けます。この要素はイベントの種類で、主催者や参加者などを指定するために使用されます。Message の種類では、送信者と受信者を指定する場合にも使用されます。

Google Data API フィードのエントリで特定の種類が使用されている場合、scheme 属性を "http://schemas.google.com/g/2005#kind" に設定し、term 属性をスキーマ URL の名前に続けて種類名を指定した <atom:category> 要素が含まれます。たとえば、Contact エントリに次の要素が含まれているとします。

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

これにより、エントリに含まれるデータの種類(つまり、エントリのセマンティクス)を迅速かつ簡単に判断できます。(必要に応じて、Atom の代わりに RSS も使用できます。Atom 要素に対応する RSS 要素については、プロトコル リファレンスをご覧ください)。

このドキュメントは、一般的な種類と、含まれる要素のリファレンスです。

文書化されていない要素

<atom:entry> の標準要素については、その要素が標準の意味を持つ場合に含まれません。たとえば、<atom:id><atom:published><atom:updated> はすべて、種類として表示されるときに標準の意味を持ちます。

また、指定されたコンテキストでは意味を持たない標準的な Atom 要素に関する情報も含まれていません。たとえば、<atom:summary> は Contact 種類では使用されません。また、<atom:author> はエントリで必須の要素ですが、親フィードで指定されていても、Contact の種類では有用な意味を持ちません。

種類を作成する

特に、その種類の要素には他の種類のものが含まれているため、特定の種類のエントリを作成する際に含める必要のある情報を正確に把握することは困難です。

有効な方法の一つは、手作業で種類を作成しようとする代わりに、Google が提供するクライアント ライブラリを使用することです。クライアント ライブラリには、特定の種類のエントリでデータを追加および変更するためのさまざまなメソッドが用意されています。詳細については、クライアント ライブラリのドキュメントをご覧ください。

拡張性

このドキュメントは、すべての種類のプロパティと属性値を網羅しているわけではありません。サービスでは種類が拡張されることがあるため、特定のサービスでは、このドキュメントに記載されていないプロパティや値が使用される場合があります。

表記規則

このドキュメントの表では、必須要素と省略可能な要素に次の規則を使用しています。

要素名 必須要素
elementName? 省略可能な要素
要素名* 省略可能な要素、複数のインスタンスを許可する

要素と属性は標準の 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* 電話番号と FAX 番号。
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 2 番目の場所。たとえば、メインサイトへのビデオ会議へのリンクがあるリモートサイトなどです。
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 Bcc の宛先にメッセージを送信します。
http://schemas.google.com/g/2005#message.cc メールの CC 受信者。
http://schemas.google.com/g/2005#message.from メッセージ(メールまたは IM)の送信者。
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 名前空間要素のリファレンス

このドキュメントの残りの部分は、種類で使用される要素のリファレンス資料です。

列挙型

一部の拡張要素では、列挙された型の値を持つプロパティを指定する必要があります。このようなプロパティの一般的な形式は次のとおりです。

<gd:propertyName value="propertyValue">

プロパティ値が Google Data の名前空間から取得された場合、http://schemas.google.com/g/2005#{kind}.{value} の形式になります。例: http://schemas.google.com/g/2005#event.tentative値空間が拡張可能な場合、値は URI の形式にすることもできます。拡張 URI には {schema URI}#{value} を使用することをおすすめします。例: http://www.example.com/attendeeStatus#AudioConference

gEnumConstruct =
   attribute value { text },
   anyAttribute*

gdCommonProperties

すべての Google タイプで使用される共通のプロパティ。スキーマに anyAttributeanyElement を指定すると、共通のプロパティを使用するすべての Google Data Namespace 要素を任意の Namespace で拡張できます。特に、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:削除済み

マーカー要素が存在する場合は、含まれているエントリが削除されたことを示します。

プロパティ

なし

スキーマ

start = deleted

deleted =
   element gd:deleted

gd:email

一致しているエンティティに関連付けられたメールアドレス(通常は人や場所を表すエンティティ)。

プロパティ

プロパティ タイプ 説明
@address xs:string メールアドレス。
@labelのどれですか? xs:string このメールアドレスの名前に使用されるシンプルな文字列値です。UI では、「仕事」、「個人」、「優先」などのラベルを表示できます。
@relのどれですか? xs:string メールの種類を識別するプログラマティックな値。詳しくは以下をご覧ください。
@primaryのどれですか? xs:boolean ある種類のメールに複数の拡張機能が含まれている場合、どの広告表示オプションがメインかを示します。メインのメールアドレスは 1 つまでです。デフォルト値は "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 リンク関係を指定します。サービスで 1 つのエンティティに対して複数のタイプのエントリリンクを提供できます。セマンティクスと許可される値は、<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 が存在する場合、フィードは任意で gd:extendedProperty 要素内に有効な XML を埋め込むことができます(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 リンク関係を指定します。1 つのエンティティに対して複数のタイプのフィードリンクを提供できます。セマンティクスと許可される値は、<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 に「Current Position」などのラベルを表示できます。
@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 アドレスに名前を付けるために使用されるシンプルな文字列値です。UI では、「仕事」、「個人」、「優先」などのラベルを表示できます。
@relのどれですか? xs:string IM のタイプを識別するプログラマティックな値(詳しくは下記をご覧ください)。
@protocolのどれですか? xs:string IM ネットワークを識別します。値は、以下の標準的な値(後述)か、独自の IM ネットワークを識別する URI のいずれかです。
@primaryのどれですか? xs:boolean 連絡先の種類に複数の IM 拡張機能が表示される場合、どちらの拡張がメインかが示されます。最大 1 つの 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 インスタント メッセンジャー プロトコル
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 トーク プロトコル
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:organization

通常は連絡先に関連付けられた組織。

プロパティ

プロパティ タイプ 説明
@labelのどれですか? xs:string この組織に名前を付けるために使用されるシンプルな文字列値。UI では、「仕事」、「ボランティア」、「専門団体」などのラベルを表示できます。
@relのどれですか? xs:string 組織の種類を識別するプログラムによる値。
@primaryのどれですか? xs:boolean ある種類の連絡先に複数の組織拡張機能が表示される場合、どちらを優先するかを示します。メインの組織として設定できるのは 1 つまでです。デフォルト値は "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 で指定されている Recurrence ID プロパティと同じです。定期的な予定のすべてのイベントに表示され、元の予定を識別します。

例外となったインスタンスの元の開始時刻を指定する <gd:when> 要素を格納します。

プロパティ

プロパティ タイプ 説明
@id xs:string 元のイベントのイベント ID。
@href xs:string 元のイベントのイベント フィード URL。

元のイベントを指定する:

<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 この電話番号の命名に使用されるシンプルな文字列値です。ほとんどの場合、@rel は数値を一意に識別し、「UI」、「Home」、「Work」などの適切なラベルを UI に表示できるため、@label は必要ありません。ただし、1 人のユーザーが複数の携帯電話を持っている場合などは、このプロパティを使用して識別することができます。
@relのどれですか? xs:string 電話番号のタイプを識別するプログラマティックな値(詳しくは下記をご覧ください)。
@uriのどれですか? xs:string VoIP/PSTN ブリッジなど、プログラマティックなアクセスに役立つように、正式な方法で番号を表すために使用されるオプションの「tel URI」。tel URI の詳細については、RFC 3966 をご覧ください。
@primaryのどれですか? xs:boolean ある種類の連絡先に複数の電話番号表示オプションが表示されている場合は、どちらを優先するかを指定します。メインの電話番号は 1 つまでです。デフォルト値は "false" です。
text() xs:string 人が読める形式の電話番号(任意の電話番号形式)。先頭や末尾の空白は重要ではありません。文字列内の改行も重要ではなく、1 つのスペースに削除またはフラット化されることがあります。

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(gd:住所)

住所。

プロパティ

プロパティ タイプ 説明
@labelのどれですか? xs:string この住所の名前に使用されるシンプルな文字列値です。
@relのどれですか? xs:string 住所の種類を識別するプログラム上の値(詳しくは下記をご覧ください)。
@primaryのどれですか? xs:boolean 1 つの連絡先の種類に複数の住所表示オプションがある場合は、メインの住所を示します。メインの住所は 1 つまでです。デフォルト値は "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 人の評価(5 段階中 4.65)

<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 をご覧ください)。最後に、VTIMEZONE コンポーネントについて説明します。このコンポーネントには、前述のプロパティで説明したタイムゾーン ID の詳細なタイムゾーン ルールを指定します。

通常、Google カレンダーなどの Google サービスでは、定期的な予定の例外を表す EXRULE プロパティと EXDATE プロパティは生成されませんが、代わりに <gd:recurrenceException> 要素が生成されます。ただし、Google サービスには EXRULE プロパティや EXDATE プロパティを含めることもできます。たとえば、ユーザーはイベントと例外をカレンダーにインポートできます。インポートしたイベントに EXRULE プロパティか EXDATE プロパティが含まれている場合、カレンダーは <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 つの方法で例外が処理されます。

  • コメント、参加者、参加者の回答を追加、変更、削除すると、例外は元のイベントと関連付けられ、元のイベントを変更すると例外も変更されます。
  • 例外に他の変更(時刻や場所の変更など)を加えると、インスタンスが「特別」になるため、元のイベントと密接に結び付かなくなります。元のイベントを変更しても、特別な例外は変更されません。以下をご覧ください。

たとえば、毎週火曜日と木曜日の午後 2 時に会議を開催するとします。ただし、今週木曜日の会議の出欠リストを変更すると、例外はあります。木曜日に予定されている会議(定期的に予定されている会議以外の日時)を変更すると、その会議の予定が特殊になります。

例外が専門的なものかどうかにかかわらず、例外の引き出元のインスタンスを削除すると、その例外は削除されます。定期的な予定の日時を変更すると、すべての予定が削除され、新しい予定が作成されます。

たとえば、この木曜日の会議を特別に設定した後、定期的な会議が月曜日、水曜日、金曜日に行われるように変更するとします。この変更を行うと、火曜日と木曜日の会議で繰り返す回(特殊なインスタンスを含む)がすべて削除されます。

定期的な予定の特定のインスタンスが削除されると、<gd:eventStatus>"http://schemas.google.com/g/2005#event.canceled" に設定された <gd:entryLink> を含む <gd:recurrenceException> として表示されます。(キャンセルされたイベントについて詳しくは、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:reminder

使用頻度: <gd:when>

親エンティティの @startTime または @dueTime 属性でリマインダーが発行されるまでの時間を示す期間。または、リマインダーを発行する絶対的な時間を指定することもできます。また、システムでユーザーにリマインドする際に使用するメディアを示す通知方法を指定します。

プロパティ

プロパティ タイプ 説明
@absoluteTimeのどれですか? xs:dateTime リマインダーの絶対開始時刻。これは通常、ユーザーが「スヌーズ」機能を使用して前のリマインダーを遅らせる場合に使用されます。タイムゾーンが指定されていない場合、オブザーバーの現地時間が使用されます。
@methodのどれですか? xs:string リマインダーで使用する通知方法。値は、alert(ユーザーがブラウザでカレンダーを表示したときにアラートが表示されるよう)、email(ユーザーにメール メッセージを送信する)、sms(ユーザーに SMS テキスト メッセージを送信する)のいずれかを指定できます。
@daysのどれですか? xs:unsignedInt リマインダーが発行される前の gd:when/@startTime の期間。親エンティティの目標時刻が特定の時刻ではなく日付の場合、これらの属性はその日付の午前 0 時(00:00)を基準にしています。
@hoursのどれですか? xs:unsignedInt
@minutesのどれですか? xs:unsignedInt

<gd:when> エントリを作成または編集する場合、特定の結果を得るには、次の規則を使用します。

  • ユーザーのデフォルトのリマインダーを使用するようサービスに伝えるには、属性のない <gd:reminder> 要素を含めます。期間を指定しても、method 属性を指定しなかった場合、サービスは、指定された期間におけるユーザーのデフォルトの通知方法を使用します。
  • 予定のリマインダーを一切発行しないようにする(または予定の更新時に既存のリマインダーを削除する)には、<gd:reminder> 要素を含めないようにします。

制限事項

  • @days@hours@minutes@absoluteTime のうち、最大で 1 つを指定できます。混合期間を指定するには、最も正確な単位に変換します。たとえば、1 時間 30 分を指定するには @minutes="90" を使用します。
  • 属性に負の値は使用できません(したがって、開始時間後にリマインダーを表示する場合は @absoluteTime を使用する必要があります)。
  • 1 つの予定に、関連付けられたリマインダーは 5 つまでです。
  • 予定にリマインダーを追加するときに alertemailsms の各メソッドを指定する場合は、期間も指定する必要があります。

会議の 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

不透明なリソース識別子。有効な URI である必要はないため、Atom: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 イベントの開始日時、または(ゼロ時間のイベントの場合)の開催日時を示します。タイムゾーンが指定されていない場合、オブザーバーのローカル タイムゾーンとみなされます。
@valueStringのどれですか? xs:string この期間の表現として使用できる単純な文字列値。

制限事項

  • startTime / endTimexs:dateTimexs:date を混在させることはできません。
  • endTime が指定されていない場合、イベントは時刻(@startTime に時刻が含まれている場合)または 1 日イベント(@startTime が日付のみ)とみなされます。

1 回限りのイベント:

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

1 日イベントを表す別の表現:

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

1 時間の会議:

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

長さがゼロのイベント:

<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 2 番目の場所。たとえば、メインサイトへのビデオ会議へのリンクがあるリモートサイトなどです。
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:ユーザー

エンティティに関連付けられている個人。関連付けのタイプは 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 メッセージ Bcc の宛先にメッセージを送信します。
http://schemas.google.com/g/2005#message.cc メッセージ メールの CC 受信者。
http://schemas.google.com/g/2005#message.from メッセージ メッセージ(メールまたは IM)の送信者。
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 }?)
   }

トップへ戻る