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:
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:
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.
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 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:
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
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-03-25 (UTC)"],[],[],null,["# Get shared contacts\n\nYou can request shared user contacts in a variety of\nways:\n\n- All shared contacts\n- A set of contacts that match a specified criteria\n- A single shared contact\n- A photo for a contact\n\nBy default, the entries in a feed aren't ordered.\n\nGet all shared contacts\n-----------------------\n\n1. To get all shared contacts, send an HTTP `GET` request to the\n contacts feed URL:\n\n ```xml\n GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDOMAIN\u003c/var\u003e: The URL for your domain---for example, example.com.\n - \u003cvar translate=\"no\"\u003ePROJECTION\u003c/var\u003e: The projection value that specifies the `gd:extendedProperty` elements. For a list of supported values, see [Projection values](/workspace/admin/domain-shared-contacts/extended-properties-projections#projection_values).\n\n The feed returns an `HTTP 200 OK` status code and a standard Atom 1.0\n feed containing the contacts. The following is an example of a contacts\n feed with only one entry: \n\n ```xml\n \u003cfeed xmlns='http://www.w3.org/2005/Atom'\n xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'\n xmlns:gd='http://schemas.google.com/g/2005'\n xmlns:gContact='http://schemas.google.com/contact/2008'\n xmlns:batch='http://schemas.google.com/gdata/batch'\u003e\n \u003cid\u003ehttps://www.google.com/m8/feeds/contacts/example.com/base\u003c/id\u003e\n \u003cupdated\u003e2008-03-05T12:36:38.836Z\u003c/updated\u003e\n \u003ccategory scheme='http://schemas.google.com/g/2005#kind'\n term='http://schemas.google.com/contact/2008#contact' /\u003e\n \u003ctitle type='text'\u003eexample.com's Contacts\u003c/title\u003e\n \u003clink rel='http://schemas.google.com/g/2005#feed'\n type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full' /\u003e\n \u003clink rel='http://schemas.google.com/g/2005#post'\n type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full' /\u003e\n \u003clink rel='http://schemas.google.com/g/2005#batch'\n type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' /\u003e\n \u003clink rel='self' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' /\u003e\n \u003cauthor\u003e\n \u003cname\u003eexample.com\u003c/name\u003e\n \u003cemail\u003eexample.com\u003c/email\u003e\n \u003c/author\u003e\n \u003cgenerator version='1.0' uri='https://www.google.com/m8/feeds/contacts'\u003e\n Contacts\n \u003c/generator\u003e\n \u003copenSearch:totalResults\u003e1\u003c/openSearch:totalResults\u003e\n \u003copenSearch:startIndex\u003e1\u003c/openSearch:startIndex\u003e\n \u003copenSearch:itemsPerPage\u003e25\u003c/openSearch:itemsPerPage\u003e\n \u003centry\u003e\n \u003cid\u003e\n https://www.google.com/m8/feeds/contacts/example.com/base/c9012de\n \u003c/id\u003e\n \u003cupdated\u003e2008-03-05T12:36:38.835Z\u003c/updated\u003e\n \u003ccategory scheme='http://schemas.google.com/g/2005#kind'\n term='http://schemas.google.com/contact/2008#contact' /\u003e\n \u003ctitle type='text'\u003eFitzgerald\u003c/title\u003e\n \u003cgd:name\u003e\n \u003cgd:fullName\u003eFitzgerald\u003c/gd:fullName\u003e\n \u003c/gd:name\u003e\n \u003clink rel=\"http://schemas.google.com/contacts/2008/rel#photo\" type=\"image/*\"\n href=\"http://google.com/m8/feeds/photos/media/example.com/c9012de\"/\u003e\n \u003clink rel='self' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' /\u003e\n \u003clink rel='edit' type='application/atom+xml'\n href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' /\u003e\n \u003cgd:phoneNumber rel='http://schemas.google.com/g/2005#home'\n primary='true'\u003e\n 456\n \u003c/gd:phoneNumber\u003e\n \u003cgd:extendedProperty name=\"pet\" value=\"hamster\" /\u003e\n \u003c/entry\u003e\n \u003c/feed\u003e\n ```\n2. The feed doesn't return more than 10MB in a single response. To\n get the entire contact list, repeatedly follow the returned feed's\n **Next** link until you no longer see that link in the return feed.\n\nGet shared contacts by using query parameters\n---------------------------------------------\n\nYou can request a set of contacts that match a specified\ncriteria, such as requesting contacts updated after a given date. There is no\nsupport for full-text queries or locating a contact by email address. For a\ncomplete list of supported query parameters, see\n[Domain Shared Contacts API reference guide](https://developers.google.com/workspace/admin/domain-shared-contacts#Parameters).\n\n1. Send an `HTTP GET` request to the contacts feed URL with a defined\n parameter:\n\n ```xml\n GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDOMAIN\u003c/var\u003e: The URL for your domain---for example, example.com.\n - \u003cvar translate=\"no\"\u003ePROJECTION\u003c/var\u003e: The projection value that specifies the `gd:extendedProperty` elements. For a list of supported values, see [Projection values](/workspace/admin/domain-shared-contacts/extended-properties-projections#projection_values).\n - \u003cvar translate=\"no\"\u003ePARAMETER\u003c/var\u003e: One of the supported query parameters. For more information, see [Domain Shared Contacts API reference guide](/workspace/admin/domain-shared-contacts/contacts-feed).\n\n For example, to get all the domain shared contact entries updated after\n March 16, 2022 for example.com, send an HTTP request to the domain shared\n contact feed URL and add the `updated-min` parameter to the request URL: \n\n ```\n GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00\n ```\n\n When you send that `GET` request, the server returns an HTTP `200 OK`\n status code and a feed containing any domain shared contacts that were\n created or updated after the date specified.\n2. The feed doesn't return more than 10MB in a single response. To\n get the entire contact list with the specified criteria, repeatedly\n follow the returned feed's **Next** link until you no longer see that link\n in the return feed.\n\n### Track incremental changes\n\nTo track incremental changes to a domain shared contact list, do the\nfollowing:\n1. When you send a request for a feed, keep track of the value of the\nfeed's `\u003cupdated\u003e` element.\n1. You can get only the domain shared contacts that have changed since\nthe previous request by setting the query parameter\n`updated-min` to that `\u003cupdated\u003e` value, and setting\n`showdeleted` to `true`.\n\nGet a single shared contact\n---------------------------\n\nTo get a single shared contact, you must use the contact's self link. You can\nonly get the shared contact's self link by locating the contact's entry in the\nshared contacts feed. If you're not sure what value to use for the self link,\nsee [Get all contacts](#get_all_shared_contacts)\nand\n[Get contacts by using query parameters](#get_shared_contacts_by_using_query_parameters).\n\n1. To get a specific domain shared contact, send an HTTP `GET` request to the self link of a contact: \n\n ```xml\n GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK\u003e\n ```\n Replace the following:\n\n- \u003cvar translate=\"no\"\u003eDOMAIN\u003c/var\u003e: The URL for your domain---for example, example.com.\n- \u003cvar translate=\"no\"\u003ePROJECTION\u003c/var\u003e: The projection value that specifies the `gd:extendedProperty` elements. For a list of supported values, see [Projection values](/workspace/admin/domain-shared-contacts/extended-properties-projections#projection_values).\n- \u003cvar translate=\"no\"\u003eSELF_LINK\u003c/var\u003e: A unique numerical value that represents a single shared contact---for example, 12345.\n\nThe server then returns an HTTP `200 OK` status code and an entry containing the\ncontact.\n\nFor example, to get a domain shared contact with self link set to\n`https://www.google.com/m8/feeds/contacts/example.com/full/12345`, send the\nfollowing HTTP request: \n\n```\nGET https://www.google.com/m8/feeds/contacts/example.com/full/12345\n```\n\nNext steps\n----------\n\n- [Get a photo for a shared contact](/workspace/admin/domain-shared-contacts/get-photo-shared-contacts)"]]
