Obtener contactos compartidos

Puedes solicitar contactos de usuario compartidos de varias maneras:

  • Todos los contactos compartidos
  • Un conjunto de contactos que coinciden con un criterio específico.
  • Un solo contacto compartido
  • La foto de un contacto

De forma predeterminada, las entradas de un feed no se ordenan.

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: Es la URL de tu dominio, por ejemplo, example.com.
    • PROJECTION: Es el valor de proyección que especifica los elementos gd:extendedProperty. Para obtener una lista de los valores admitidos, consulta Valores de proyección.

    El feed muestra un código de estado HTTP 200 OK y un feed Atom 1.0 estándar que contiene los contactos. A continuación, se muestra un ejemplo de un feed de contactos con una sola 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. El feed no muestra más de 10 MB en una sola respuesta. Para obtener toda la lista de contactos, sigue varias veces el vínculo Siguiente del feed que se muestra hasta que dejes de verlo en el feed de resultados.

Cómo obtener contactos compartidos mediante parámetros de consulta

Puedes solicitar un conjunto de contactos que coincida con criterios específicos; por ejemplo, solicitar contactos actualizados después de una fecha determinada. No hay asistencia para consultas en texto completo ni para encontrar un contacto por dirección de correo electrónico. Para obtener una lista completa de los parámetros de consulta compatibles, consulta la Guía de referencia de la API de Domains Shared Contacts.

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

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

    Reemplaza lo siguiente:

    • DOMAIN: Es la URL de tu dominio, por ejemplo, example.com.
    • PROJECTION: Es el valor de proyección que especifica los elementos gd:extendedProperty. Para obtener una lista de los valores admitidos, consulta Valores de proyección.
    • PARAMETER: Es uno de los parámetros de consulta admitidos. Para obtener más información, consulta la Guía de referencia de la API de Domains Shared Contacts.

    Por ejemplo, para obtener todas las entradas de contactos compartidos del dominio después del 16 de marzo de 2022 para example.com, envía una solicitud HTTP a la URL del feed de contacto compartido del dominio y agrega el parámetro updated-min a la URL de la solicitud:

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

    Cuando envías esa solicitud GET, el servidor muestra un código de estado HTTP 200 OK y un feed que contiene los contactos compartidos del dominio que se crearon o actualizaron después de la fecha especificada.

  2. El feed no muestra más de 10 MB en una sola respuesta. Para obtener toda la lista de contactos con los criterios especificados, sigue varias veces el vínculo Siguiente del feed que se muestra hasta que dejes de verlo en el feed de resultados.

Realiza un seguimiento de los cambios incrementales

Para realizar un seguimiento de los cambios incrementales en una lista de contactos compartida de un dominio, haz lo siguiente:1. Cuando envíes una solicitud de un feed, haz un seguimiento del valor del elemento <updated> del feed. 1. Puedes obtener solo los contactos compartidos del dominio que cambiaron desde la solicitud anterior si configuras el parámetro de búsqueda updated-min en ese valor de <updated> y si configuras showdeleted en true.

Cómo obtener un solo contacto compartido

Para obtener un solo contacto compartido, debes usar el vínculo propio del contacto. Solo puedes obtener el vínculo propio del contacto compartido si ubicas la entrada del contacto en el feed de contactos compartidos. Si no estás seguro de qué valor usar para el vínculo propio, consulta Obtén todos los contactos y Obtén contactos mediante parámetros de consulta.

  1. Para obtener un contacto compartido de un dominio específico, envía una solicitud HTTP GET al vínculo propio de un contacto: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    Reemplaza lo siguiente:
  • DOMAIN: Es la URL de tu dominio, por ejemplo, example.com.
  • PROJECTION: Es el valor de proyección que especifica los elementos gd:extendedProperty. Para obtener una lista de los valores admitidos, consulta Valores de proyección.
  • SELF_LINK: Es un valor numérico único que representa un solo contacto compartido, por ejemplo, 12345.

Luego, el servidor muestra un código de estado HTTP 200 OK y una entrada que contiene el contacto.

Por ejemplo, para obtener un contacto compartido de un dominio con el vínculo propio configurado en https://www.google.com/m8/feeds/contacts/example.com/full/12345, envía la siguiente solicitud HTTP:

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

Próximos pasos