Class ContactsApp

ContactsApp

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

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

מאפיינים שהוצאו משימוש

נכס	תיאור	התיאור
ExtendedField	ExtendedField
Field	Field
Gender	Gender
Month	Month
Priority	Priority
Sensitivity	Sensitivity

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

שיטה	סוג הערך שמוחזר	תיאור קצר
createContact(givenName, familyName, email)	Contact	יצירת איש קשר חדש.
createContactGroup(name)	ContactGroup	יצירת קבוצת אנשי קשר בשם הנתון
deleteContact(contact)	void	מוחק את איש הקשר.
deleteContactGroup(group)	void	מחיקת הקבוצה של אנשי הקשר
findByEmailAddress(email)	Contact	חיפוש איש קשר עם כתובת האימייל הנתונה.
findContactGroup(name)	ContactGroup	מוצא קבוצת אנשי קשר בשם הנתון.
getAllContacts()	Contact[]	הצגת כל אנשי הקשר ששייכים למשתמש הזה.
getContact(emailAddress)	Contact	הפונקציה מקבלת איש קשר לפי כתובת האימייל.
getContactById(id)	Contact	הפונקציה מקבלת את איש הקשר עם המזהה הזה.
getContactGroup(name)	ContactGroup	הפונקציה מקבלת קבוצת אנשי קשר עם השם הנתון, או מחזירה את הערך null אם לא נמצאה קבוצה כזו של אנשי קשר.
getContactGroupById(id)	ContactGroup	הפונקציה מקבלת קבוצת אנשי קשר עם המזהה הנתון או מחזירה את הערך null אם לא נמצאה קבוצה כזו של אנשי קשר.
getContactGroups()	ContactGroup[]	הצגת הרשימה המלאה של קבוצות אנשי הקשר של המשתמש.
getContacts()	Contact[]	הפונקציה מקבלת את כל אנשי הקשר של המשתמש.
getContactsByAddress(query)	Contact[]	להציג אנשי קשר שתואמים לכתובת מסוימת.
getContactsByAddress(query, label)	Contact[]	לקבל אנשי קשר המתאימים לכתובת, המוגבלים לשדה מסוים.
getContactsByAddress(query, label)	Contact[]	קבלת אנשי קשר שתואמים לכתובת מסוימת, מוגבלת לתווית הכתובת המותאמת אישית שצוינה.
getContactsByCompany(query)	Contact[]	קבלת אנשי קשר שתואמים לשדה 'חברה'.
getContactsByCustomField(query, label)	Contact[]	הצגת אנשי קשר שתואמים לערך נתון בשדה מותאם אישית.
getContactsByDate(month, day, label)	Contact[]	קבל אנשי קשר המתאימים לחודש וליום נתונים עבור שדה סטנדרטי ספציפי.
getContactsByDate(month, day, year, label)	Contact[]	קבל אנשי קשר המתאימים לחודש, ליום ולשנה נתונים עבור שדה סטנדרטי ספציפי.
getContactsByDate(month, day, year, label)	Contact[]	להציג אנשי קשר שתואמים לחודש, ליום ולשנה מסוימים עבור שדה מותאם אישית ספציפי.
getContactsByDate(month, day, label)	Contact[]	קבל אנשי קשר המתאימים לחודש וליום נתונים עבור שדה מותאם אישית מסוים.
getContactsByEmailAddress(query)	Contact[]	חיפוש אנשי קשר שתואמים לכתובת אימייל.
getContactsByEmailAddress(query, label)	Contact[]	הצגת אנשי קשר שתואמים לכתובת אימייל, המוגבלים לשדה מסוים.
getContactsByEmailAddress(query, label)	Contact[]	קבלת אנשי קשר שתואמים לכתובת אימייל, רק בתווית של כתובת האימייל המותאמת אישית שצוינה.
getContactsByGroup(group)	Contact[]	קבל את אנשי הקשר ב-contactGroup נתון.
getContactsByIM(query)	Contact[]	קבל אנשי קשר שמתאימים לכתובת להודעות מיידיות.
getContactsByIM(query, label)	Contact[]	קבלת אנשי קשר המתאימים לכתובת לשליחת הודעות מיידיות, המוגבלות לשדה מסוים.
getContactsByIM(query, label)	Contact[]	קבלת אנשי קשר שתואמים לכתובת לשליחת הודעות מיידיות, רק עם התווית המותאמת אישית שהוגדרה להעברת הודעות מיידיות.
getContactsByJobTitle(query)	Contact[]	קבלת אנשי קשר שתואמים לשדה של שם המשרה.
getContactsByName(query)	Contact[]	קבלת אנשי קשר שתואמים לשם.
getContactsByName(query, label)	Contact[]	הצגת אנשי קשר שתואמים לשם, שמוגבלים לשדה מסוים.
getContactsByNotes(query)	Contact[]	הצגת אנשי קשר שתואמים לשדה ההערות.
getContactsByPhone(query)	Contact[]	חיפוש אנשי קשר שתואמים למספר טלפון מסוים.
getContactsByPhone(query, label)	Contact[]	הצגת אנשי קשר שתואמים למספר טלפון, המוגבל לשדה מסוים.
getContactsByPhone(query, label)	Contact[]	קבלת אנשי קשר שתואמים למספר טלפון, מוגבל לתווית מספר הטלפון המותאמת אישית שצוינה.
getContactsByUrl(query)	Contact[]	קבלת אנשי קשר שתואמים לכתובת URL.
getContactsByUrl(query, label)	Contact[]	הצגת אנשי קשר שתואמים לכתובת URL מסוימת, המוגבלים לשדה מסוים.
getContactsByUrl(query, label)	Contact[]	קבלת אנשי קשר שתואמים לכתובת URL, מוגבלת לתווית של כתובת ה-URL המותאמת אישית שצוינה.

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

