Class ContactsApp

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 qui y sont répertorié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é
deleteContact(contact)	void	Supprime le contact.
deleteContactGroup(group)	void	Supprime le groupe de contacts
findByEmailAddress(email)	Contact	Recherche un contact associé à l'adresse e-mail indiquée.
findContactGroup(name)	ContactGroup	Recherche un groupe de contacts portant le nom donné.
getAllContacts()	Contact[]	Récupère tous les contacts appartenant à cet utilisateur.
getContact(emailAddress)	Contact	Récupère un contact via l'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 n'est trouvé.
getContactGroupById(id)	ContactGroup	Récupère un groupe de contacts associé à l'identifiant 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[]	Obtenez des contacts correspondant à une adresse.
getContactsByAddress(query, label)	Contact[]	Obtenez des contacts correspondant à une adresse, dans la limite d'un champ spécifique.
getContactsByAddress(query, label)	Contact[]	Permet d'obtenir des contacts correspondant à une adresse, dans la limite du libellé d'adresse personnalisé spécifié.
getContactsByCompany(query)	Contact[]	Obtenir les contacts correspondant au champ de l'entreprise.
getContactsByCustomField(query, label)	Contact[]	Obtenir les contacts correspondant à une valeur donnée dans un champ personnalisé
getContactsByDate(month, day, label)	Contact[]	Permet d'obtenir des contacts correspondant à un jour et un mois donnés pour un champ standard spécifique.
getContactsByDate(month, day, year, label)	Contact[]	Obtenez des 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 des contacts correspondant à un jour et un mois donnés pour un champ personnalisé spécifique.
getContactsByEmailAddress(query)	Contact[]	Trouvez des contacts correspondant à une adresse e-mail.
getContactsByEmailAddress(query, label)	Contact[]	obtenir des contacts correspondant à une adresse e-mail, dans la limite d'un champ spécifique ;
getContactsByEmailAddress(query, label)	Contact[]	Permet d'obtenir des contacts correspondant à une adresse e-mail, dans la limite du libellé d'adresse e-mail personnalisé spécifié.
getContactsByGroup(group)	Contact[]	Récupère les contacts d'un ContactGroup donné.
getContactsByIM(query)	Contact[]	Obtenez des contacts correspondant à une adresse de messagerie instantanée.
getContactsByIM(query, label)	Contact[]	Obtenez des contacts correspondant à une adresse de messagerie instantanée, dans la limite d'un champ spécifique.
getContactsByIM(query, label)	Contact[]	Obtenez des contacts correspondant à une adresse de messagerie instantanée, dans la limite du libellé de messagerie instantané personnalisé spécifié.
getContactsByJobTitle(query)	Contact[]	Obtenez des contacts correspondant au champ "Fonction".
getContactsByName(query)	Contact[]	Obtenez des contacts correspondant à un nom.
getContactsByName(query, label)	Contact[]	obtenir des contacts correspondant à un nom, dans la limite d'un champ spécifique ;
getContactsByNotes(query)	Contact[]	Obtenir les contacts correspondant au champ de notes.
getContactsByPhone(query)	Contact[]	Obtenez des contacts correspondant à un numéro de téléphone.
getContactsByPhone(query, label)	Contact[]	Obtenez des contacts correspondant à un numéro de téléphone, dans la limite d'un champ spécifique.
getContactsByPhone(query, label)	Contact[]	Permet d'obtenir des contacts correspondant à un numéro de téléphone, dans la limite du libellé de numéro de téléphone personnalisé spécifié.
getContactsByUrl(query)	Contact[]	Obtenez des contacts correspondant à une URL.
getContactsByUrl(query, label)	Contact[]	Obtenez des contacts correspondant à une URL, dans la limite d'un champ spécifique.
getContactsByUrl(query, label)	Contact[]	Permet d'obtenir des contacts correspondant à une URL, dans la limite du 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 de nouveaux scripts.

Crée un contact.

// The code below creates a new contact with the name "John Doe" and the email address
// "[e-mail]".
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');

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 nouvellement créé

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

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

