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 do endereço de e-mail e no Gerenciador de contatos.

1. Crie uma representação XML do contato compartilhado que você quer publicar na forma de um elemento <entry> do Atom do Tipo de contato, que pode ser semelhante à seguinte:

   <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: nome do contato compartilhado. Por exemplo, Alex.
   • LAST_NAME: o sobrenome do contato compartilhado, por exemplo, Kim.
   • PRIMARY_EMAIL_ADDRESS: o endereço de e-mail preferencial do contato compartilhado, por exemplo, [e-mail].
   • PREFERRED_NAME: o nome exibido para o usuário, por exemplo, Alex Kim.
   • SECONDARY_EMAIL_ADDRESS: outro endereço de e-mail para o contato compartilhado. Por exemplo, [e-mail].
   • PRIMARY_PHONE_NUMBER: o número de telefone preferencial do contato compartilhado, por exemplo, [phone].
   • SECONDARY_PHONE_NUMBER: outro número de telefone do contato compartilhado. Por exemplo, [phone].
   • INSTANT_MESSAGING_ADDRESS: o endereço de e-mail associado às informações de mensagens instantâneas do contato compartilhado. Por exemplo, [e-mail].
   • CITY_NAME: o nome da cidade do contato compartilhado, por exemplo, Mountain View.
   • ADDRESS: o endereço do contato compartilhado, por exemplo, 1600 Amphibious Blvd.
   • REGION_NAME: o estado ou a província do contato compartilhado, por exemplo, CA.
   • POST_CODE: o CEP ou código postal do contato compartilhado, por exemplo, 94045.
   • COUNTRY_NAME: o país do contato compartilhado, por exemplo, Estados Unidos.
   • FORMATTED_ADDRESS: o endereço do contato compartilhado formatado usando a convenção do país ou da região. Por exemplo,1800 Amphibious Blvd Mountain View.

2. Para publicar esta 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 compartilhado do domínio à lista que pertence a example.com, envie a solicitação POST com a nova entrada para o seguinte URL:

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

   O servidor do Google cria um contato usando a entrada enviada e, em seguida, retorna um código de status HTTP 201 CREATED com uma cópia do novo contato na forma de um elemento <entry>. A entrada retornada é a mesma que você enviou, mas também contém vários elementos adicionados pelo servidor, como um elemento <id>.

   Se houver falha na solicitação, o Google poderá retornar um código de status diferente. Para mais informações sobre os códigos de status, consulte o documento de referência do protocolo da API Google Data.

Próximas etapas

• Atualizar ou excluir a foto de um contato compartilhado