Obtener contactos compartidos

Solicita los contactos de los usuarios compartidos de las siguientes maneras:

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

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

Obtener todos los contactos compartidos

  1. Para obtener todos los contactos compartidos, envía una solicitud HTTP GET 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: Es el valor de la proyección. Para conocer los valores admitidos, consulta Valores de proyección.

    El servidor devuelve un código de estado HTTP 200 OK y un feed 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 devuelven un máximo de 10 MB en una sola respuesta. Para obtener la lista completa, sigue repetidamente el vínculo Siguiente en el feed que se muestra.

Obtén contactos compartidos con parámetros de consulta

Solicita contactos que coincidan con criterios especificados, como los que se actualizaron después de una fecha determinada. No se admiten las búsquedas de texto completo ni las búsquedas de direcciones de correo electrónico. Para ver 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 devuelve un código de estado HTTP 200 OK y un feed con las coincidencias.

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

Haz un seguimiento de los cambios incrementales

Para hacer un seguimiento de los cambios en una lista de contactos compartida de un dominio, sigue estos pasos: 1. Registra el valor del elemento <updated> del feed. 1. Solicita los contactos modificados configurando updated-min en ese valor de <updated> y showdeleted en true.

Obtener 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 Cómo obtener 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: Es el valor de la proyección. Para conocer los valores admitidos, consulta Valores de proyección.
  • SELF_LINK: Es el valor numérico único del contacto.

El servidor devuelve 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, haz lo siguiente:

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

Próximos pasos