La API de Domain Shared Contacts permite que tus aplicaciones obtengan y actualicen los contactos externos que se comparten con todos los usuarios de un dominio de Google Workspace. Todos los usuarios de un dominio de Google Workspace pueden ver los contactos compartidos, 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 contactos compartidos que coincidan con criterios particulares.
La API de Domain Shared Contacts solo está disponible para 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 el autocompletado de direcciones de correo electrónico y en el administrador de contactos.
Además de proporcionar información sobre las funciones de la API de Domain Shared Contacts, este documento ofrece ejemplos sobre cómo administrar los contactos con XML y HTTP. Después de leer este documento, puedes obtener más información para interactuar con la API con nuestras bibliotecas cliente.
Público
Este documento está dirigido a desarrolladores que deseen escribir aplicaciones cliente que puedan manipular las listas de contactos de Google mediante HTTP y XML. En este documento, se supone que comprendes los conceptos básicos del protocolo de las APIs de Google Data.
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 de Atom.
Especifica 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.