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	הוספת כתובת אימייל עם תווית רגילה (בית, עבודה וכו') או תווית מותאמת אישית
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)

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

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

התווית יכולה להיות מ-contactApp.Field או ממחרוזת תווית מותאמת אישית.

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

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של הכתובת החדשה, מ-contactApp.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".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

פרמטרים

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

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• getCompanies()

---

addCustomField(label, content)

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

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

התווית יכולה להיות מ-contactApp.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'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של הכתובת החדשה, מ-contactApp.ExtendedField או ממחרוזת מותאמת אישית
content	Object	הערך שיש לשמור בשדה המותאם אישית

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• getCustomFields()

---

addDate(label, month, day, year)

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

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

התווית יכולה להיות מ-contactApp.Field או ממחרוזת תווית מותאמת אישית.

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

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של התאריך החדש, מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של הודעת האימייל החדשה, מ-contactApp.Field או ממחרוזת מותאמת אישית
address	String	כתובת האימייל החדשה

החזרות

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

הרשאות

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

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

---

addIM(label, address)

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

מוסיף כתובת הודעות מיידיות לאיש הקשר באמצעות תווית רגילה או תווית מותאמת אישית.

התווית יכולה להיות מ-contactApp.Field או ממחרוזת תווית מותאמת אישית.

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

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של כתובת ה-IM החדשה, מ-contactApp.Field או ממחרוזת מותאמת אישית
address	String	כתובת ה-IM החדשה

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• getIMs()

---

addPhone(label, number)

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

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

התווית יכולה להיות מ-contactApp.Field או ממחרוזת תווית מותאמת אישית.

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

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של מספר הטלפון החדש, מ-contactApp.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"
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

פרמטרים

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

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• removeFromGroup(group)

---

addUrl(label, url)

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

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

התווית יכולה להיות מ-contactApp.Field או ממחרוזת תווית מותאמת אישית.

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

פרמטרים

שם	תיאור	התיאור
label	Object	התווית של הכתובת החדשה, מ-contactApp.Field או ממחרוזת מותאמת אישית
url	String	כתובת ה-URL החדשה

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• getUrls()

---

deleteContact()

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

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

var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addAddress(label, address)

---

getAddresses(label)

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

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

התווית יכולה להיות מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addCustomField(label, content)

---

getCustomFields(label)

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

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

התווית יכולה להיות תווית רגילה מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.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
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addDate(label, month, day, year)

---

getDates(label)

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

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

התווית יכולה להיות תווית רגילה מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.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
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addEmail(label, address)

---

getEmails(label)

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

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

התווית יכולה להיות תווית רגילה מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addIM(label, address)

---

getIMs(label)

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

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

התווית יכולה להיות מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.Field או ממחרוזת מותאמת אישית

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addIM(label, address)

---

getId()

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

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

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Jane');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addPhone(label, number)

---

getPhones(label)

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

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

התווית יכולה להיות מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addUrl(label, url)

---

getUrls(label)

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

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

התווית יכולה להיות מ-contactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

פרמטרים

שם	תיאור	התיאור
label	Object	התווית להתאמה, מ-contactApp.Field או ממחרוזת מותאמת אישית

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• addUrl(label, url)

---

getUserDefinedField(key)

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

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

פרמטרים

שם	תיאור	התיאור
key	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
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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	מספר הזימונית להגדרה

הרשאות

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

• 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

פרמטרים

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

החזרות

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

הרשאות

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

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

כדאי לעיין גם בפרטים הבאים

• getSuffix()

---

setUserDefinedField(key, value)

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

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

פרמטרים

שם	תיאור	התיאור
key	String	המפתח יכול להיות כל טיפוס בסיסי (מחרוזת, int וכו')
value	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