Class ContactGroup

ContactGroup

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

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

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

שיטה	סוג הערך המוחזר	תיאור קצר
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()