Cette page a été traduite par l'API Cloud Translation.

Class ContactsApp

Obsolète. Utilisez plutôt le service avancé de l'API People.

Cette classe permet aux utilisateurs d'accéder à leurs propres contacts Google et de créer, supprimer et mettre à jour les contacts listés.

Propriétés obsolètes

Propriété	Type	Description
`ExtendedField`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`createContact(givenName, familyName, email)`	`Contact`	Crée un contact.
`createContactGroup(name)`	`ContactGroup`	Crée un groupe de contacts avec le nom donné // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`deleteContact(contact)`	`void`	Supprime le contact.
`deleteContactGroup(group)`	`void`	Supprime le groupe de contacts // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`findByEmailAddress(email)`	`Contact`	Recherche un contact avec l'adresse e-mail indiquée.
`findContactGroup(name)`	`ContactGroup`	Recherche un groupe de contacts portant le nom donné.
`getAllContacts()`	`Contact[]`	Récupérez tous les contacts appartenant à cet utilisateur.
`getContact(emailAddress)`	`Contact`	Récupère un contact par adresse e-mail.
`getContactById(id)`	`Contact`	Récupère le contact associé à cet ID.
`getContactGroup(name)`	`ContactGroup`	Récupère un groupe de contacts portant le nom donné ou renvoie la valeur null si aucun groupe de contacts de ce type n'est trouvé.
`getContactGroupById(id)`	`ContactGroup`	Récupère un groupe de contacts avec l'ID donné ou renvoie la valeur "null" si aucun groupe de contacts de ce type n'est trouvé.
`getContactGroups()`	`ContactGroup[]`	Récupère la liste complète des groupes de contacts de l'utilisateur.
`getContacts()`	`Contact[]`	Récupère tous les contacts de l'utilisateur.
`getContactsByAddress(query)`	`Contact[]`	Obtenir les contacts correspondant à une adresse
`getContactsByAddress(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse, limités à un champ spécifique.
`getContactsByAddress(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse, limités au libellé d'adresse personnalisé spécifié.
`getContactsByCompany(query)`	`Contact[]`	Obtenez les contacts correspondant au champ "Entreprise".
`getContactsByCustomField(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une valeur donnée dans un champ personnalisé.
`getContactsByDate(month, day, label)`	`Contact[]`	Obtenez les contacts correspondant à un mois et un jour donnés pour un champ standard spécifique.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Obtenez les contacts correspondant à un mois, un jour et une année donnés pour un champ standard spécifique.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Obtenez les contacts correspondant à un mois, un jour et une année donnés pour un champ personnalisé spécifique.
`getContactsByDate(month, day, label)`	`Contact[]`	Obtenez les contacts correspondant à un mois et un jour donnés pour un champ personnalisé spécifique.
`getContactsByEmailAddress(query)`	`Contact[]`	Obtenir les contacts correspondant à une adresse e-mail
`getContactsByEmailAddress(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse e-mail, limités à un champ spécifique.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse e-mail, limitée à l'étiquette d'adresse e-mail personnalisée spécifiée.
`getContactsByGroup(group)`	`Contact[]`	Obtenez les contacts d'un ContactGroup donné.
`getContactsByIM(query)`	`Contact[]`	Obtenir les contacts correspondant à une adresse de messagerie instantanée
`getContactsByIM(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse de messagerie instantanée, limitée à un champ spécifique.
`getContactsByIM(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une adresse de messagerie instantanée, limitée au libellé de messagerie instantanée personnalisée spécifié.
`getContactsByJobTitle(query)`	`Contact[]`	Obtenez les contacts correspondant au champ "Fonction".
`getContactsByName(query)`	`Contact[]`	Obtenir les contacts correspondant à un nom
`getContactsByName(query, label)`	`Contact[]`	Obtenez les contacts correspondant à un nom, limités à un champ spécifique.
`getContactsByNotes(query)`	`Contact[]`	Obtenir les contacts correspondant au champ "Notes"
`getContactsByPhone(query)`	`Contact[]`	Obtenir les contacts correspondant à un numéro de téléphone
`getContactsByPhone(query, label)`	`Contact[]`	Récupérez les contacts correspondant à un numéro de téléphone, limités à un champ spécifique.
`getContactsByPhone(query, label)`	`Contact[]`	Obtenez les contacts correspondant à un numéro de téléphone, limités au libellé de numéro de téléphone personnalisé spécifié.
`getContactsByUrl(query)`	`Contact[]`	Obtenir les contacts correspondant à une URL
`getContactsByUrl(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une URL, limités à un champ spécifique.
`getContactsByUrl(query, label)`	`Contact[]`	Obtenez les contacts correspondant à une URL, limités au libellé d'URL personnalisée spécifié.

Méthodes obsolètes

`createContact(givenName, familyName, email)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Crée un contact.

// The code below creates a new contact with the name "John Doe" and the email
// address "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

Paramètres

Nom	Type	Description
`givenName`	`String`	le prénom du contact ;
`familyName`	`String`	le nom de famille du contact ;
`email`	`String`	l'adresse e-mail du contact ;

Renvois

Contact : objet Contact que vous venez de créer

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

deleteContact(contact)

`createContactGroup(name)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Crée un groupe de contacts avec le nom donné

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

Paramètres

Nom	Type	Description
`name`	`String`	le nom du nouveau groupe de contacts ;

Renvois

ContactGroup : groupe de contacts nouvellement créé

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

deleteContactGroup(group)

`deleteContact(contact)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Supprime le contact.

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Paramètres

Nom	Type	Description
`contact`	`Contact`	le contact à supprimer ;

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

createContact(givenName, familyName, email)

`deleteContactGroup(group)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Supprime le groupe de contacts

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

Paramètres

Nom	Type	Description
`group`	`ContactGroup`	le groupe de contacts à supprimer

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

createContactGroup(name)

`findByEmailAddress(email)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Recherche un contact avec l'adresse e-mail indiquée.

Paramètres

Nom	Type	Description
`email`	`String`	l'adresse e-mail du contact à trouver ;

Renvois

Contact : contact contenant cette adresse e-mail

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

`findContactGroup(name)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Recherche un groupe de contacts portant le nom donné.

Paramètres

Nom	Type	Description
`name`	`String`	Nom du groupe de contacts à rechercher

Renvois

ContactGroup : groupe de contacts correspondant au nom donné

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

`getAllContacts()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupérez tous les contacts appartenant à cet utilisateur.

Renvois

Contact[] : tous les contacts de cet utilisateur

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

`getContact(emailAddress)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère un contact par adresse e-mail.

Si plusieurs contacts partagent la même adresse e-mail, la méthode privilégie ceux qui ont marqué l'adresse e-mail comme principale. Si aucun des contacts n'a marqué l'adresse e-mail comme principale ou si plusieurs contacts l'ont fait, le premier résultat de la liste de contacts triée est renvoyé.

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

Paramètres

Nom	Type	Description
`emailAddress`	`String`	l'adresse e-mail du contact ;

Renvois

Contact : contact contenant cette adresse e-mail

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

`getContactById(id)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère le contact associé à cet ID.

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

Paramètres

Nom	Type	Description
`id`	`String`	ID du contact à récupérer

Renvois

Contact : contact correspondant ou valeur nulle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactGroup(name)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère un groupe de contacts portant le nom donné ou renvoie la valeur null si aucun groupe de contacts de ce type n'est trouvé.

// The code below returns the contact group with the name "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');

Paramètres

Nom	Type	Description
`name`	`String`	Nom du groupe de contacts à faire correspondre

Renvois

ContactGroup : groupe de contacts correspondant ou valeur nulle si aucun groupe de contacts correspondant n'est trouvé

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContactGroups()

`getContactGroupById(id)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère un groupe de contacts avec l'ID donné ou renvoie la valeur "null" si aucun groupe de contacts de ce type n'est trouvé.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

Paramètres

Nom	Type	Description
`id`	`String`	ID du groupe de contacts à faire correspondre

Renvois

ContactGroup : groupe de contacts correspondant ou valeur nulle si aucun groupe de contacts correspondant n'est trouvé

Voir aussi

getContactGroups()

`getContactGroups()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère la liste complète des groupes de contacts de l'utilisateur.

Un utilisateur peut avoir une liste de contacts et éventuellement une liste de groupes de contacts. Chaque groupe de contacts peut contenir des contacts. Cette méthode renvoie la liste de tous les groupes de contacts.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Renvois

ContactGroup[] : tableau des groupes de contacts de l'utilisateur

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContactGroup(name)

`getContacts()`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupère tous les contacts de l'utilisateur.

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

Renvois

Contact[] : tableau de tous les contacts de l'utilisateur

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByAddress(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à une adresse

// The code below returns an array of contacts where the contact's address
// contains "San Francisco'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les adresses des contacts

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByAddress(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse, limités à un champ spécifique.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les adresses des contacts
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByAddress(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse, limités au libellé d'adresse personnalisé spécifié.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in a custom address label (created by the user)
// called "vacation".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les adresses du contact avec l'étiquette d'adresse personnalisée spécifiée
`label`	`String`	le libellé d'adresse personnalisé dans lequel effectuer la recherche ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByCompany(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant au champ "Entreprise".

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans le champ "Entreprise" du contact

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByCustomField(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une valeur donnée dans un champ personnalisé.

Le champ personnalisé peut être spécifié par une chaîne ou comme l'une des valeurs ContactsApp.ExtendedField.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

Paramètres

Nom	Type	Description
`query`	`Object`	la chaîne à rechercher dans le champ personnalisé du contact ;
`label`	`ExtendedField`	le champ personnalisé dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un mois et un jour donnés pour un champ standard spécifique.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Paramètres

Nom	Type	Description
`month`	`Month`	le mois à faire correspondre, parmi les valeurs de ContactsApp.Month
`day`	`Integer`	le jour à faire correspondre ;
`label`	`Field`	le champ dans lequel effectuer la recherche, à partir de ContactsApp.Field

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un mois, un jour et une année donnés pour un champ standard spécifique.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month, 19 for the day, and 1950 for the year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Paramètres

Nom	Type	Description
`month`	`Month`	le mois à faire correspondre, parmi les valeurs de ContactsApp.Month
`day`	`Integer`	le jour à faire correspondre ;
`year`	`Integer`	l'année à faire correspondre (peut être nulle) ;
`label`	`Field`	le champ dans lequel effectuer la recherche, à partir de ContactsApp.Field

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un mois, un jour et une année donnés pour un champ personnalisé spécifique.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month, 19 for the day, and 2011 for the
// year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Paramètres

Nom	Type	Description
`month`	`Month`	le mois à faire correspondre, parmi les valeurs de ContactsApp.Month
`day`	`Integer`	le jour à faire correspondre ;
`year`	`Integer`	l'année à faire correspondre (peut être nulle) ;
`label`	`String`	le champ personnalisé dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un mois et un jour donnés pour un champ personnalisé spécifique.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Paramètres

Nom	Type	Description
`month`	`Month`	le mois à faire correspondre, parmi les valeurs de ContactsApp.Month
`day`	`Integer`	le jour à faire correspondre ;
`label`	`String`	le champ personnalisé dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByEmailAddress(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à une adresse e-mail

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les adresses e-mail des contacts ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse e-mail, limités à un champ spécifique.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les adresses e-mail des contacts ;
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse e-mail, limitée à l'étiquette d'adresse e-mail personnalisée spécifiée.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les adresses e-mail des contacts avec le libellé d'adresse e-mail personnalisé spécifié
`label`	`String`	l'étiquette de l'adresse e-mail personnalisée à rechercher

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByGroup(group)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts d'un ContactGroup donné.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

Paramètres

Nom	Type	Description
`group`	`ContactGroup`	le groupe de contacts

Renvois

Contact[] : tableau des contacts du groupe donné

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByIM(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à une adresse de messagerie instantanée

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in any instant messaging field.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les adresses de messagerie instantanée du contact ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByIM(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse de messagerie instantanée, limitée à un champ spécifique.

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les adresses de messagerie instantanée du contact ;
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByIM(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une adresse de messagerie instantanée, limitée au libellé de messagerie instantanée personnalisée spécifié.

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in a custom instant messaging
// label (created by the user) called "eBuddy".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les adresses de chat du contact avec le libellé de chat personnalisé spécifié
`label`	`String`	le libellé de messagerie instantanée personnalisé dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByJobTitle(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant au champ "Fonction".

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans le champ "Fonction" du contact

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByName(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à un nom

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les noms de contact

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByName(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un nom, limités à un champ spécifique.

// The code below returns an array of contacts where the contact name contains
// "John" in the Given Name field.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les noms de contact
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByNotes(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant au champ "Notes"

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans le champ "Notes" du contact ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByPhone(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à un numéro de téléphone

Cette méthode développe les numéros de téléphone avec des lettres. Par conséquent, si vous recherchez "212-555-CODE" et que vous avez "212-555-2633" dans vos contacts ou inversement, la méthode trouvera le contact approprié.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234' in any phone number field.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les numéros de téléphone des contacts ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByPhone(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Récupérez les contacts correspondant à un numéro de téléphone, limités à un champ spécifique.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les numéros de téléphone des contacts
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByPhone(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à un numéro de téléphone, limités au libellé de numéro de téléphone personnalisé spécifié.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in a custom phone number label (created by the user)
// called "alternate".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les numéros de téléphone des contacts avec le libellé de numéro de téléphone personnalisé spécifié
`label`	`String`	le libellé du numéro de téléphone personnalisé à rechercher

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByUrl(query)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenir les contacts correspondant à une URL

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les URL des contacts ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByUrl(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une URL, limités à un champ spécifique.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

Paramètres

Nom	Type	Description
`query`	`String`	la chaîne à rechercher dans les URL des contacts ;
`label`	`Field`	champ dans lequel effectuer la recherche

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)

`getContactsByUrl(query, label)`

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans les nouveaux scripts.

Obtenez les contacts correspondant à une URL, limités au libellé d'URL personnalisée spécifié.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

Paramètres

Nom	Type	Description
`query`	`String`	Chaîne à rechercher dans les URL des contacts avec le libellé d'URL personnalisée spécifié
`label`	`String`	l'étiquette d'URL personnalisée dans laquelle effectuer la recherche ;

Renvois

Contact[] : tableau des contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

https://www.google.com/m8/feeds

Voir aussi

getContact(emailAddress)