Class Contact

Contact

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

Un contact contient le nom, l'adresse et diverses coordonnées d'un contact.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
addAddress(label, address)	AddressField	Ajoute une adresse au contact avec un libellé standard ou personnalisé.
addCompany(company, title)	CompanyField	Ajoute une entreprise au contact.
addCustomField(label, content)	CustomField	Ajoute un champ personnalisé au contact avec un libellé étendu ou personnalisé.
addDate(label, month, day, year)	DateField	Ajoute une date au contact avec un libellé standard ou personnalisé.
addEmail(label, address)	EmailField	Ajouter une adresse e-mail avec un libellé standard (domicile, travail, etc.) ou personnalisé {@code // The code below retrieves a contact named "John Doe" and adds the email // address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)	IMField	Ajoute une adresse de chat au contact avec un libellé standard ou personnalisé.
addPhone(label, number)	PhoneField	Ajoute un numéro de téléphone au contact avec un libellé standard ou personnalisé.
addToGroup(group)	Contact	Ajoute ce contact au groupe de contacts donné.
addUrl(label, url)	UrlField	Ajoute une URL au contact avec un libellé standard ou personnalisé.
deleteContact()	void	Supprime ce contact.
getAddresses()	AddressField[]	Récupère toutes les adresses de ce contact.
getAddresses(label)	AddressField[]	Récupère toutes les adresses de ce contact correspondant à un champ particulier.
getCompanies()	CompanyField[]	Récupère toutes les entreprises associées à ce contact.
getContactGroups()	ContactGroup[]	Récupère tous les groupes de contacts contenant ce contact.
getCustomFields()	CustomField[]	Récupère tous les champs personnalisés de ce contact.
getCustomFields(label)	CustomField[]	Récupère tous les champs personnalisés de ce contact correspondant à un champ particulier.
getDates()	DateField[]	Récupère toutes les dates de ce contact.
getDates(label)	DateField[]	Récupère toutes les dates de ce contact correspondant à un champ particulier.
getEmailAddresses()	String[]	Récupère la liste des adresses e-mail disponibles pour ce contact.
getEmails()	EmailField[]	Récupère les adresses e-mail de ce contact.
getEmails(label)	EmailField[]	Récupère les adresses e-mail de ce contact correspondant à un champ particulier.
getFamilyName()	String	Récupère le nom de famille (nom) du contact sous la forme d'une chaîne.
getFullName()	String	Récupère le nom complet (prénom et nom) du contact sous forme de chaîne.
getGivenName()	String	Récupère le prénom du contact sous la forme d'une chaîne.
getHomeAddress()	String	Récupère l'adresse de domicile de ce contact, ou une chaîne vide s'il n'en existe pas.
getHomeFax()	String	Récupère le numéro de fax de la maison de ce contact ou une chaîne vide s'il n'en existe pas.
getHomePhone()	String	Récupère le numéro de téléphone de ce contact ou une chaîne vide s'il n'existe pas.
getIMs()	IMField[]	Récupère toutes les adresses de chat de ce contact.
getIMs(label)	IMField[]	Récupère toutes les adresses de chat de ce contact correspondant à un champ particulier.
getId()	String	Renvoie l'ID unique de ce contact.
getInitials()	String	Récupère les initiales du contact.
getLastUpdated()	Date	Récupère la date de la dernière mise à jour de ce contact.
getMaidenName()	String	Récupère le nom de jeune fille du contact sous forme de chaîne.
getMiddleName()	String	Récupère le deuxième prénom du contact sous forme de chaîne.
getMobilePhone()	String	Récupère le numéro de téléphone mobile de ce contact ou une chaîne vide s'il n'en existe pas.
getNickname()	String	Récupère le surnom du contact sous forme de chaîne.
getNotes()	String	Récupère les notes associées à ce contact, ou une chaîne vide si aucune note n'est associée.
getPager()	String	Récupère le numéro de téléphone du bip de ce contact ou une chaîne vide s'il n'en existe pas.
getPhones()	PhoneField[]	Récupère tous les numéros de téléphone de ce contact.
getPhones(label)	PhoneField[]	Récupère tous les numéros de téléphone de ce contact correspondant à un champ spécifique.
getPrefix()	String	Récupère le préfixe du nom du contact.
getPrimaryEmail()	String	Récupère l'adresse e-mail principale du contact sous forme de chaîne.
getShortName()	String	Récupère le nom court du contact sous la forme d'une chaîne.
getSuffix()	String	Récupère le suffixe du nom du contact.
getUrls()	UrlField[]	Récupère toutes les URL de ce contact.
getUrls(label)	UrlField[]	Récupère toutes les URL de ce contact correspondant à un champ spécifique.
getUserDefinedField(key)	String	Récupère la valeur définie par l'utilisateur associée à la clé donnée.
getUserDefinedFields()	Object	Récupère tous les champs définis par l'utilisateur pour ce contact et les renvoie en tant que propriétés d'un objet JavaScript.
getWorkAddress()	String	Récupère l'adresse professionnelle de ce contact, ou une chaîne vide si aucune n'existe.
getWorkFax()	String	Récupère le numéro de fax professionnel de ce contact ou une chaîne vide s'il n'en existe pas.
getWorkPhone()	String	Récupère le numéro de téléphone professionnel de ce contact ou une chaîne vide s'il n'en existe pas.
removeFromGroup(group)	Contact	Supprime ce contact du groupe de contacts donné.
setFamilyName(familyName)	Contact	Définit le nom de famille (nom) du contact.
setFullName(fullName)	Contact	Définit le nom complet (prénom et nom) du contact.
setGivenName(givenName)	Contact	Définit le prénom du contact.
setHomeAddress(addr)	void	Définit l'adresse du domicile de ce contact.
setHomeFax(phone)	void	Définit le numéro de fax personnel de ce contact.
setHomePhone(phone)	void	Définit le numéro de téléphone personnel de ce contact.
setInitials(initials)	Contact	Définit les initiales du contact.
setMaidenName(maidenName)	Contact	Définit le nom de jeune fille du contact.
setMiddleName(middleName)	Contact	Définit le deuxième prénom du contact.
setMobilePhone(phone)	void	Définit le numéro de téléphone mobile de ce contact.
setNickname(nickname)	Contact	Définit le pseudo du contact.
setNotes(notes)	Contact	Définit les notes associées à ce contact.
setPager(phone)	void	Définit le numéro de bip de ce contact.
setPrefix(prefix)	Contact	Définit le préfixe du nom du contact.
setPrimaryEmail(primaryEmail)	void	Définit l'adresse e-mail principale de ce contact.
setShortName(shortName)	Contact	Définit le nom court du contact.
setSuffix(suffix)	Contact	Définit le suffixe du nom du contact.
setUserDefinedField(key, value)	void	Définit un seul champ défini par l'utilisateur pour ce contact, à stocker avec une clé donnée.
setUserDefinedFields(o)	void	Définit les champs définis par l'utilisateur pour ce contact avec les propriétés de l'objet donné.
setWorkAddress(addr)	void	Définit l'adresse professionnelle de ce contact.
setWorkFax(phone)	void	Définit le numéro de fax professionnel de ce contact.
setWorkPhone(phone)	void	Définit le numéro de téléphone professionnel de ce contact.

Méthodes obsolètes

addAddress(label, address)

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

Ajoute une adresse au contact avec un libellé standard ou personnalisé.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

Paramètres

Nom	Type	Description
label	Object	le libellé de la nouvelle adresse, à partir de ContactsApp.Field ou d'une chaîne personnalisée
address	String	la nouvelle adresse ;

Renvois

AddressField : champ 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

• getAddresses()

---

addCompany(company, title)

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

Ajoute une entreprise au contact.

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

Paramètres

Nom	Type	Description
company	String	le nom de l'entreprise à ajouter à ce contact
title	String	le poste occupé par ce contact dans cette entreprise

Renvois

CompanyField : champ 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

• getCompanies()

---

addCustomField(label, content)

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

Ajoute un champ personnalisé au contact avec un libellé étendu ou personnalisé.

Le libellé peut provenir de ContactsApp.ExtendedField ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Paramètres

Nom	Type	Description
label	Object	le libellé de la nouvelle adresse, à partir de ContactsApp.ExtendedField ou d'une chaîne personnalisée
content	Object	la valeur à stocker dans le champ personnalisé ;

Renvois

CustomField : champ 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

• getCustomFields()

---

addDate(label, month, day, year)

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

Ajoute une date au contact avec un libellé standard ou personnalisé.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

Paramètres

Nom	Type	Description
label	Object	le libellé de la nouvelle date, à partir de ContactsApp.Field ou d'une chaîne personnalisée
month	Month	le mois, à partir de ContactApps.Month
day	Integer	le jour
year	Integer	l'année

Renvois

DateField : date de création

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

• getDates()

---

addEmail(label, address)

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

Ajouter une adresse e-mail avec un libellé standard (domicile, travail, etc.) ou personnalisé

// The code below retrieves a contact named "John Doe" and adds the email
// address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    '[e-mail]',
);

