Class ContactGroup

ContactGroup

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

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

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

שיטה	סוג הערך שמוחזר	תיאור קצר
addContact(contact)	ContactGroup	הוספת איש הקשר הנתון לקבוצה
deleteGroup()	void	מחיקת הקבוצה הזו של אנשי קשר.
getContacts()	Contact[]	הצגת כל אנשי הקשר שבקבוצת אנשי הקשר הזו.
getGroupName()	String	מחזירה את השם של קבוצה זו.
getId()	String	הפונקציה מקבלת את המזהה של קבוצת אנשי הקשר הזו.
getName()	String	קבלת השם של קבוצת אנשי הקשר הזו.
isSystemGroup()	Boolean	מקבלת ערך בוליאני כדי לקבוע אם קבוצת אנשי קשר זו היא קבוצת מערכת (לא ניתנת למחיקה) או לא.
removeContact(contact)	ContactGroup	הסרת איש הקשר שנבחר מהקבוצה
setGroupName(name)	void	הגדרת השם של הקבוצה הזו.
setName(name)	ContactGroup	הגדרת השם של הקבוצה הזו של אנשי קשר.

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

addContact(contact)

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

הוספת איש הקשר הנתון לקבוצה

// The code below creates a new contact and adds it to the "Work Friends" contact group
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

פרמטרים

שם	תיאור	התיאור
contact	Contact	איש הקשר שיתווסף לקבוצה

החזרות

ContactGroup - הקבוצה הזו של אנשי קשר

הרשאות

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

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

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

• removeContact(contact)

---

deleteGroup()

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

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

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

// The code below retrieves a contact group named "Work Friends" and deletes it
var group = ContactsApp.getContactGroup('Work Friends');
group.deleteGroup();

הרשאות

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

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

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

• isSystemGroup()

---

getContacts()

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

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

// The code below retrieves all the contacts in the group named "Work Friends"
var group = ContactsApp.getContactGroup('Work Friends');
var contacts = group.getContacts();

החזרות

Contact[] – אנשי הקשר בקבוצה הזו

הרשאות

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

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

---

getGroupName()

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

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

החזרות

String – שם הקבוצה הזו

הרשאות

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

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

---

getId()

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

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

// The code below retrieves a contact group named "Work Friends" and gets its id
var group = ContactsApp.getContactGroup('Work Friends');
var id = group.getId();

החזרות

String – המזהה של הקבוצה הזו

הרשאות

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

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

---

getName()

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

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

// The code below creates a new contact group and then retrieves its name
var group = ContactsApp.createContactGroup('Work Friends');
var name = group.getName();

החזרות

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

הרשאות

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

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

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

• setName(name)

---

isSystemGroup()

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

מקבלת ערך בוליאני כדי לקבוע אם קבוצת אנשי קשר זו היא קבוצת מערכת (לא ניתנת למחיקה) או לא.

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

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
var myGroup = ContactsApp.getContactGroup('Work Friends');
var systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup()); // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup()); // Returns true.

החזרות

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

הרשאות

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

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

---

removeContact(contact)

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

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

// The code below retrieves all the contacts named "John Doe' and removes them from the
// "Work Friends" contact group
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  group.removeContact(contacts[i]);
}

פרמטרים

שם	תיאור	התיאור
contact	Contact	איש הקשר שיוסר מהקבוצה

החזרות

ContactGroup - הקבוצה הזו של אנשי קשר

הרשאות

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

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

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

• addContact(contact)

---

setGroupName(name)

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

הגדרת השם של הקבוצה הזו.

פרמטרים

שם	תיאור	התיאור
name	String	השם שצריך להגדיר לקבוצה הזו

הרשאות

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

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

---

setName(name)

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

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

// The code below retrieves the contact group named "Work Friends" and renames it to
// "Work Buddies"
var group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

פרמטרים

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

החזרות

ContactGroup - הקבוצה הזו של אנשי קשר

הרשאות

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

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

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

• getName()