共有の連絡先を作成する

認証を設定したら、Domain Shared Contacts API を使用して、新しい共有連絡先エントリを Google Workspace ドメインに公開できます。共有した連絡先がメールアドレスのオートコンプリートと連絡先管理ツールに表示されるまでには、最長で 24 時間ほどかかることがあります。

1. 公開する共有連絡先の XML 表現を作成します。これは、連絡先の種類の Atom <entry> 要素の形式で作成します。次のような形式になります。

   <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
       xmlns:gd='http://schemas.google.com/g/2005'>
     <atom:category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <gd:name>
        <gd:givenName>FIRST_NAME</gd:givenName>
        <gd:familyName>LAST_NAME</gd:familyName>
        <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <atom:content type='text'>NOTES</atom:content>
     <gd:email rel='http://schemas.google.com/g/2005#work'
       primary='true'
       address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
     <gd:email rel='http://schemas.google.com/g/2005#home'
       address='SECONDARY_EMAIL_ADDRESS' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
       primary='true'>
       PRIMARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
       SECONDARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:im address='INSTANT_MESSAGING_ADDRESS'
       protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
       primary='true'
       rel='http://schemas.google.com/g/2005#home' />
     <gd:structuredPostalAddress
         rel='http://schemas.google.com/g/2005#work'
         primary='true'>
       <gd:city>CITY_NAME</gd:city>
       <gd:street>ADDRESS</gd:street>
       <gd:region>REGION_NAME</gd:region>
       <gd:postcode>POST_CODE</gd:postcode>
       <gd:country>COUNTRY_NAME</gd:country>
       <gd:formattedAddress>
         FORMATTED_ADDRESS
       </gd:formattedAddress>
     </gd:structuredPostalAddress>
   </atom:entry>

   次のように置き換えます。

   • FIRST_NAME: 共有する連絡先の名前（例: Alex）。
   • LAST_NAME: 共有する連絡先の姓（例: Kim）。
   • PRIMARY_EMAIL_ADDRESS: 共有する連絡先の優先メールアドレス（例: [e-mail]）。
   • PREFERRED_NAME: ユーザーに表示される名前（例: Alex Kim）
   • SECONDARY_EMAIL_ADDRESS: 共有連絡先の別のメールアドレス（例: [e-mail]）。
   • PRIMARY_PHONE_NUMBER: 共有する連絡先の優先電話番号（例:[phone]）。
   • SECONDARY_PHONE_NUMBER: 共有する連絡先の別の電話番号（例:[phone]）。
   • INSTANT_MESSAGING_ADDRESS: 共有された連絡先のインスタント メッセージ 情報に関連付けられたメールアドレス（例: [e-mail]）。
   • CITY_NAME: 共有コンタクトの都市名（例: マウンテンビュー）。
   • ADDRESS: 共有コンタクトの住所（例: 1600 Amphibious Blvd）。
   • REGION_NAME: 共有コンタクトの州または都道府県（例: CA）。
   • POST_CODE: 共有連絡先の郵便番号（例: 94045）。
   • COUNTRY_NAME: 共有連絡先の国（米国など）。
   • FORMATTED_ADDRESS: 共有連絡先の住所。国または地域の規則に従ってフォーマットされます（例: 1800 Amphibious Blvd Mountain View）。

2. このエントリを公開するには、連絡先リスト フィードの URL に送信します。

   1. application/atom+xml コンテンツ タイプを使用して、新しい POST リクエストの本文に Atom <entry> 要素を配置します。
   2. POST リクエストをフィード URL に送信します。

   たとえば、example.com に属するリストにドメイン共有の連絡先を追加するには、新しいエントリを含む POST リクエストを次の URL に送信します。

   https://www.google.com/m8/feeds/contacts/example.com/full
   

   Google サーバーは、送信されたエントリを使用して連絡先を作成し、HTTP 201 CREATED ステータス コードと、<entry> 要素形式の新しい連絡先のコピーを返します。返されるエントリは送信したエントリと同じですが、<id> 要素など、サーバーによって追加されたさまざまな要素も含まれています。

   リクエストが失敗した場合、Google は別のステータス コードを返すことがあります。ステータス コードについては、Google Data API プロトコル リファレンス ドキュメントをご覧ください。

次のステップ

• 共有した連絡先の写真を更新または削除する