共有の連絡先の要素

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

連絡先エントリは、個人、クラブやレストランなどの場所、または組織を表す拡張された連絡先の種類の形式をとります。連絡先の種類は、Google Data 名前空間のさまざまな拡張要素を含む <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 の両方を指定するか、どちらも指定しない場合、サーバーはそのエントリを拒否します。

フォトのサポート

「self」や「edit」などの標準プロパティの値とともに、atom:link 要素に 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/*" />
  • rel="http://schemas.google.com/contacts/2008/rel#edit-photo" では、PUT コマンドまたは DELETE コマンドを使用すると、連絡先に関連付けられているローカル写真を更新または削除できるようになります。

例:

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

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

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

gContact:groupMembershipInfo 件の宿泊施設

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