Descripción general de la API de Domain Shared Contacts

La API de contactos compartidos con el dominio permite que tus aplicaciones obtengan y actualicen contactos externos que se comparten con todos los usuarios en 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 contactos compartidos con el dominio para crear contactos compartidos, editar o borrar contactos compartidos existentes, y consultar contactos compartidos que coincidan con criterios en particular.

La API de contactos compartidos con el dominio solo está disponible para cuentas de Google Workspace. Para usar la API, habilita la API de contactos compartidos por el dominio en la Consola del administrador. Los cambios de contactos compartidos pueden demorar hasta 24 horas en reflejarse en la función de autocompletar la dirección de correo electrónico y en el administrador de contactos.

Además de proporcionar información general sobre las funciones de la API de Domains Shared Contacts, en este documento se ofrecen ejemplos para administrar contactos mediante XML y HTTP. Después de leer este documento, puedes obtener más información sobre cómo interactuar con la API mediante 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 detrás 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 sobre cómo usar cURL con los servicios de datos de Google.

Principios

Esta versión de la API de contactos compartidos con el dominio sigue los principios de las APIs de datos de Google. Las APIs de datos de Google se basan en los formatos de distribución Atom 1.0 y RSS 2.0, además del Atom Publishing Protocol.

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 configurar 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.