// The code below creates a new contact group named "Work Friends"
var 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 associée à 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 de nouveaux scripts.

Supprime le contact.

// The code below retrieves a contact with the email address "[e-mail]"
// and then deletes that contact.
var contact = ContactsApp.getContact('[e-mail]');
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 associée à 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 de nouveaux scripts.

Supprime le groupe de contacts

// The code below creates deletes the contact group named "Work Friends"
var 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 associée à 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 de nouveaux scripts.

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

Paramètres

Nom	Type	Description
email	String	l'adresse e-mail du contact recherché

Renvois

Contact : contact contenant cette adresse e-mail

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Recherche un groupe de contacts portant le nom donné.

Paramètres

Nom	Type	Description
name	String	le nom du groupe de contacts à trouver

Renvois

ContactGroup : groupe de contacts correspondant au nom donné

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Récupère 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 associée à 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 de nouveaux scripts.

Récupère un contact via l'adresse e-mail.

Si plusieurs contacts partagent la même adresse e-mail, la méthode favorise ceux qui ont désigné l'adresse e-mail comme adresse principale. Si aucun des contacts n'a été marqué comme adresse e-mail principale ou comme plusieurs contacts, elle renvoie le premier résultat dans l'ordre des contacts triés.

// The code below retrieves a contact with the email address "[e-mail]".
var contact = ContactsApp.getContact('[e-mail]');

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 associée à un ou plusieurs des champs d'application suivants:

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

Voir aussi

• getContacts()
• getContactById(id)

---

getContactById(id)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de 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"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.getContactById(id);

Paramètres

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

Renvois

Contact : contact correspondant ou valeur nulle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

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

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

Paramètres

Nom	Type	Description
name	String	le nom du groupe de contacts à associer

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Récupère un groupe de contacts associé à l'identifiant 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"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var group  = ContactsApp.getContactGroupById(id);

Paramètres

Nom	Type	Description
id	String	l'identifiant du groupe de contacts à mettre en correspondance

Renvois

ContactGroup : groupe de contacts correspondant ou valeur "null" 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 de 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 une 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.
var groups  = ContactsApp.getContactGroups();
for (var 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 associée à 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 de nouveaux scripts.

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

// The code below will retrieve all the user's contacts
var 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 associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à une adresse.

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

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les adresses du contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à une adresse, dans la limite d'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.
var contacts = ContactsApp.getContactsByAddress('San Francisco',
                                                ContactsApp.Field.HOME_ADDRESS);

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les adresses du contact
label	Field	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Permet d'obtenir des contacts correspondant à une adresse, dans la limite du 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".
var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Paramètres

Nom	Type	Description
query	String	Chaîne à rechercher dans les adresses du contact correspondant au libellé d'adresse personnalisé spécifié
label	String	l'étiquette d'adresse personnalisée à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenir les contacts correspondant au champ de l'entreprise.

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

Paramètres

Nom	Type	Description
query	String	La chaîne à rechercher dans le champ Entreprise du contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

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

Le champ personnalisé peut être spécifié par une chaîne ou 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".
var 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é à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Permet d'obtenir des contacts correspondant à un jour et un mois 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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

Paramètres

Nom	Type	Description
month	Month	mois à correspondre, l'une des valeurs de ContactsApp.Month
day	Integer	la journée à faire correspondre
label	Field	champ de recherche, depuis ContactsApp.Field

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des 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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950,
                                             ContactsApp.Field.BIRTHDAY);

Paramètres

Nom	Type	Description
month	Month	mois à correspondre, l'une des valeurs de ContactsApp.Month
day	Integer	la journée à faire correspondre
year	Integer	l'année à mettre en correspondance, peut être nul
label	Field	champ de recherche, depuis ContactsApp.Field

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de 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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

Paramètres

Nom	Type	Description
month	Month	mois à correspondre, l'une des valeurs de ContactsApp.Month
day	Integer	la journée à faire correspondre
year	Integer	l'année à mettre en correspondance, peut être nul
label	String	le champ personnalisé à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à un jour et un mois 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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

