Crear contactos compartidos

Después de configurar la autenticación, puedes usar la API de Domain Shared Contacts para publicar nuevas entradas de contactos compartidos en un dominio de Google Workspace. Los contactos compartidos pueden tardar hasta 24 horas en aparecer en la función autocompletar de la dirección de correo electrónico y en el administrador de contactos.

1. Crea una representación XML del contacto compartido que desees publicar en forma de un elemento <entry> de Atom de la categoría de contacto, que podría tener un aspecto similar al siguiente:

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

   Reemplaza lo siguiente:

   • FIRST_NAME: Nombre del contacto compartido, por ejemplo, Alex.
   • LAST_NAME: El apellido del contacto compartido, por ejemplo, Kim.
   • PRIMARY_EMAIL_ADDRESS: Es la dirección de correo electrónico preferida del contacto compartido, por ejemplo, [e-mail].
   • PREFERRED_NAME: Es el nombre que se muestra al usuario, por ejemplo, Alex Kim.
   • SECONDARY_EMAIL_ADDRESS: Es otra dirección de correo electrónico del contacto compartido, por ejemplo, [e-mail].
   • PRIMARY_PHONE_NUMBER: Es el número de teléfono preferido para el contacto compartido, por ejemplo, [phone].
   • SECONDARY_PHONE_NUMBER: Es otro número de teléfono del contacto compartido, por ejemplo, [phone].
   • INSTANT_MESSAGING_ADDRESS: Es la dirección de correo electrónico asociada con la información de mensajería instantánea del contacto compartido, por ejemplo, [e-mail].
   • CITY_NAME: Es el nombre de la ciudad del contacto compartido, por ejemplo, Mountain View.
   • ADDRESS: Es la dirección del contacto compartido, por ejemplo, 1600 Amphibious Blvd.
   • REGION_NAME: Es el estado o la provincia del contacto compartido, por ejemplo, CA.
   • POST_CODE: El código postal del contacto compartido, por ejemplo, 94045
   • COUNTRY_NAME: El país del contacto compartido, por ejemplo, Estados Unidos
   • FORMATTED_ADDRESS: Es la dirección del contacto compartido que tiene un formato con la convención de su país o región, por ejemplo, 1800 Amphibious Blvd Mountain View.

2. Para publicar esta entrada, envíala a la URL del feed de la lista de contactos:

   1. Coloca el elemento <entry> de Atom en el cuerpo de una solicitud POST nueva con el tipo de contenido application/atom+xml.
   2. Envía la solicitud POST a la URL del feed.

   Por ejemplo, para agregar un contacto compartido del dominio a la lista que pertenece a example.com, envía la solicitud POST con la entrada nueva a la siguiente URL:

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

   El servidor de Google crea un contacto con la entrada que enviaste y, luego, muestra un código de estado HTTP 201 CREATED, junto con una copia del contacto nuevo en forma de un elemento <entry>. La entrada que se muestra es la misma que enviaste, pero también contiene varios elementos que agregó el servidor, como un elemento <id>.

   Si tu solicitud falla, es posible que Google muestre un código de estado diferente. Para obtener información sobre los códigos de estado, consulta el documento de referencia del protocolo de la API de datos de Google.

Próximos pasos

• Cómo actualizar o borrar la foto de un contacto compartido