L'API Domain Shared Contacts permet à vos 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.
Votre application peut utiliser l'API Domain Shared Contacts pour créer des contacts partagés, modifier ou supprimer des contacts partagés existants, et rechercher des contacts partagés qui correspondent à un critère particulier.
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 de 24 heures peut être nécessaire pour que les modifications apportées aux contacts partagés soient prises en compte dans la saisie semi-automatique de l'adresse e-mail et dans le gestionnaire de contacts.
En plus de fournir des informations générales sur les fonctionnalités de l'API Domain Shared Contacts, ce document propose des exemples de gestion des contacts à l'aide de XML et HTTP. Après avoir lu ce document, vous pouvez en savoir plus sur l'interaction avec l'API à l'aide de nos bibliothèques clientes.
Audience
Ce document est destiné aux développeurs qui souhaitent écrire des applications clientes capables de manipuler les listes de contacts Google à l'aide de HTTP et XML. Ce document suppose que vous comprenez les principes fondamentaux du protocole des API Google Data.
Si vous utilisez un système d'exploitation UNIX et que vous souhaitez essayer les exemples de ce document sans écrire de code, utilisez les utilitaires de ligne de commande UNIX curl ou wget. Découvrez comment utiliser cURL avec les services de données Google.
Principes
Cette version de l'API Domain Shared Contacts suit les principes des API Google Data. Les API Google Data sont basées sur les formats de syndication Atom 1.0 et RSS 2.0, ainsi que sur le protocole de publication Atom.
Spécifier une version
Chaque requête que vous envoyez à l'aide de l'API Domain Shared Contacts doit spécifier la version 3.0 de l'API :
GData-Version: 3.0
Si vous ne pouvez pas définir d'en-têtes HTTP, vous pouvez spécifier v=3.0 en tant que paramètre de requête dans l'URL, mais la méthode d'en-tête HTTP est recommandée.