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	החודש התואם, כאחד מהערכים מ-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.
var 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.
var 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.
var 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]'.
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	המחרוזת שיש לחפש בכתובות ה-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.
var 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".
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)