Paramètres

Nom	Type	Description
label	Object	le libellé du nouvel e-mail, à partir de ContactsApp.Field ou d'une chaîne personnalisée
address	String	la nouvelle adresse e-mail ;

Renvois

EmailField : champ nouvellement ajouté

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

---

addIM(label, address)

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

Ajoute une adresse de chat au contact avec un libellé standard ou personnalisé.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

Paramètres

Nom	Type	Description
label	Object	le libellé de la nouvelle adresse de chat, à partir de ContactsApp.Field ou d'une chaîne personnalisée
address	String	la nouvelle adresse de messagerie instantanée ;

Renvois

IMField : champ 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

• getIMs()

---

addPhone(label, number)

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

Ajoute un numéro de téléphone au contact avec un libellé standard ou personnalisé.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

Paramètres

Nom	Type	Description
label	Object	Libellé du nouveau numéro de téléphone, à partir de ContactsApp.Field ou d'une chaîne personnalisée
number	String	le nouveau numéro de téléphone

Renvois

PhoneField : champ 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

• getPhones()

---

addToGroup(group)

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

Ajoute ce contact au groupe de contacts donné.

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Paramètres

Nom	Type	Description
group	ContactGroup	le groupe de contacts auquel ajouter ce contact

Renvois

Contact : ce contact

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

