La API de Domain Shared Contacts permite que tus aplicaciones obtengan y actualicen contactos externos que se comparten con todos los usuarios de un dominio de Google Workspace. Los contactos compartidos son visibles para todos los usuarios de un dominio de Google Workspace, y todos los servicios de Google tienen acceso a la lista de contactos.
Tu aplicación puede usar la API de Domain Shared Contacts para crear contactos compartidos, editar o borrar contactos compartidos existentes, y consultar los contactos compartidos que coinciden con un criterio en particular.
La API de Domain Shared Contacts solo está disponible para las cuentas de Google Workspace. Para usar la API, habilita la API de Domain Shared Contacts en la consola del administrador. Los cambios en los contactos compartidos pueden tardar hasta 24 horas en reflejarse en la función de autocompletar direcciones de correo electrónico y en el administrador de contactos.
Además de proporcionar información general sobre las capacidades de la API de Domain Shared Contacts, este documento ofrece ejemplos sobre cómo administrar contactos con XML y HTTP. Después de leer este documento, puedes obtener más información para interactuar con la API a través de nuestras bibliotecas cliente.
Público
Este documento está dirigido a los desarrolladores que desean escribir aplicaciones cliente que puedan manipular las listas de contactos de Google con HTTP y XML. En este documento, se supone que comprendes los conceptos básicos del protocolo de las APIs de datos de Google.
Si usas un sistema operativo UNIX y quieres probar los ejemplos de este documento sin escribir ningún código, usa las utilidades de línea de comandos de UNIX curl o wget. Obtén más información para usar cURL con los servicios de datos de Google.
Principios
Esta versión de la API de Domain Shared Contacts sigue los principios de las APIs de datos de Google. Las APIs de Google Data se basan en los formatos de sindicación Atom 1.0 y RSS 2.0, además del protocolo de publicación Atom.
Cómo especificar una versión
Cada solicitud que envíes con la API de Domain Shared Contacts debe especificar la versión 3.0 de la API:
GData-Version: 3.0
Si no puedes establecer encabezados HTTP, puedes especificar v=3.0 como un parámetro de consulta en la URL, pero se recomienda el método de encabezado HTTP.