createContact(givenName, familyName, email)

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

יצירת איש קשר חדש.

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

פרמטרים

שם	תיאור	התיאור
givenName	String	השם הפרטי של איש הקשר
familyName	String	שם המשפחה של איש הקשר
email	String	כתובת האימייל של איש הקשר

החזרות

Contact – אובייקט איש הקשר החדש שנוצר

הרשאות

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

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

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

• deleteContact(contact)

---

createContactGroup(name)

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

יצירת קבוצת אנשי קשר בשם הנתון

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

פרמטרים

שם	תיאור	התיאור
name	String	השם של קבוצת אנשי הקשר החדשה

החזרות

ContactGroup – הקבוצה החדשה של אנשי הקשר

הרשאות

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

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

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

• deleteContactGroup(group)

---

deleteContact(contact)

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

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

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

פרמטרים

שם	תיאור	התיאור
contact	Contact	איש הקשר למחיקה

הרשאות

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

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

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

• createContact(givenName, familyName, email)

---

deleteContactGroup(group)

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

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

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

פרמטרים

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

הרשאות

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

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

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

• createContactGroup(name)

---

findByEmailAddress(email)

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

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

פרמטרים

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

החזרות

Contact - איש הקשר שמכיל את כתובת האימייל הזו

הרשאות

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

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

---

findContactGroup(name)

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

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

פרמטרים

שם	תיאור	התיאור
name	String	השם של קבוצת אנשי הקשר כדי למצוא

החזרות

ContactGroup – קבוצת אנשי הקשר שתואמת לשם הנתון

הרשאות

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

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

---

getAllContacts()

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

הצגת כל אנשי הקשר ששייכים למשתמש הזה.

החזרות

Contact[] – כל אנשי הקשר של המשתמש הזה

הרשאות

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

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

---

getContact(emailAddress)

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

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

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

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

פרמטרים

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

החזרות

Contact – איש הקשר עם כתובת האימייל הזו

הרשאות

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

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

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

• getContacts()
• getContactById(id)

---

getContactById(id)

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

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

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

פרמטרים

שם	תיאור	התיאור
id	String	המזהה של איש הקשר שיש לאחזר

החזרות

Contact – איש הקשר התואם או null

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactGroup(name)

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

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

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

פרמטרים

שם	תיאור	התיאור
name	String	השם של קבוצת אנשי הקשר להתאמה

החזרות

ContactGroup – קבוצת אנשי הקשר התואמת או הערך null אם לא נמצאה קבוצת אנשי קשר תואמת

הרשאות

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

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

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

• getContactGroups()

---

getContactGroupById(id)

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

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

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

פרמטרים

שם	תיאור	התיאור
id	String	המזהה של קבוצת אנשי הקשר להתאמה

החזרות

ContactGroup – קבוצת אנשי הקשר התואמת או הערך null אם לא נמצאה קבוצת אנשי קשר תואמת

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

• getContactGroups()

---

getContactGroups()

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

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

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

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

