Class Contact

יצירת קשר

הוצא משימוש. במקום זאת, כדאי להשתמש בשירות המתקדם של People API

איש קשר מכיל את השם, הכתובת ופרטים שונים ליצירת קשר עם איש הקשר.

שיטות שהוצאו משימוש

שיטה	סוג הערך המוחזר	תיאור קצר
addAddress(label, address)	AddressField	הוספת כתובת לאיש הקשר עם תווית רגילה או מותאמת אישית.
addCompany(company, title)	CompanyField	הוספת חברה לאיש הקשר.
addCustomField(label, content)	CustomField	הוספת שדה בהתאמה אישית לאיש הקשר עם תווית מורחבת או מותאמת אישית.
addDate(label, month, day, year)	DateField	הוספת תאריך לאיש הקשר באמצעות תווית רגילה או מותאמת אישית.
addEmail(label, address)	EmailField	הוספת כתובת אימייל עם תווית רגילה (בית, עבודה וכו') או עם תווית מותאמת אישית {@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	הוספת כתובת צ'אט לאיש הקשר עם תווית רגילה או מותאמת אישית.
addPhone(label, number)	PhoneField	הוספת מספר טלפון לאיש הקשר עם תווית רגילה או בהתאמה אישית.
addToGroup(group)	Contact	הוספת איש הקשר הזה לקבוצת אנשי הקשר שצוינה.
addUrl(label, url)	UrlField	הוספת כתובת URL לאיש הקשר עם תווית רגילה או מותאמת אישית.
deleteContact()	void	מחיקת איש הקשר הזה.
getAddresses()	AddressField[]	הפונקציה מקבלת את כל הכתובות של איש הקשר הזה.
getAddresses(label)	AddressField[]	הפונקציה מקבלת את כל הכתובות של איש הקשר הזה שתואמות לשדה מסוים.
getCompanies()	CompanyField[]	הפונקציה מקבלת את כל החברות של איש הקשר הזה.
getContactGroups()	ContactGroup[]	הפונקציה מקבלת את כל קבוצות אנשי הקשר שמכילות את איש הקשר הזה.
getCustomFields()	CustomField[]	הפונקציה מקבלת את כל השדות המותאמים אישית של איש הקשר הזה.
getCustomFields(label)	CustomField[]	הפונקציה מקבלת את כל השדות המותאמים אישית של איש הקשר הזה שתואמים לשדה מסוים.
getDates()	DateField[]	הפונקציה מקבלת את כל התאריכים של איש הקשר.
getDates(label)	DateField[]	הפונקציה מקבלת את כל התאריכים של איש הקשר הזה שתואמים לשדה מסוים.
getEmailAddresses()	String[]	הפונקציה מקבלת רשימה של כתובות האימייל הזמינות לאיש הקשר הזה.
getEmails()	EmailField[]	הפונקציה מקבלת את כתובות האימייל של איש הקשר הזה.
getEmails(label)	EmailField[]	הפונקציה מקבלת את כתובות האימייל של איש הקשר הזה שתואמות לשדה מסוים.
getFamilyName()	String	הפונקציה מקבלת את שם המשפחה (שם המשפחה) של איש הקשר כמחרוזת.
getFullName()	String	הפונקציה מקבלת את השם המלא (שם פרטי ושם משפחה) של איש הקשר כמחרוזת.
getGivenName()	String	הפונקציה מקבלת את השם הפרטי (השם הפרטי) של איש הקשר כמחרוזת.
getHomeAddress()	String	הפונקציה מקבלת את כתובת הבית של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת.
getHomeFax()	String	הפונקציה מקבלת את מספר הפקס הביתי של איש הקשר הזה, או מחרוזת ריקה אם אין כזה.
getHomePhone()	String	הפונקציה מקבלת את מספר הטלפון בבית של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה.
getIMs()	IMField[]	הפונקציה מקבלת את כל כתובות האימייל של איש הקשר הזה.
getIMs(label)	IMField[]	הפונקציה מקבלת את כל כתובות האימייל של איש הקשר הזה שתואמות לשדה מסוים.
getId()	String	הפונקציה מחזירה את המזהה הייחודי של איש הקשר הזה.
getInitials()	String	הפונקציה מקבלת את ראשי התיבות של איש הקשר.
getLastUpdated()	Date	הפונקציה מקבלת את התאריך שבו איש הקשר עודכן לאחרונה.
getMaidenName()	String	הפונקציה מקבלת את שם הנעורים של איש הקשר כמחרוזת.
getMiddleName()	String	הפונקציה מקבלת את השם האמצעי של איש הקשר כמחרוזת.
getMobilePhone()	String	הפונקציה מקבלת את מספר הטלפון הנייד של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה.
getNickname()	String	הפונקציה מקבלת את הכינוי של איש הקשר כמחרוזת.
getNotes()	String	הפונקציה מקבלת את ההערות שמשויכות לאיש הקשר הזה, או מחרוזת ריקה אם אין הערות.
getPager()	String	הפונקציה מקבלת את מספר הטלפון של מכשיר הקשר של איש הקשר הזה, או מחרוזת ריקה אם אין כזה.
getPhones()	PhoneField[]	הפונקציה מקבלת את כל מספרי הטלפון של איש הקשר הזה.
getPhones(label)	PhoneField[]	הפונקציה מקבלת את כל מספרי הטלפון של איש הקשר הזה שתואמים לשדה מסוים.
getPrefix()	String	הפונקציה מקבלת את התואר של שם איש הקשר.
getPrimaryEmail()	String	הפונקציה מקבלת את כתובת האימייל הראשית של איש הקשר כמחרוזת.
getShortName()	String	הפונקציה מקבלת את השם המקוצר של איש הקשר כמחרוזת.
getSuffix()	String	הפונקציה מקבלת את הסיומת של שם איש הקשר.
getUrls()	UrlField[]	הפונקציה מקבלת את כל כתובות ה-URL של איש הקשר הזה.
getUrls(label)	UrlField[]	הפונקציה מקבלת את כל כתובות ה-URL של איש הקשר הזה שתואמות לשדה מסוים.
getUserDefinedField(key)	String	הפונקציה מקבלת את הערך המותאם אישית שמשויך למפתח הנתון.
getUserDefinedFields()	Object	הפונקציה מקבלת את כל השדות שהוגדרו על ידי המשתמש עבור איש הקשר הזה ומחזירה אותם כמאפיינים של אובייקט JavaScript.
getWorkAddress()	String	הפונקציה מקבלת את כתובת העבודה של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת כזו.
getWorkFax()	String	הפונקציה מקבלת את מספר הפקס של איש הקשר הזה בעבודה, או מחרוזת ריקה אם אין כזה.
getWorkPhone()	String	הפונקציה מקבלת את מספר הטלפון של איש הקשר בעבודה, או מחרוזת ריקה אם אין מספר כזה.
removeFromGroup(group)	Contact	הסרת איש הקשר הזה מקבוצת אנשי הקשר הנתונה.
setFamilyName(familyName)	Contact	מגדיר את שם המשפחה של איש הקשר.
setFullName(fullName)	Contact	הגדרת השם המלא (שם פרטי ושם משפחה) של איש הקשר.
setGivenName(givenName)	Contact	הגדרת השם הפרטי של איש הקשר.
setHomeAddress(addr)	void	הגדרת כתובת המגורים של איש הקשר הזה.
setHomeFax(phone)	void	הגדרת מספר הפקס בבית של איש הקשר הזה.
setHomePhone(phone)	void	הגדרת מספר הטלפון בבית של איש הקשר הזה.
setInitials(initials)	Contact	הגדרת ראשי התיבות של איש הקשר.
setMaidenName(maidenName)	Contact	מגדיר את שם הנעורים של איש הקשר.
setMiddleName(middleName)	Contact	מגדיר את השם האמצעי של איש הקשר.
setMobilePhone(phone)	void	הגדרת מספר הטלפון הנייד של איש הקשר הזה.
setNickname(nickname)	Contact	מגדיר את הכינוי של איש הקשר.
setNotes(notes)	Contact	הגדרת ההערות שמשויכות לאיש הקשר הזה.
setPager(phone)	void	מגדיר את מספר הנייד של איש הקשר הזה.
setPrefix(prefix)	Contact	הגדרת התואר לשם של איש הקשר.
setPrimaryEmail(primaryEmail)	void	הגדרת כתובת האימייל הראשית של איש הקשר הזה.
setShortName(shortName)	Contact	מגדיר את השם המקוצר של איש הקשר.
setSuffix(suffix)	Contact	הגדרת הסיומת לשם של איש הקשר.
setUserDefinedField(key, value)	void	הגדרת שדה יחיד שהוגדר על ידי משתמש לאיש הקשר הזה, שיישמר עם מפתח נתון.
setUserDefinedFields(o)	void	הגדרת השדות שהוגדרו על ידי המשתמש של איש הקשר הזה באמצעות המאפיינים של האובייקט הנתון.
setWorkAddress(addr)	void	הגדרת הכתובת בעבודה של איש הקשר הזה.
setWorkFax(phone)	void	הגדרת מספר הפקס של איש הקשר הזה בעבודה.
setWorkPhone(phone)	void	הגדרת מספר הטלפון בעבודה של איש הקשר הזה.

שיטות שהוצאו משימוש

addAddress(label, address)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת כתובת לאיש הקשר עם תווית רגילה או מותאמת אישית.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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',
);