Paramètres

Nom	Type	Description
month	Month	mois à correspondre, l'une des valeurs de ContactsApp.Month
day	Integer	la journée à faire correspondre
label	String	le champ personnalisé à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Trouvez des contacts correspondant à une adresse e-mail.

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]'.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]');

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les adresses e-mail de contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

obtenir des contacts correspondant à une adresse e-mail, dans la limite d'un champ spécifique ;

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in the Home email field.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]',
                                                     ContactsApp.Field.HOME_EMAIL);

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les adresses e-mail de contact
label	Field	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Permet d'obtenir des contacts correspondant à une adresse e-mail, dans la limite du libellé d'adresse e-mail personnalisé spécifié.

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in a custom email address label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]', 'alternate');

Paramètres

Nom	Type	Description
query	String	Chaîne à rechercher dans les adresses e-mail de contact portant le libellé d'adresse e-mail personnalisé spécifié
label	String	le libellé de l'adresse e-mail personnalisée pour effectuer une recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Récupère les contacts d'un ContactGroup donné.

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

Paramètres

Nom	Type	Description
group	ContactGroup	le groupe de contacts

Renvois

Contact[] : tableau des contacts appartenant au groupe donné

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des 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.
var 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 de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à une adresse de messagerie instantanée, dans la limite d'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.
var 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	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à une adresse de messagerie instantanée, dans la limite du libellé de messagerie instantané personnalisé 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".
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Paramètres

Nom	Type	Description
query	String	Chaîne à rechercher dans les adresses de messagerie instantanée du contact avec l'étiquette de messagerie instantanée personnalisée spécifiée
label	String	l'étiquette de messagerie instantanée personnalisée pour effectuer une recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant au champ "Fonction".

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

Paramètres

Nom	Type	Description
query	String	La chaîne à rechercher dans le champ intitulé du poste du contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à un nom.

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

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les noms des contacts

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

obtenir des contacts correspondant à un nom, dans la limite d'un champ spécifique ;

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

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les noms des contacts
label	Field	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenir les contacts correspondant au champ de notes.

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
var 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 de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à un numéro de téléphone.

Cette méthode permet d'étendre les numéros de téléphone composés de lettres. Ainsi, 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.
var 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 du contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à un numéro de téléphone, dans la limite d'un champ spécifique.

Cette méthode permet d'étendre les numéros de téléphone composés de lettres. Ainsi, 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 the Home phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234',
                                              ContactsApp.Field.HOME_PHONE);

Paramètres

Nom	Type	Description
query	String	La chaîne à rechercher dans les numéros de téléphone du contact
label	Field	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Permet d'obtenir des contacts correspondant à un numéro de téléphone, dans la limite du libellé de numéro de téléphone personnalisé spécifié.

Cette méthode permet d'étendre les numéros de téléphone composés de lettres. Ainsi, 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 a custom phone number label (created by the user) called
// "alternate".
var 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 du contact avec le libellé de numéro de téléphone personnalisé spécifié
label	String	le libellé de numéro de téléphone personnalisé à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des 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.
var contacts = ContactsApp.getContactsByUrl('www.example.com');

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les URL du contact

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Obtenez des contacts correspondant à une URL, dans la limite d'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.
var contacts = ContactsApp.getContactsByUrl('www.example.com',
                                            ContactsApp.Field.WORK_WEBSITE);

Paramètres

Nom	Type	Description
query	String	la chaîne à rechercher dans les URL du contact
label	Field	le champ de recherche dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de nouveaux scripts.

Permet d'obtenir des contacts correspondant à une URL, dans la limite du 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".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

Paramètres

Nom	Type	Description
query	String	chaîne à rechercher dans les URL du contact portant le libellé d'URL personnalisée spécifié
label	String	le libellé de l'URL personnalisée à rechercher dans

Renvois

Contact[] : tableau de contacts correspondants

Autorisation

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

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

Voir aussi

• getContact(emailAddress)