共用聯絡人元素

Domain Shared Contacts API 使用 Google Data API 標準元素 以及共用聯絡人專屬的元素

聯絡人項目的形式，格式為 聯絡人種類、 代表人物、場地 (例如俱樂部或餐廳) 或 並根據貴機構的使命 價值觀和目標進行調整聯絡種類在 XML 中會以 <atom:entry> 元素的形式顯示， 包含 Google Data 命名空間中的各種擴充元素。

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 (或兩者皆非)，則伺服器會拒絕 項目。

Google 相簿支援

與標準資源搭配使用例如自行或編輯，您可以使用 rel 代表 atom:link 元素的值。使用相片連結時， 必須指定 HTTP 標頭若需更多資訊，請參閲 瞭解驗證和授權。

  • 使用 GET 指令 rel="http://schemas.google.com/contacts/2008/rel#photo" 會將 讀取與聯絡人相關的相片。您可以使用 在 href 中指定的網址，用於讀取相關聯的最新版本相片 與聯絡人聯絡。如果沒有圖片，就不會顯示連結 視為聯絡人。

範例：

<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 命名空間網址為 http://schemas.google.com/contact/2008。

在此命名空間中，元素定義的元素代表了 聯絡人屬於

gContact:groupMembershipInfo 個房源

屬性 說明
href 識別聯絡人所屬的群組。 每個群組都是由其 ID 所參照
deleted="true" 表示系統已移除聯絡人的群組成員資格。這個 屬性只有在指定 showdeleted 時才會納入 做為查詢參數，否則為 groupMembershipInfo 系統將不再傳回聯絡人所屬群組。