L'API Domain Shared Contacts permet aux applications d'obtenir et de mettre à jour des contacts externes partagés avec tous les utilisateurs d'un domaine Google Workspace. Les contacts partagés sont visibles par tous les utilisateurs d'un domaine Google Workspace, et tous les services Google ont accès à la liste de contacts.
Utilisez l'API Domain Shared Contacts pour créer, modifier ou supprimer des contacts partagés, et pour rechercher des contacts correspondant à des critères spécifiques.
L'API Domain Shared Contacts n'est disponible que pour les comptes Google Workspace. Pour utiliser l'API, activez l'API Domain Shared Contacts dans la console d'administration. Un délai maximal de 24 heures peut être nécessaire pour que les modifications soient prises en compte dans la saisie semi-automatique et dans le gestionnaire de contacts.
Ce document fournit des informations générales sur l'API Domain Shared Contacts et des exemples de gestion des contacts à l'aide de XML et HTTP. Pour en savoir plus, consultez les bibliothèques clientes.
Audience
Ce document est destiné aux développeurs qui écrivent des applications clientes manipulant des listes de contacts Google à l'aide de HTTP et XML. Il suppose que vous connaissez le protocole des API Google Data.
Les utilisateurs de Linux et macOS peuvent essayer les exemples de ce document à l'aide de curl ou wget. Consultez Utiliser curl avec les API Google Data.
Principes
L'API Domain Shared Contacts suit les principes des API Google Data. Les API Google Data sont basées sur Atom 1.0, RSS 2.0 et le protocole de publication Atom.
Spécifier une version
Toutes les requêtes envoyées à l'aide de l'API Domain Shared Contacts doivent spécifier la version 3.0 :
GData-Version: 3.0
Si vous ne pouvez pas définir d'en-têtes HTTP, spécifiez v=3.0 comme paramètre de requête.
La méthode d'en-tête HTTP est recommandée.