Создание общих контактов

После настройки аутентификации вы можете использовать API общих контактов домена для публикации новых записей общих контактов в домене Google Workspace. Общие контакты могут появиться в автозаполнении адреса электронной почты и диспетчере контактов в течение 24 часов.

1. Создайте XML-представление общего контакта, который вы хотите опубликовать, в виде элемента Atom <entry> типа Contact , который может выглядеть примерно так:

   <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 : имя общего контакта, например Алекс.
   • LAST_NAME : фамилия общего контакта, например Ким.
   • PRIMARY_EMAIL_ADDRESS : предпочтительный адрес электронной почты общего контакта, например [e-mail].
   • PREFERRED_NAME : имя, отображаемое для пользователя, например Алекс Ким.
   • 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 : штат или провинция общего контакта, например Калифорния.
   • POST_CODE : почтовый индекс или почтовый индекс общего контакта, например 94045.
   • COUNTRY_NAME : страна общего контакта, например США.
   • FORMATTED_ADDRESS : адрес общего контакта, отформатированный с использованием условного обозначения его страны или региона, например, 1800 Amphibious Blvd Mountain View.

2. Чтобы опубликовать эту запись, отправьте ее на URL-адрес ленты списка контактов:

   1. Поместите элемент Atom <entry> в текст нового запроса POST , используя тип контента application/atom+xml .
   2. Отправьте POST запрос на URL-адрес канала.

   Например, чтобы добавить общий контакт домена в список, принадлежащий example.com, отправьте запрос POST с новой записью по следующему URL-адресу:

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

   Сервер Google создает контакт, используя отправленную вами запись, а затем возвращает код состояния HTTP 201 CREATED вместе с копией нового контакта в форме элемента <entry> . Возвращенная запись аналогична отправленной вами, но она также содержит различные элементы, добавленные сервером, например элемент <id> .

   Если ваш запрос не будет выполнен, Google может вернуть другой код статуса. Информацию о кодах состояния см. в справочном документе по протоколу API данных Google .

Следующие шаги

• Обновите или удалите фотографию общего контакта