共有の連絡先を作成する

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

1. 公開する共有連絡先の XML 表現を、Contact kind の 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: 共有の連絡先の都市名（例: Mountain View）。
   • 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 コンテンツ タイプを使用して、Atom の <entry> 要素を新しい POST リクエストの本文に配置します。
   2. フィード URL に POST リクエストを送信します。

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

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

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

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

次のステップ

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