• removeFromGroup(group)

---

addUrl(label, url)

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

Ajoute une URL au contact avec un libellé standard ou personnalisé.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

Paramètres

Nom	Type	Description
label	Object	le libellé de la nouvelle adresse, à partir de ContactsApp.Field ou d'une chaîne personnalisée
url	String	la nouvelle URL ;

Renvois

UrlField : champ 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

• getUrls()

---

deleteContact()

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

Supprime ce contact.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

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

---

getAddresses()

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

Récupère toutes les adresses de ce contact.

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

Renvois

AddressField[] : liste d'adresses

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

• addAddress(label, address)

---

getAddresses(label)

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

Récupère toutes les adresses de ce contact correspondant à un champ particulier.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

AddressField[] : liste d'adresses

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

• addAddress(label, address)

---

getCompanies()

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

Récupère toutes les entreprises associées à ce contact.

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

Renvois

CompanyField[] : liste d'entreprises

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

• addCompany(company, title)

---

getContactGroups()

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

Récupère tous les groupes de contacts contenant ce contact.

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

Renvois

ContactGroup[] : groupes contenant ce contact

Voir aussi

• addToGroup(group)

---

getCustomFields()

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

Récupère tous les champs personnalisés de ce contact.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

Renvois

CustomField[] : liste de champs personnalisés

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

• addCustomField(label, content)

---

getCustomFields(label)

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

Récupère tous les champs personnalisés de ce contact correspondant à un champ particulier.

Le libellé peut être un libellé standard de ContactsApp.ExtendedField ou une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.ExtendedField ou d'une chaîne personnalisée

Renvois