פרמטרים

שם	סוג	תיאור
label	Object	התווית של הכתובת החדשה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית
address	String	הכתובת החדשה

חזרה

AddressField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getAddresses()

---

addCompany(company, title)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת חברה לאיש הקשר.

// 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');

פרמטרים

שם	סוג	תיאור
company	String	שם החברה שרוצים להוסיף לאיש הקשר הזה
title	String	שם התפקיד שמשויך לאיש הקשר הזה בחברה הזו

חזרה

CompanyField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getCompanies()

---

addCustomField(label, content)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת שדה בהתאמה אישית לאיש הקשר עם תווית מורחבת או מותאמת אישית.

התווית יכולה להיות מ-ContactsApp.ExtendedField או ממחרושת תווית בהתאמה אישית.

// 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');

פרמטרים

שם	סוג	תיאור
label	Object	התווית של הכתובת החדשה, מ-ContactsApp.ExtendedField או ממחרונית מותאמת אישית
content	Object	הערך שרוצים לאחסן בשדה המותאם אישית

חזרה

CustomField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getCustomFields()

---

addDate(label, month, day, year)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת תאריך לאיש הקשר באמצעות תווית רגילה או מותאמת אישית.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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,
);

פרמטרים

שם	סוג	תיאור
label	Object	התווית של התאריך החדש, מ-ContactsApp.Field או ממחרוזת בהתאמה אישית
month	Month	החודש, מ-ContactApps.Month
day	Integer	היום
year	Integer	השנה

