Crear contactos compartidos

Después de configurar la autenticación, usa 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 Autocompletar y en el administrador de contactos.

1. Crea una representación XML del contacto compartido para publicarlo como un elemento <entry> de Atom del tipo 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>

   Reemplaza lo siguiente:

   • FIRST_NAME: Es el nombre de contacto, como Dana.
   • LAST_NAME: Apellido del contacto, como A.
   • PRIMARY_EMAIL_ADDRESS: Dirección de correo electrónico preferida, como [e-mail].
   • PREFERRED_NAME: Es el nombre visible del usuario, como Dana A.
   • SECONDARY_EMAIL_ADDRESS: Correo electrónico secundario, como [e-mail].
   • PRIMARY_PHONE_NUMBER: Número de teléfono preferido, como 800-555-0100.
   • SECONDARY_PHONE_NUMBER: Número de teléfono secundario, como 800-555-0101.
   • INSTANT_MESSAGING_ADDRESS: Dirección de correo electrónico de mensajería instantánea, como [e-mail].
   • CITY_NAME: Nombre de la ciudad, como Mountain View.
   • ADDRESS: Dirección, como 1800 Amphibious Blvd.
   • REGION_NAME: Estado o provincia, como CA.
   • POST_CODE: Código postal, como 94045.
   • COUNTRY_NAME: País, como EE.UU.
   • FORMATTED_ADDRESS: Dirección con el formato de las convenciones locales, como 1800 Amphibious Blvd., Mountain View, CA 94045, EE.UU.

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 nueva solicitud POST 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 a la lista de example.com, envía la solicitud POST a la siguiente URL:

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

   El servidor crea el contacto y devuelve un código de estado HTTP 201 CREATED junto con la nueva entrada de contacto. La entrada que se muestra incluye elementos generados por el servidor, como <id>.

   Si la solicitud falla, el servidor devuelve un código de estado diferente. Consulta la referencia del protocolo de la API de Google Data.

Próximos pasos

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