Obtener contactos compartidos

Solicita contactos de usuarios compartidos de las siguientes maneras:

  • Todos los contactos compartidos
  • Un conjunto de contactos que coinciden con los criterios especificados
  • Un solo contacto compartido
  • Una foto de un contacto

De forma predeterminada, las entradas de un feed no están ordenadas.

Obtén todos los contactos compartidos

  1. Para obtener todos los contactos compartidos, envía una solicitud GET de HTTP a la URL del feed de contactos:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    Reemplaza lo siguiente:

    • DOMAIN: Tu dominio. Por ejemplo, example.com.
    • PROJECTION: El valor de la proyección. Para obtener los valores admitidos, consulta Valores de proyección.

    El servidor muestra un código de estado HTTP 200 OK y un feed de Atom 1.0. En el siguiente ejemplo, se muestra un feed de contactos con una entrada:

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. Los feeds muestran un máximo de 10 MB en una sola respuesta. Para obtener la lista completa, sigue el vínculo Siguiente en el feed que se muestra de forma repetida.

Obtén contactos compartidos con parámetros de consulta

Solicita contactos que coincidan con los criterios especificados, como los que se actualizaron después de una fecha determinada. No se admiten las consultas de texto completo ni las búsquedas de direcciones de correo electrónico. Para obtener todos los parámetros de consulta, consulta la guía de referencia de la API de Domain Shared Contacts.

  1. Envía una solicitud HTTP GET a la URL del feed de contactos con un parámetro:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    Reemplaza lo siguiente:

    Por ejemplo, para obtener las entradas actualizadas después del 16 de marzo de 2022 para example.com, agrega el parámetro updated-min:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    El servidor muestra un código de estado HTTP 200 OK y un feed con cualquier coincidencia.

  2. Los feeds muestran un máximo de 10 MB en una sola respuesta. Para obtener la lista completa, sigue el vínculo Siguiente en el feed que se muestra de forma repetida.

Realiza un seguimiento de los cambios incrementales

Para realizar un seguimiento de los cambios en una lista de contactos compartidos del dominio, haz lo siguiente: 1. Registra el valor del elemento <updated> del feed. 1. Solicita los contactos modificados configurando updated-min en ese <updated> valor y configurando showdeleted en true.

Obtén un solo contacto compartido

Para obtener un contacto específico, usa el vínculo propio del contacto, que puedes encontrar en el feed de contactos compartidos. Para obtener más información, consulta Obtén todos los contactos compartidos.

  1. Para obtener un contacto específico, envía una solicitud HTTP GET al vínculo propio del contacto: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Reemplaza lo siguiente:
  • DOMAIN: Tu dominio, por ejemplo, example.com.
  • PROJECTION: El valor de la proyección. Para obtener los valores admitidos, consulta Valores de proyección.
  • SELF_LINK: El valor numérico único del contacto.

El servidor muestra un código de estado HTTP 200 OK y la entrada de contacto.

Por ejemplo, para obtener un contacto con el vínculo propio https://www.google.com/m8/feeds/contacts/example.com/full/12345:

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

Próximos pasos