L'API Domain Shared Contacts permet à vos applications d'obtenir et de mettre à jour les 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, modifier ou supprimer des contacts partagés, et interroger des contacts partagés correspondant à un critère particulier.
L'API Domain Shared Contacts n'est disponible que pour les comptes Google Workspace. Pour utiliser l'API, activez-la dans la console d'administration. Un délai de 24 heures peut être nécessaire avant que les modifications apportées aux contacts partagés n'apparaissent dans la saisie semi-automatique des adresses 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 fournit des exemples sur la gestion des contacts à l'aide de XML et de HTTP. Après avoir lu ce document, découvrez comment interagir avec l'API à l'aide de nos bibliothèques clientes.
Audience
Ce document est destiné aux développeurs qui souhaitent créer des applications clientes capables de manipuler les listes de contacts Google à l'aide des protocoles HTTP et XML. Dans ce document, nous partons du principe 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 présentés dans ce document sans écrire de code, utilisez les utilitaires de ligne de commande 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, en plus du 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:
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. Toutefois, la méthode d'en-tête HTTP est recommandée.