חזרה

DateField – התאריך החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getDates()

---

addEmail(label, address)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת כתובת אימייל עם תווית רגילה (בית, עבודה וכו') או עם תווית מותאמת אישית

// 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]',
);

פרמטרים

שם	סוג	תיאור
label	Object	התווית של כתובת האימייל החדשה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית
address	String	כתובת האימייל החדשה

חזרה

EmailField – השדה החדש שנוסף

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

addIM(label, address)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת כתובת צ'אט לאיש הקשר עם תווית רגילה או מותאמת אישית.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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');

פרמטרים

שם	סוג	תיאור
label	Object	התווית של כתובת ה-IM החדשה, מ-ContactsApp.Field או ממחרוץ מותאם אישית
address	String	כתובת האימייל החדשה ל-IM

חזרה

IMField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getIMs()

---

addPhone(label, number)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת מספר טלפון לאיש הקשר עם תווית רגילה או בהתאמה אישית.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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',
);

פרמטרים

שם	סוג	תיאור
label	Object	התווית של מספר הטלפון החדש, מ-ContactsApp.Field או ממחרוץ מותאם אישית
number	String	מספר הטלפון החדש

חזרה

PhoneField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getPhones()

---

addToGroup(group)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת איש הקשר הזה לקבוצת אנשי הקשר שצוינה.

// 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);

פרמטרים

