L'API Domain Shared Contacts permet à vos applications d'obtenir et de mettre à jour des contacts externes les contacts partagés avec tous les utilisateurs d'un domaine Google Workspace. Partagées les contacts sont visibles par tous les utilisateurs d'un domaine Google Workspace services 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 les contacts partagés correspondant à un des critères particuliers.
L'API Domain Shared Contacts n'est disponible que pour les comptes Google Workspace. Pour utiliser l'API, activer l'API Domain Shared Contacts dans la console d'administration ; Il peut s'écouler jusqu'à 24 heures avant que les modifications apportées aux contacts partagés ne soient répercutées dans l'e-mail la saisie semi-automatique des adresses et le gestionnaire de contacts.
En plus de fournir des informations générales sur les capacités du API Domain Shared Contacts, ce document propose des exemples de gestion des contacts via XML et HTTP. Lisez ce document pour en savoir plus d'interagir avec l'API à l'aide de notre bibliothèques clientes.
Audience
Ce document est destiné aux développeurs qui souhaitent écrire des applications clientes qui peuvent manipuler les listes de contacts de Google via 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 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. 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 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 comme paramètre de requête dans
l'URL, mais la méthode d'en-tête HTTP est recommandée.