CustomField[] : liste de champs personnalisés

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

• addCustomField(label, content)

---

getDates()

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

Récupère toutes les dates de ce contact.

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

Renvois

DateField[] : liste de dates

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

• addDate(label, month, day, year)

---

getDates(label)

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

Récupère toutes les dates de ce contact correspondant à un champ particulier.

Le libellé peut être un libellé standard de ContactsApp.Field ou une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

DateField[] : liste de dates

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

• addDate(label, month, day, year)

---

getEmailAddresses()

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

Récupère la liste des adresses e-mail disponibles pour ce contact.

Renvois

String[] : liste des adresses e-mail disponibles pour ce contact

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

---

getEmails()

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

Récupère les adresses e-mail de ce contact.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Renvois

EmailField[] : liste des adresses e-mail du contact

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

• addEmail(label, address)

---

getEmails(label)

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

Récupère les adresses e-mail de ce contact correspondant à un champ particulier.

Le libellé peut être un libellé standard de ContactsApp.Field ou une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

EmailField[] : liste des adresses e-mail du contact

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

• addEmail(label, address)

---

getFamilyName()

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

Récupère le nom de famille (nom) du contact sous la forme d'une chaîne.

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

Renvois

String : nom de famille du contact

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

• setFamilyName(familyName)

---

getFullName()

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

Récupère le nom complet (prénom et nom) du contact sous forme de chaîne.

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

Renvois

String : nom complet du contact

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

• setFullName(fullName)

---

getGivenName()

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

Récupère le prénom du contact sous la forme d'une chaîne.

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

Renvois

String : prénom du contact

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

• setGivenName(givenName)

---

getHomeAddress()

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

Récupère l'adresse de domicile de ce contact, ou une chaîne vide s'il n'en existe pas.

Renvois

String : adresse personnelle de ce contact, ou chaîne vide s'il n'en existe pas

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

---

getHomeFax()

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

Récupère le numéro de fax de la maison de ce contact ou une chaîne vide s'il n'en existe pas.

Renvois

String : numéro de fax de la maison de ce contact ou chaîne vide s'il n'en existe pas

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

---

getHomePhone()

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

Récupère le numéro de téléphone de ce contact ou une chaîne vide s'il n'existe pas.

Renvois

String : numéro de téléphone fixe de ce contact ou chaîne vide s'il n'en existe pas

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

---

getIMs()

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

Récupère toutes les adresses de chat de ce contact.

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

Renvois

IMField[] : liste des adresses de chat

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

• addIM(label, address)

---

getIMs(label)

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

Récupère toutes les adresses de chat de ce contact correspondant à un champ particulier.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

IMField[] : liste des adresses de chat

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

• addIM(label, address)

---

getId()

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

Renvoie l'ID unique de ce contact.

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const id = contact.getId();

Renvois

String : ID de ce contact

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

---

getInitials()

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

Récupère les initiales du contact.

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

Renvois

String : initiales du contact

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

• setInitials(initials)

---

getLastUpdated()

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

Récupère la date de la dernière mise à jour de ce contact.

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

Renvois

Date : date de la dernière mise à jour de ce contact

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

---

getMaidenName()

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

Récupère le nom de jeune fille du contact sous forme de chaîne.

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

Renvois

String : nom de jeune fille du contact

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

• setMaidenName(maidenName)

---

getMiddleName()

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

Récupère le deuxième prénom du contact sous forme de chaîne.

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

Renvois

String : deuxième prénom du contact

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

• setMiddleName(middleName)

---

getMobilePhone()

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

Récupère le numéro de téléphone mobile de ce contact ou une chaîne vide s'il n'en existe pas.

Renvois

String : numéro de téléphone mobile de ce contact ou chaîne vide s'il n'en existe pas

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

---

getNickname()

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

Récupère le surnom du contact sous forme de chaîne.

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

Renvois

String : pseudo du contact

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

• setNickname(nickname)

---

getNotes()

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

Récupère les notes associées à ce contact, ou une chaîne vide si aucune note n'est associée.

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

Renvois

