Présentation de l'API Domain Shared Contacts

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 des contacts partagés, modifier ou supprimer des contacts partagés existants, et rechercher des contacts partagés qui répondent à 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. Il peut s'écouler jusqu'à 24 heures avant que les modifications apportées aux contacts partagés ne soient répercutées 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 propose des exemples de gestion des contacts à l'aide de XML et HTTP. Après avoir lu ce document, vous pouvez utiliser nos bibliothèques clientes pour en savoir plus sur l'interaction avec l'API.

Audience

Ce document est destiné aux développeurs qui souhaitent créer des applications clientes pouvant manipuler les listes de contacts de 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 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, en plus du protocole de publication Atom.

Spécifier une version

Chaque requête envoyée à 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 de l'en-tête HTTP est recommandée.