Class ContactsApp

אפליקציית אנשי קשר

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

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

נכסים שהוצאו משימוש

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

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

שיטה	סוג הערך המוחזר	תיאור קצר
createContact(givenName, familyName, email)	Contact	יצירת איש קשר חדש.
createContactGroup(name)	ContactGroup	יצירת קבוצת אנשי קשר בשם הנתון // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
deleteContact(contact)	void	מחיקה של איש הקשר.
deleteContactGroup(group)	void	מחיקה של קבוצת אנשי הקשר // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
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[]	אחזור של אנשי הקשר בקבוצת אנשי קשר נתונה.
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]".
const 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"
const 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.
const 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"
const 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]".
const 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"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.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"
const 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"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const 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.
const groups = ContactsApp.getContactGroups();
for (let 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
const 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'.
const 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.
const 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".
const 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".
const contacts = ContactsApp.getContactsByCompany('Google');

פרמטרים

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

חזרה

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

אישור

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

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

ראה גם

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

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

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

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

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

פרמטרים

שם	סוג	תיאור
month	Month	החודש שרוצים להתאים, כאחד מהערכים מ-ContactsApp.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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

פרמטרים

שם	סוג	תיאור
month	Month	החודש שרוצים להתאים, כאחד מהערכים מ-ContactsApp.Month
day	Integer	היום שבו מתבצעת ההתאמה
year	Integer	השנה שתואמת, יכול להיות null
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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

פרמטרים

שם	סוג	תיאור
month	Month	החודש שרוצים להתאים, כאחד מהערכים מ-ContactsApp.Month
day	Integer	היום שבו מתבצעת ההתאמה
year	Integer	השנה שתואמת, יכול להיות null
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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

פרמטרים

שם	סוג	תיאור
month	Month	החודש שרוצים להתאים, כאחד מהערכים מ-ContactsApp.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]'.
const 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.
const 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".
const contacts = ContactsApp.getContactsByEmailAddress(
    '[e-mail]',
    'alternate',
);

פרמטרים

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

חזרה

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

אישור

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

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

ראה גם

• getContact(emailAddress)

---

getContactsByGroup(group)

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

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

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const 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.
const 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.
const 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".
const 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".
const 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"
const 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.
const 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".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

פרמטרים

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

חזרה

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

אישור

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

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

ראה גם

• getContact(emailAddress)

---

getContactsByPhone(query)

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

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

השיטה הזו תרחיב מספרי טלפון עם אותיות, כך שאם מחפשים את המספר '212-555-קוד' ויש ברשימת אנשי הקשר את המספר '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.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

פרמטרים

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

חזרה

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

אישור

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

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

ראה גם

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

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

השיטה הזו תרחיב מספרי טלפון עם אותיות, כך שאם מחפשים את המספר '212-555-קוד' ויש ברשימת אנשי הקשר את המספר '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.
const 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-קוד' ויש ברשימת אנשי הקשר את המספר '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".
const 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.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

פרמטרים

שם	סוג	תיאור
query	String	המחרוזת שיש לחפש בכתובות ה-URL של אנשי הקשר

חזרה

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.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

פרמטרים

שם	סוג	תיאור
query	String	המחרוזת שיש לחפש בכתובות ה-URL של אנשי הקשר
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".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

פרמטרים

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

חזרה

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

אישור

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

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

ראה גם

• getContact(emailAddress)