String : notes associées à ce contact

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

• setNotes(notes)

---

getPager()

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

Récupère le numéro de téléphone du bip de ce contact ou une chaîne vide s'il n'en existe pas.

Renvois

String : numéro de téléphone du bip de ce contact ou chaîne vide s'il n'existe pas

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

---

getPhones()

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

Récupère tous les numéros de téléphone de ce contact.

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

Renvois

PhoneField[] : liste de numéros de téléphone

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

• addPhone(label, number)

---

getPhones(label)

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

Récupère tous les numéros de téléphone de ce contact correspondant à un champ spécifique.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

PhoneField[] : liste de numéros de téléphone

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

• addPhone(label, number)

---

getPrefix()

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

Récupère le préfixe du nom du contact.

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

Renvois

String : préfixe du nom du contact

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

• setPrefix(prefix)

---

getPrimaryEmail()

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

Récupère l'adresse e-mail principale du contact sous forme de chaîne.

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

Renvois

String : adresse e-mail principale du contact

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

---

getShortName()

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

Récupère le nom court du contact sous la forme d'une chaîne.

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

Renvois

String : nom court du contact

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

• setShortName(shortName)

---

getSuffix()

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

Récupère le suffixe du nom du contact.

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

Renvois

String : suffixe du nom du contact

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

• setSuffix(suffix)

---

getUrls()

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

Récupère toutes les URL de ce contact.

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

Renvois

UrlField[] : liste d'URL

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

• addUrl(label, url)

---

getUrls(label)

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

Récupère toutes les URL de ce contact correspondant à un champ particulier.

Le libellé peut provenir de ContactsApp.Field ou d'une chaîne de libellé personnalisée.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

Paramètres

Nom	Type	Description
label	Object	le libellé à faire correspondre, à partir de ContactsApp.Field ou d'une chaîne personnalisée

Renvois

UrlField[] : liste d'URL

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

• addUrl(label, url)

---

getUserDefinedField(key)

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

Récupère la valeur définie par l'utilisateur associée à la clé donnée.

Paramètres

Nom	Type	Description
key	String	la clé peut être de n'importe quel type de base (chaîne, entier, etc.) ;

Renvois

String : contenu défini par l'utilisateur stocké avec cette clé

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

---

getUserDefinedFields()

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

Récupère tous les champs définis par l'utilisateur pour ce contact et les renvoie en tant que propriétés d'un objet JavaScript.

Renvois

Object : champs définis par l'utilisateur pour ce contact, en tant que propriétés d'un objet JavaScript

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

---

getWorkAddress()

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

Récupère l'adresse professionnelle de ce contact, ou une chaîne vide si aucune n'existe.

Renvois

String : adresse professionnelle de ce contact, ou chaîne vide s'il n'en existe pas

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

---

getWorkFax()

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

Récupère le numéro de fax professionnel de ce contact ou une chaîne vide s'il n'en existe pas.

Renvois

String : numéro de fax professionnel de ce contact ou chaîne vide s'il n'en existe pas

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

---

getWorkPhone()

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

Récupère le numéro de téléphone professionnel de ce contact ou une chaîne vide s'il n'en existe pas.

Renvois

String : numéro de téléphone professionnel de ce contact ou chaîne vide s'il n'en existe pas

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

---

removeFromGroup(group)

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

Supprime ce contact du groupe de contacts donné.

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Paramètres

Nom	Type	Description
group	ContactGroup	le groupe de contacts à partir duquel vous souhaitez supprimer ce contact ;

Renvois

Contact : ce contact

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

• addToGroup(group)

---

setFamilyName(familyName)

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

Définit le nom de famille (nom) du contact.

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

Paramètres

Nom	Type	Description
familyName	String	le nouveau nom de famille du contact

Renvois

Contact : ce contact

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

• getFamilyName()

---

setFullName(fullName)

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

Définit le nom complet (prénom et nom) du contact.

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Paramètres

Nom	Type	Description
fullName	String	le nouveau nom complet du contact ;

Renvois

Contact : ce contact

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

• getFullName()

---

