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. Tous les utilisateurs d'un domaine Google Workspace peuvent voir les contacts partagés, 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 interroger des contacts partagés qui correspondent à des critères particuliers.
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 maximal 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 sur les fonctionnalités de l'API Domain Shared Contacts, ce document propose des exemples de gestion des contacts à l'aide de XML et de 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 pouvant manipuler les listes de contacts de Google à l'aide de HTTP et de XML. Ce document suppose que vous connaissez 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 Google Data.
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.