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

После настройки аутентификации используйте 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 : Предпочитаемый номер телефона, например, 800-555-0100.
   • SECONDARY_PHONE_NUMBER : Дополнительный номер телефона, например, 800-555-0101.
   • INSTANT_MESSAGING_ADDRESS : Адрес электронной почты для обмена мгновенными сообщениями, например, [e-mail].
   • CITY_NAME : Название города, например, Маунтин-Вью.
   • ADDRESS : Уличный адрес, например, 1800 Amphibious Blvd.
   • REGION_NAME : Штат или провинция, например, Калифорния.
   • POST_CODE : почтовый индекс, например, 94045.
   • COUNTRY_NAME : Страна, например, США.
   • FORMATTED_ADDRESS : Адрес, отформатированный в соответствии с местными правилами, например, 1800 Amphibious Blvd., Mountain View, CA 94045, USA.

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
   

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

   Если запрос не удается, сервер возвращает другой код состояния. См. справочник по протоколу Google Data API .

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

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