Important: Migrez vos scripts du service Contacts vers le service avancé de l'API People avant qu'Apps Script n'arrête le service Contacts en mars 2023.
Apps Script a abandonné le service Contacts le 16 décembre 2022. Utilisez plutôt le service avancé de l'API People. L'API People utilise un protocole JSON plus récent et fournit des fonctionnalités avancées, telles que la fusion de contacts avec des profils.
Consultez ce guide pour découvrir quelles méthodes du service Contacts n'ont pas d'équivalent dans le service avancé de l'API People, découvrir ce que vous pouvez utiliser à la place et trouver des exemples de code pour migrer des tâches courantes. Pour plus d'informations, consultez le guide de migration de l'API Contacts.
Méthodes sans équivalents dans l'API People
Voici la liste des méthodes getContacts
du service Contacts qui n'ont pas de méthodes équivalentes pour rechercher des contacts dans le service avancé de l'API People. Avec le service avancé de l'API People, vous pouvez effectuer une recherche en fonction des champs names
, nickNames
, emailAddresses
, phoneNumbers
et organizations
d'un contact qui proviennent de la source CONTACT
.
Méthodes sans équivalents |
---|
|
Voici la liste des méthodes getContacts
du service Contacts qui utilisent un paramètre label
supplémentaire. Vous pouvez utiliser la méthode searchContacts
du service avancé de l'API People pour obtenir des contacts en fonction du champ équivalent, mais vous ne pouvez pas limiter la recherche à un libellé spécifique.
Méthodes avec équivalents partiels |
---|
|
Fonctionnalités supplémentaires disponibles avec l'API People
Lorsque vous passez au service avancé de l'API People, vous avez accès aux fonctionnalités suivantes de l'API People, qui ne sont pas disponibles dans le service Contacts:
- Spécifier la source de données : lorsque vous recherchez des informations sur une personne, vous pouvez spécifier où effectuer la recherche, comme un contact Google ou un profil Google.
- Rechercher des personnes à l'aide d'une chaîne de requête : vous pouvez obtenir la liste des profils et des contacts correspondant à une chaîne spécifique.
- Requêtes par lot : vous pouvez regrouper vos appels d'API People pour réduire le temps d'exécution de votre script.
Exemples de code pour les tâches courantes
Cette section liste les tâches courantes du service Contacts. Les exemples de code montrent comment créer les tâches à l'aide du service avancé de l'API People.
Obtenir un groupe de contacts par nom
L'exemple de code suivant montre comment obtenir un groupe de contacts par son nom, équivalent à getContactGroup(name)
dans le service Contacts.
Obtenir un contact par adresse e-mail
L'exemple de code suivant montre comment obtenir un contact à partir de son adresse e-mail, ce qui équivaut à getContact(emailAddress)
dans le service Contacts.
Obtenir tous les contacts
L'exemple de code suivant montre comment obtenir tous les contacts d'un utilisateur, ce qui équivaut à getContacts()
dans le service Contacts.
Obtenir le nom complet d'un contact
L'exemple de code suivant montre comment obtenir le nom complet d'un contact, qui correspond à getFullName()
dans le service Contacts.
Obtenir tous les numéros de téléphone d'un contact
L'exemple de code suivant montre comment obtenir tous les numéros de téléphone d'un contact, équivalent à getPhones()
dans le service Contacts.
Obtenir le numéro de téléphone d'un contact
L'exemple de code suivant montre comment obtenir le numéro de téléphone d'un contact, équivalent à getPhoneNumber()
dans le service Contacts.