החזרות

ContactGroup[] – מערך של קבוצות אנשי הקשר של המשתמש

הרשאות

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

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

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

• getContactGroup(name)

---

getContacts()

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

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

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

החזרות

Contact[] – מערך של כל אנשי הקשר של המשתמש

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByAddress(query)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות של איש הקשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

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

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

פרמטרים

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

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByCompany(query)

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

קבלת אנשי קשר שתואמים לשדה 'חברה'.

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בשדה החברה של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

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

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

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

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

פרמטרים

שם	תיאור	התיאור
query	Object	המחרוזת שיש לחפש בשדה המותאם אישית של איש הקשר
label	ExtendedField	השדה המותאם אישית שבו רוצים לחפש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
month	Month	החודש להתאמה, כאחד מהערכים מ-contactApp.Month
day	Integer	היום להתאמה
label	Field	השדה שבו יש לחפש, מתוך contactsApp.Field

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
month	Month	החודש להתאמה, כאחד מהערכים מ-contactApp.Month
day	Integer	היום להתאמה
year	Integer	שנת ההתאמה יכולה להיות אפס
label	Field	השדה שבו יש לחפש, מתוך contactsApp.Field

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
month	Month	החודש להתאמה, כאחד מהערכים מ-contactApp.Month
day	Integer	היום להתאמה
year	Integer	שנת ההתאמה יכולה להיות אפס
label	String	השדה המותאם אישית שבו רוצים לחפש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
month	Month	החודש להתאמה, כאחד מהערכים מ-contactApp.Month
day	Integer	היום להתאמה
label	String	השדה המותאם אישית שבו רוצים לחפש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query)

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

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

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

פרמטרים

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

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות אימייל ליצירת קשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות אימייל ליצירת קשר עם התווית של כתובת האימייל המותאמת אישית.
label	String	התווית של כתובת האימייל המותאמת אישית כדי לחפש בתוך

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByGroup(group)

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

קבל את אנשי הקשר ב-contactGroup נתון.

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

פרמטרים

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

החזרות

Contact[] – מערך של אנשי קשר בקבוצה הנתונה

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByIM(query)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות להעברת הודעות מיידיות של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות להעברת הודעות מיידיות של איש הקשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות של איש הקשר להעברת הודעות מיידיות עם התווית שצוינה אישית להעברת הודעות מיידיות
label	String	התווית המותאמת אישית להעברת הודעות מיידיות

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByJobTitle(query)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בשדה תיאור התפקיד של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByName(query)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בשמות של אנשי הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByName(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בשמות של אנשי הקשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByNotes(query)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בשדה ההערות של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByPhone(query)

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

חיפוש אנשי קשר שתואמים למספר טלפון מסוים.

השיטה הזו תרחיב מספרי טלפון באותיות, כך שאם תחפשו '212-555-CODE' ותקבלו '212-555-2633' באנשי הקשר שלכם או להיפך, השיטה תמצא את איש הקשר המתאים.

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

פרמטרים

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

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

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

השיטה הזו תרחיב מספרי טלפון באותיות, כך שאם תחפשו '212-555-CODE' ותקבלו '212-555-2633' באנשי הקשר שלכם או להיפך, השיטה תמצא את איש הקשר המתאים.

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש במספרי הטלפון של איש הקשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

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

השיטה הזו תרחיב מספרי טלפון באותיות, כך שאם תחפשו '212-555-CODE' ותקבלו '212-555-2633' באנשי הקשר שלכם או להיפך, השיטה תמצא את איש הקשר המתאים.

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

פרמטרים

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

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByUrl(query)

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

קבלת אנשי קשר שתואמים לכתובת URL.

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות האתר של איש הקשר

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

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

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות האתר של איש הקשר
label	Field	השדה שבו יתבצע החיפוש

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

קבלת אנשי קשר שתואמים לכתובת URL, מוגבלת לתווית של כתובת ה-URL המותאמת אישית שצוינה.

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

פרמטרים

שם	תיאור	התיאור
query	String	המחרוזת שיש לחפש בכתובות ה-URL של איש הקשר עם התווית של כתובת ה-URL המותאמת אישית
label	String	בתווית של כתובת ה-URL המותאמת אישית כדי לחפש בתוך

החזרות

Contact[] – מערך של אנשי קשר תואמים

הרשאות

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

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

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

• getContact(emailAddress)