שם	סוג	תיאור
group	ContactGroup	קבוצת אנשי הקשר שאליה רוצים להוסיף את איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• removeFromGroup(group)

---

addUrl(label, url)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הוספת כתובת URL לאיש הקשר עם תווית רגילה או מותאמת אישית.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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',
);

פרמטרים

שם	סוג	תיאור
label	Object	התווית של הכתובת החדשה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית
url	String	כתובת ה-URL החדשה

חזרה

UrlField – השדה החדש שנוצר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getUrls()

---

deleteContact()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מחיקת איש הקשר הזה.

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

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getAddresses()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל הכתובות של איש הקשר הזה.

// 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());
}

חזרה

AddressField[] – רשימת כתובות

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addAddress(label, address)

---

getAddresses(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל הכתובות של איש הקשר הזה שתואמות לשדה מסוים.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

AddressField[] – רשימת כתובות

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addAddress(label, address)

---

getCompanies()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל החברות של איש הקשר הזה.

// 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());
  }
}

חזרה

CompanyField[] — רשימה של חברות

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addCompany(company, title)

---

getContactGroups()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל קבוצות אנשי הקשר שמכילות את איש הקשר הזה.

// 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();

חזרה

ContactGroup[] – הקבוצות שמכילות את איש הקשר הזה

ראה גם

• addToGroup(group)

---

getCustomFields()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל השדות המותאמים אישית של איש הקשר הזה.

// 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());
}

חזרה

CustomField[] – רשימה של שדות מותאמים אישית

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addCustomField(label, content)

---

getCustomFields(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל השדות המותאמים אישית של איש הקשר הזה שתואמים לשדה מסוים.

התווית יכולה להיות תווית רגילה מ-ContactsApp.ExtendedField או מחרוזת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.ExtendedField או ממחרונית בהתאמה אישית

חזרה

CustomField[] – רשימה של שדות מותאמים אישית

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addCustomField(label, content)

---

getDates()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל התאריכים של איש הקשר.

// 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());
}

חזרה

DateField[] – רשימת תאריכים

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addDate(label, month, day, year)

---

getDates(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל התאריכים של איש הקשר הזה שתואמים לשדה מסוים.

התווית יכולה להיות תווית רגילה מ-ContactsApp.Field או מחרוזת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

DateField[] – רשימת תאריכים

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addDate(label, month, day, year)

---

getEmailAddresses()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת רשימה של כתובות האימייל הזמינות לאיש הקשר הזה.

חזרה

String[] – רשימה של כתובות אימייל שזמינות לאיש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getEmails()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כתובות האימייל של איש הקשר הזה.

// 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());
}

חזרה

EmailField[] – רשימת כתובות האימייל של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addEmail(label, address)

---

getEmails(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כתובות האימייל של איש הקשר הזה שתואמות לשדה מסוים.

התווית יכולה להיות תווית רגילה מ-ContactsApp.Field או מחרוזת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

EmailField[] – רשימת כתובות האימייל של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addEmail(label, address)

---

getFamilyName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את שם המשפחה (שם המשפחה) של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – שם המשפחה של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setFamilyName(familyName)

---

getFullName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את השם המלא (שם פרטי ושם משפחה) של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – השם המלא של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setFullName(fullName)

---

getGivenName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את השם הפרטי (השם הפרטי) של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – השם הפרטי של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setGivenName(givenName)

---

getHomeAddress()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כתובת הבית של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת.

חזרה

String – הכתובת הביתית של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getHomeFax()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הפקס הביתי של איש הקשר הזה, או מחרוזת ריקה אם אין כזה.

חזרה

String – מספר הפקס הביתי של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getHomePhone()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הטלפון בבית של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה.

חזרה

String – מספר הטלפון הביתי של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getIMs()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל כתובות האימייל של איש הקשר הזה.

// 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());
}

חזרה

IMField[] – רשימה של כתובות IM

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addIM(label, address)

---

getIMs(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל כתובות האימייל של איש הקשר הזה שתואמות לשדה מסוים.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

IMField[] – רשימה של כתובות IM

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addIM(label, address)

---

getId()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מחזירה את המזהה הייחודי של איש הקשר הזה.

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

חזרה

String – המזהה של איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getInitials()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את ראשי התיבות של איש הקשר.

// 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());
}

