共有の連絡先を作成する

認証を設定したら、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: 連絡先の名前（例: Dana）。
   • LAST_NAME: 連絡先の姓（A など）。
   • PRIMARY_EMAIL_ADDRESS: 優先メールアドレス（例: [e-mail]）。
   • PREFERRED_NAME: ユーザーの表示名（Dana A. など）。
   • SECONDARY_EMAIL_ADDRESS: セカンダリ メール（[e-mail] など）。
   • PRIMARY_PHONE_NUMBER: 優先される電話番号（800-555-0100 など）。
   • SECONDARY_PHONE_NUMBER: 2 つ目の電話番号（800-555-0101 など）。
   • INSTANT_MESSAGING_ADDRESS: インスタント メッセージングのメールアドレス（[e-mail] など）。
   • CITY_NAME: 都市名（Mountain View など）。
   • ADDRESS: 住所の番地（1800 Amphibious Blvd など）。
   • REGION_NAME: 州または都道府県（CA など）。
   • POST_CODE: 郵便番号（94045 など）。
   • COUNTRY_NAME: 国（米国など）。
   • FORMATTED_ADDRESS: 1800 Amphibious Blvd. などのローカルの規則を使用してフォーマットされた住所。Mountain View, CA 94045, USA.

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

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

   たとえば、example.com リストに連絡先を追加するには、次の URL に POST リクエストを送信します。

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

   サーバーは連絡先を作成し、新しい連絡先エントリとともに HTTP 201 CREATED ステータス コードを返します。返されるエントリには、<id> などのサーバー生成要素が含まれます。

   リクエストが失敗すると、サーバーは別のステータス コードを返します。Google Data API プロトコル リファレンスをご覧ください。

次のステップ

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