La API de Domain Shared Contacts permite que las aplicaciones obtengan y actualicen los contactos externos compartidos 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.
Usa la API de Domain Shared Contacts para crear, editar o borrar contactos compartidos, y para consultar contactos que coincidan con criterios específicos.
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 pueden tardar hasta 24 horas en reflejarse en la función de autocompletar y en el administrador de contactos.
En este documento, se proporciona información general sobre la API de Domain Shared Contacts y ejemplos para administrar contactos con XML y HTTP. Para obtener más información, consulta las bibliotecas cliente.
Público
Este documento está dirigido a los desarrolladores que escriben aplicaciones cliente que manipulan listas de contactos de Google con HTTP y XML. Se supone que tienes conocimientos sobre el protocolo de las APIs de Google Data.
Los usuarios de Linux y macOS pueden probar los ejemplos de este documento con curl o wget. Consulta Cómo usar curl con las APIs de datos de Google.
Principios
La API de Domain Shared Contacts sigue los principios de las APIs de Google Data. Las APIs de Google Data se basan en Atom 1.0, RSS 2.0 y el protocolo de publicación de Atom.
Cómo especificar una versión
Todas las solicitudes enviadas con la API de Domain Shared Contacts deben especificar la versión 3.0:
GData-Version: 3.0
Si no puedes establecer encabezados HTTP, especifica v=3.0 como un parámetro de consulta.
Se recomienda el método de encabezado HTTP.