Criar contatos compartilhados

Depois de configurar a autenticação, use a API Domain Shared Contacts para publicar novas entradas de contatos compartilhados em um domínio do Google Workspace. Os contatos compartilhados podem levar até 24 horas para aparecer no preenchimento automático e no gerenciador de contatos.

1. Crie uma representação XML do contato compartilhado para publicar como um elemento Atom <entry> do tipo de contato:

   <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>

   Substitua:

   • FIRST_NAME: o nome do contato, como Dana.
   • LAST_NAME: sobrenome do contato, como A.
   • PRIMARY_EMAIL_ADDRESS: endereço de e-mail preferido, como [e-mail].
   • PREFERRED_NAME: nome de exibição do usuário, como Dana A.
   • SECONDARY_EMAIL_ADDRESS: e-mail secundário, como [e-mail].
   • PRIMARY_PHONE_NUMBER: número de telefone preferido, como 800-555-0100.
   • SECONDARY_PHONE_NUMBER: número de telefone secundário, como 800-555-0101.
   • INSTANT_MESSAGING_ADDRESS: endereço de e-mail de mensagens instantâneas, como [e-mail].
   • CITY_NAME: nome da cidade, como Mountain View.
   • ADDRESS: endereço da rua, como 1800 Amphibious Blvd.
   • REGION_NAME: estado ou província, como CA.
   • POST_CODE: CEP ou código postal, como 94045.
   • COUNTRY_NAME: país, como EUA.
   • FORMATTED_ADDRESS: endereço formatado usando convenções locais, como 1800 Amphibious Blvd., Mountain View, CA 94045, EUA.

2. Para publicar essa entrada, envie-a para o URL do feed da lista de contatos:

   1. Coloque o elemento <entry> do Atom no corpo de uma nova solicitação POST usando o tipo de conteúdo application/atom+xml.
   2. Envie a solicitação POST para o URL do feed.

   Por exemplo, para adicionar um contato à lista example.com, envie a solicitação POST para o seguinte URL:

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

   O servidor cria o contato e retorna um código de status HTTP 201 CREATED, além da nova entrada de contato. A entrada retornada inclui elementos gerados pelo servidor, como <id>.

   Se a solicitação falhar, o servidor vai retornar um código de status diferente. Consulte a referência do protocolo da API Google Data.

Próximas etapas

• Atualizar ou excluir uma foto de um contato compartilhado