דף זה תורגם על ידי Cloud Translation API.

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 "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

פרמטרים

שם	סוג	תיאור
`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
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
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
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

פרמטרים

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

חזרה

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

אישור

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

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

`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 "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

פרמטרים

שם	סוג	תיאור
`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 "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    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 "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    '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)`

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

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

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

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

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

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