Criar contatos compartilhados

Depois de configurar a autenticação, use a API Domain Shared Contacts para publicar novas entradas de contato compartilhado em um domínio do Google Workspace. Os contatos compartilhados podem levar até 24 horas para aparecer no preenchimento automático de endereços 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 a este:

   <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 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 que aparece para o usuário, por exemplo, Alex Kim
   • SECONDARY_EMAIL_ADDRESS: outro endereço de e-mail do contato compartilhado, por exemplo, [e-mail].
   • PRIMARY_PHONE_NUMBER: o número de telefone preferido para o contato compartilhado, por exemplo, [phone].
   • SECONDARY_PHONE_NUMBER: outro número de telefone para o 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 província do contato compartilhado, por exemplo, CA.
   • POST_CODE: o código postal ou ZIP 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 essa entrada, envie-a para o URL do feed da lista de contatos:

   1. Coloque seu 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 de 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 que você enviou e retorna um código de status HTTP 201 CREATED, junto 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 a solicitação falhar, 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 uma foto de um contato compartilhado