setGivenName(givenName)

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

Définit le prénom du contact.

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Paramètres

Nom	Type	Description
givenName	String	le nouveau prénom du contact

Renvois

Contact : ce contact

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

• getGivenName()

---

setHomeAddress(addr)

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

Définit l'adresse du domicile de ce contact.

Paramètres

Nom	Type	Description
addr	String	l'adresse du domicile à définir

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

---

setHomeFax(phone)

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

Définit le numéro de fax personnel de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro de fax de votre domicile à définir

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

---

setHomePhone(phone)

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

Définit le numéro de téléphone personnel de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro de téléphone personnel à définir

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

---

setInitials(initials)

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

Définit les initiales du contact.

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

Paramètres

Nom	Type	Description
initials	String	les nouvelles initiales du contact

Renvois

Contact : ce contact

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

• getInitials()

---

setMaidenName(maidenName)

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

Définit le nom de jeune fille du contact.

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Paramètres

Nom	Type	Description
maidenName	String	le nouveau nom de jeune fille du contact

Renvois

Contact : ce contact

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

• getMaidenName()

---

setMiddleName(middleName)

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

Définit le deuxième prénom du contact.

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Paramètres

Nom	Type	Description
middleName	String	le nouveau deuxième prénom du contact

Renvois

Contact : ce contact

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

• getMiddleName()

---

setMobilePhone(phone)

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

Définit le numéro de téléphone mobile de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro de téléphone mobile à définir

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

---

setNickname(nickname)

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

Définit le pseudo du contact.

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Paramètres

Nom	Type	Description
nickname	String	le nouveau pseudo du contact

Renvois

Contact : ce contact

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

• getNickname()

---

setNotes(notes)

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

Définit les notes associées à ce contact.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

Paramètres

Nom	Type	Description
notes	String	les notes à stocker pour ce contact ;

Renvois

Contact : ce contact

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

• getNotes()

---

setPager(phone)

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

Définit le numéro de bip de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro du télécopieur à définir

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

---

setPrefix(prefix)

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

Définit le préfixe du nom du contact.

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

Paramètres

Nom	Type	Description
prefix	String	le nouveau préfixe du nom du contact ;

Renvois

Contact : ce contact

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

• getPrefix()

---

setPrimaryEmail(primaryEmail)

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

Définit l'adresse e-mail principale de ce contact.

Paramètres

Nom	Type	Description
primaryEmail	String	l'adresse e-mail principale à définir

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

---

setShortName(shortName)

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

Définit le nom court du contact.

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

Paramètres

Nom	Type	Description
shortName	String	le nouveau nom court du contact

Renvois

Contact : ce contact

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

• getShortName()

---

setSuffix(suffix)

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

Définit le suffixe du nom du contact.

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

Paramètres

Nom	Type	Description
suffix	String	le nouveau suffixe du nom du contact

Renvois

Contact : ce contact

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

• getSuffix()

---

setUserDefinedField(key, value)

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

Définit un seul champ défini par l'utilisateur pour ce contact, à stocker avec une clé donnée.

Paramètres

Nom	Type	Description
key	String	la clé peut être de n'importe quel type de base (chaîne, entier, etc.) ;
value	String	La valeur peut être de n'importe quel type de base (chaîne, entier, etc.).

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

---

setUserDefinedFields(o)

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

Définit les champs définis par l'utilisateur pour ce contact avec les propriétés de l'objet donné.

Paramètres

Nom	Type	Description
o	Object	un objet avec une ou plusieurs propriétés au format {key: value}

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

---

setWorkAddress(addr)

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

Définit l'adresse professionnelle de ce contact.

Paramètres

Nom	Type	Description
addr	String	l'adresse professionnelle à définir ;

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

---

setWorkFax(phone)

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

Définit le numéro de fax professionnel de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro de fax professionnel à définir

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

---

setWorkPhone(phone)

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

Définit le numéro de téléphone professionnel de ce contact.

Paramètres

Nom	Type	Description
phone	String	le numéro de téléphone professionnel à définir

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