חזרה

String – ראשי התיבות של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setInitials(initials)

---

getLastUpdated()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את התאריך שבו איש הקשר עודכן לאחרונה.

// 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());
}

חזרה

Date – התאריך שבו איש הקשר עודכן לאחרונה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getMaidenName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את שם הנעורים של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – שם הנעורים של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setMaidenName(maidenName)

---

getMiddleName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את השם האמצעי של איש הקשר כמחרוזת.

// 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());
}

חזרה

String — השם האמצעי של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setMiddleName(middleName)

---

getMobilePhone()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הטלפון הנייד של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה.

חזרה

String – מספר הטלפון הנייד של איש הקשר הזה, או מחרוזת ריקה אם אין מספר כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getNickname()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את הכינוי של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – הכינוי של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setNickname(nickname)

---

getNotes()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את ההערות שמשויכות לאיש הקשר הזה, או מחרוזת ריקה אם אין הערות.

// 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());
}

חזרה

String – ההערות שמשויכות לאיש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setNotes(notes)

---

getPager()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הטלפון של מכשיר הקשר של איש הקשר הזה, או מחרוזת ריקה אם אין כזה.

חזרה

String – מספר הטלפון של מכשיר הקשר האלקטרוני של איש הקשר הזה, או מחרוזת ריקה אם אין כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getPhones()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל מספרי הטלפון של איש הקשר הזה.

// 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());
}

חזרה

PhoneField[] – רשימת מספרי טלפון

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addPhone(label, number)

---

getPhones(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל מספרי הטלפון של איש הקשר הזה שתואמים לשדה מסוים.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

PhoneField[] – רשימת מספרי טלפון

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addPhone(label, number)

---

getPrefix()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את התואר של שם איש הקשר.

// 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());
}

חזרה

String – התואר של שם איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setPrefix(prefix)

---

getPrimaryEmail()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כתובת האימייל הראשית של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – כתובת האימייל הראשית של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getShortName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את השם המקוצר של איש הקשר כמחרוזת.

// 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());
}

חזרה

String – השם המקוצר של איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setShortName(shortName)

---

getSuffix()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את הסיומת של שם איש הקשר.

// 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());
}

חזרה

String – הסיומת של שם איש הקשר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• setSuffix(suffix)

---

getUrls()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל כתובות ה-URL של איש הקשר הזה.

// 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());
}

חזרה

UrlField[] – רשימת כתובות URL

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addUrl(label, url)

---

getUrls(label)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל כתובות ה-URL של איש הקשר הזה שתואמות לשדה מסוים.

התווית יכולה להיות מ-ContactsApp.Field או ממחרושת תווית בהתאמה אישית.

// 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());
}

פרמטרים

שם	סוג	תיאור
label	Object	התווית להתאמה, מ-ContactsApp.Field או ממחרונית בהתאמה אישית

חזרה

UrlField[] – רשימת כתובות URL

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addUrl(label, url)

---

getUserDefinedField(key)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את הערך המותאם אישית שמשויך למפתח הנתון.

פרמטרים

שם	סוג	תיאור
key	String	המפתח יכול להיות מכל טיפוס בסיסי (String,‏ int וכו')

חזרה

String – התוכן שהוגדר על ידי המשתמש ונשמר באמצעות המפתח הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getUserDefinedFields()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כל השדות שהוגדרו על ידי המשתמש עבור איש הקשר הזה ומחזירה אותם כמאפיינים של אובייקט JavaScript.

חזרה

Object – השדות שהוגדרו על ידי המשתמש לאיש הקשר הזה, כמאפיינים של אובייקט JavaScript

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getWorkAddress()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את כתובת העבודה של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת כזו.

חזרה

String – הכתובת בעבודה של איש הקשר הזה, או מחרוזת ריקה אם אין כתובת כזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getWorkFax()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הפקס של איש הקשר הזה בעבודה, או מחרוזת ריקה אם אין כזה.

חזרה

String – מספר הפקס של איש הקשר הזה בעבודה, או מחרוזת ריקה אם אין מספר כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

getWorkPhone()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מקבלת את מספר הטלפון של איש הקשר בעבודה, או מחרוזת ריקה אם אין מספר כזה.

חזרה

String – מספר הטלפון בעבודה של איש הקשר הזה, או מחרוזת ריקה אם אין כזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

removeFromGroup(group)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הסרת איש הקשר הזה מקבוצת אנשי הקשר הנתונה.

// 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);
}

