Se usó la API de Cloud Translation para traducir esta página.

Obtener contactos compartidos

Puedes solicitar contactos de usuarios compartidos de varias maneras:

Todos los contactos compartidos
Un conjunto de contactos que coinciden con un criterio especificado
Un solo contacto compartido
Una foto de un contacto

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

Cómo obtener todos los contactos compartidos

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. El siguiente es 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>

El feed no muestra más de 10 MB en una sola respuesta. Para obtener la lista de contactos completa, sigue repetidamente el vínculo Siguiente del feed que se muestra hasta que ya no lo veas en el feed.

Obtén contactos compartidos con parámetros de consulta

Puedes solicitar un conjunto de contactos que coincidan con criterios especificados, como solicitar contactos actualizados después de una fecha determinada. No se admite la búsqueda de texto completo ni la ubicación de un contacto por dirección de correo electrónico. Para obtener una lista completa de los parámetros de consulta admitidos, consulta la guía de referencia de la API de Domain Shared Contacts.

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 compatibles. Para obtener más información, consulta la guía de referencia de la API de Domain Shared Contacts.
Por ejemplo, para obtener todas las entradas de contacto compartidas del dominio actualizadas después del 16 de marzo de 2022 para example.com, envía una solicitud HTTP a la URL del feed de contactos compartidos 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 de 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.
El feed no muestra más de 10 MB en una sola respuesta. Para obtener la lista de contactos completa con los criterios especificados, sigue repetidamente el vínculo Siguiente del feed que se muestra hasta que ya no lo veas en el feed.

Realiza un seguimiento de los cambios incrementales

Para hacer un seguimiento de los cambios incrementales en una lista de contactos compartida de un dominio, haz lo siguiente: 1. Cuando envíes una solicitud para un feed, haz un seguimiento del valor del elemento <updated> del feed. 1. Para obtener solo los contactos compartidos del dominio que cambiaron desde la solicitud anterior, configura el parámetro de consulta updated-min en ese valor <updated> y configura 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 directo del contacto compartido si encuentras su entrada en el feed de contactos compartidos. Si no sabes qué valor usar para el vínculo a sí mismo, consulta Cómo obtener todos los contactos y Cómo obtener contactos con parámetros de consulta.

Para obtener un contacto compartido de un dominio específico, envía una solicitud HTTP GET al vínculo directo 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 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

Cómo obtener una foto para un contacto compartido