הוצא משימוש. במקום זאת, צריך להשתמש בשירות המתקדם של People API
קבוצת אנשי קשר היא קבוצה של אנשי קשר.
שיטות שהוצאו משימוש
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
|
| הוספת איש הקשר הנתון לקבוצה |
| void | מחיקת הקבוצה הזו של אנשי קשר. |
|
| הצגת כל אנשי הקשר שבקבוצת אנשי הקשר הזו. |
| String | מחזירה את השם של קבוצה זו. |
| String | הפונקציה מקבלת את המזהה של קבוצת אנשי הקשר הזו. |
| String | קבלת השם של קבוצת אנשי הקשר הזו. |
| Boolean | מקבלת ערך בוליאני כדי לקבוע אם קבוצת אנשי קשר זו היא קבוצת מערכת (לא ניתנת למחיקה) או לא. |
|
| הסרת איש הקשר שנבחר מהקבוצה |
| void | הגדרת השם של הקבוצה הזו. |
|
| הגדרת השם של הקבוצה הזו של אנשי קשר. |
שיטות שהוצאו משימוש
addContact(contact)
addContact(contact)
הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הוספת איש הקשר הנתון לקבוצה
// The code below creates a new contact and adds it to the "Work Friends" contact group var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com'); var group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
contact |
| איש הקשר שיתווסף לקבוצה |
החזרות
- הקבוצה הזו של אנשי קשרContactGroup
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.google.com/m8/feeds
כדאי לעיין גם בפרטים הבאים
deleteGroup()
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
כדאי לעיין גם בפרטים הבאים
getContacts()
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()
getGroupName()
הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
מחזירה את השם של קבוצה זו.
החזרות
String
– שם הקבוצה הזו
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.google.com/m8/feeds
getId()
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()
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
כדאי לעיין גם בפרטים הבאים
isSystemGroup()
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)
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 |
| איש הקשר שיוסר מהקבוצה |
החזרות
- הקבוצה הזו של אנשי קשרContactGroup
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.google.com/m8/feeds
כדאי לעיין גם בפרטים הבאים
setGroupName(name)
setGroupName(name)
הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הגדרת השם של הקבוצה הזו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
name | String | השם שצריך להגדיר לקבוצה הזו |
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.google.com/m8/feeds
setName(name)
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