פרמטרים

שם	סוג	תיאור
group	ContactGroup	קבוצת אנשי הקשר שממנה רוצים להסיר את איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• addToGroup(group)

---

setFamilyName(familyName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את שם המשפחה של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
familyName	String	שם המשפחה החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getFamilyName()

---

setFullName(fullName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת השם המלא (שם פרטי ושם משפחה) של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
fullName	String	השם המלא החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getFullName()

---

setGivenName(givenName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת השם הפרטי של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
givenName	String	השם הפרטי החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getGivenName()

---

setHomeAddress(addr)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת כתובת המגורים של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
addr	String	כתובת המגורים שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setHomeFax(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת מספר הפקס בבית של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר הפקס בבית שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setHomePhone(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת מספר הטלפון בבית של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר הטלפון בבית שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setInitials(initials)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת ראשי התיבות של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
initials	String	ראשי התיבות החדשים של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getInitials()

---

setMaidenName(maidenName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את שם הנעורים של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
maidenName	String	שם המשפחה החדש של איש הקשר לפני הנישואין

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getMaidenName()

---

setMiddleName(middleName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את השם האמצעי של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
middleName	String	השם האמצעי החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getMiddleName()

---

setMobilePhone(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת מספר הטלפון הנייד של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר הטלפון הנייד שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setNickname(nickname)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את הכינוי של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
nickname	String	הכינוי החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getNickname()

---

setNotes(notes)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת ההערות שמשויכות לאיש הקשר הזה.

// 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');
}

פרמטרים

שם	סוג	תיאור
notes	String	את ההערות שרוצים לשמור לגבי איש הקשר הזה

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getNotes()

---

setPager(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את מספר הנייד של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר ה-pager להגדרה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setPrefix(prefix)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת התואר לשם של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
prefix	String	התואר החדש של שם איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getPrefix()

---

setPrimaryEmail(primaryEmail)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת כתובת האימייל הראשית של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
primaryEmail	String	כתובת האימייל הראשית להגדרה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setShortName(shortName)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את השם המקוצר של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
shortName	String	השם המקוצר החדש של איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getShortName()

---

setSuffix(suffix)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את הסיומת לשם של איש הקשר.

// 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');
}

פרמטרים

שם	סוג	תיאור
suffix	String	הסיומת החדשה של שם איש הקשר

חזרה

Contact — איש הקשר הזה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

ראה גם

• getSuffix()

---

setUserDefinedField(key, value)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת שדה יחיד שהוגדר על ידי משתמש לאיש הקשר הזה, שיישמר עם מפתח נתון.

פרמטרים

שם	סוג	תיאור
key	String	המפתח יכול להיות מכל טיפוס בסיסי (String,‏ int וכו')
value	String	הערך יכול להיות מכל טיפוס בסיסי (String,‏ int וכו')

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setUserDefinedFields(o)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת השדות שהוגדרו על ידי המשתמש של איש הקשר הזה באמצעות המאפיינים של האובייקט הנתון.

פרמטרים

שם	סוג	תיאור
o	Object	אובייקט עם מאפיין אחד או יותר בפורמט {key: value}

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setWorkAddress(addr)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת הכתובת בעבודה של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
addr	String	הכתובת בעבודה שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setWorkFax(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת מספר הפקס של איש הקשר הזה בעבודה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר הפקס בעבודה שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

---

setWorkPhone(phone)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת מספר הטלפון בעבודה של איש הקשר הזה.

פרמטרים

שם	סוג	תיאור
phone	String	מספר הטלפון בעבודה שרוצים להגדיר

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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