Crear contactos compartidos

Después del 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án en la función de autocompletado de direcciones de correo electrónico y en el administrador de contactos.

1. Crea una representación XML del contacto compartido que deseas. publicar en forma de un elemento Atom <entry> del Tipo de contacto: que puede ser similar al siguiente ejemplo:

   <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 en ejemplo, Alex.
   • LAST_NAME: Es el apellido del usuario compartido. contacto, por ejemplo, Kim.
   • PRIMARY_EMAIL_ADDRESS: Es el correo electrónico preferido. del contacto compartido, por ejemplo, [e-mail].
   • PREFERRED_NAME: El nombre que se muestra para al usuario, por ejemplo, Alex Kim
   • SECONDARY_EMAIL_ADDRESS: Otra dirección de correo electrónico para el contacto compartido, como [e-mail].
   • PRIMARY_PHONE_NUMBER: Es el número de teléfono preferido. para el contacto compartido, por ejemplo, [phone].
   • SECONDARY_PHONE_NUMBER: otro número de teléfono de el 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 elemento compartido. contacto, por ejemplo, Mountain View.
   • ADDRESS: Es la dirección de la unidad compartida contacto, por ejemplo, 1600 Amphibious Blvd.
   • REGION_NAME: Es el estado o la provincia del contacto compartido, por ejemplo, CA.
   • POST_CODE: Es el código postal del recurso compartido. contacto, por ejemplo, 94045.
   • COUNTRY_NAME: Es el país del recurso compartido. contacto, por ejemplo, Estados Unidos.
   • FORMATTED_ADDRESS: Es la dirección de la unidad compartida. que tenga el formato de la convención de su país o por ejemplo,en 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 un nuevo 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 compartido con el dominio a la lista que pertenece a example.com, envía la solicitud POST con la nueva entrada 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, a continuación, devuelve un código de estado HTTP 201 CREATED, junto con una copia del nuevo contacto en forma de un elemento <entry>. La entrada devuelta es la misma una que enviaste, pero también contiene varios elementos agregados por el como un elemento <id>.

   Si falla la solicitud, es posible que Google te devuelva un código de estado. Para obtener información sobre los códigos de estado, consulta la Documento de referencia del protocolo de la API de datos de Google.

Próximos pasos

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