共有の連絡先の要素

Domain Shared Contacts API は、標準の Google Data API 要素と、共有連絡先に固有の要素を使用します。

連絡先エントリは、拡張された連絡先の種類の形式で、個人、会場（クラブやレストランなど）、組織を表します。連絡先の種類は、Google Data Namespace のさまざまな拡張要素を含む <atom:entry> 要素として XML に表示されます。

エントリが連絡先であることを示す category 要素は次のようになります。

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

Domain Shared Contacts API では、いくつかの要素が連絡先の種類よりも制限が厳しくなっています。次の要素には、rel 属性または label 属性のいずれか一方を指定します。両方を指定することはできません。

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

共有連絡先を作成または更新するときに、これらの要素のいずれかに rel と label の両方、またはどちらも指定しなかった場合、サーバーはエントリを拒否します。

フォトのサポート

atom:link 要素には、self や edit などの標準プロパティの値とともに rel 値を使用できます。写真リンクを使用する場合は、HTTP ヘッダーで認可トークンを指定する必要があります。詳細については、認証と承認の詳細をご覧ください。

  • GET コマンドを使用すると、rel="http://schemas.google.com/contacts/2008/rel#photo" に連絡先に関連付けられた写真を読み取る機能が追加されます。href で指定された URL を使用して、連絡先に関連付けられている最新バージョンの写真を読み取ることができます。連絡先に写真がない場合、リンクは表示されません。

例:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • PUT または DELETE コマンドを使用すると、rel="http://schemas.google.com/contacts/2008/rel#edit-photo" は連絡先に関連付けられているローカル写真を更新または削除する機能を追加します。

例:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContact 名前空間

gContact の XML 名前空間 URL は http://schemas.google.com/contact/2008 です。

この名前空間では、連絡先が属するグループを表す要素が定義されています。

gContact:groupMembershipInfo 件の宿泊施設

プロパティ 説明
href 連絡先が属している（または属していた）グループを識別します。グループは ID で参照されます。
deleted="true" 連絡先のグループ メンバーシップが削除されたことを意味します。この属性は、showdeleted がクエリ パラメータとして指定されている場合にのみ含まれます。それ以外の場合、連絡先が属していないグループの groupMembershipInfo は返されません。