Class ContactGroup

گروه تماس

منسوخ شده است. در عوض، از سرویس پیشرفته People API استفاده کنید

گروه تماس گروهی از مخاطبین است.

روش های منسوخ شده

روش	نوع برگشت	شرح مختصر
add Contact(contact)	Contact Group	مخاطب داده شده را به این گروه اضافه می کند // The code below creates a new contact and adds it to the "Work Friends" // contact group const contact = ContactsApp.createContact( 'John', 'Doe', '[e-mail]', ); const group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
delete Group()	void	این گروه تماس را حذف می کند.
get Contacts()	Contact[]	تمام مخاطبین این گروه تماس را دریافت می کند.
get Group Name()	String	نام این گروه را برمی گرداند.
get Id()	String	شناسه این گروه تماس را دریافت می کند.
get Name()	String	نام این گروه تماس را دریافت می کند.
is System Group()	Boolean	برای تعیین اینکه آیا این گروه مخاطب یک گروه سیستمی (غیرقابل حذف) است یا خیر، یک مقدار بولی دریافت می کند.
remove Contact(contact)	Contact Group	مخاطب داده شده را از این گروه حذف می کند // The code below retrieves all the contacts named "John Doe' and removes them // from the "Work Friends" contact group const contacts = ContactsApp.getContactsByName('John Doe'); const group = ContactsApp.getContactGroup('Work Friends'); for (const i in contacts) { group.removeContact(contacts[i]); }
set Group Name(name)	void	نام این گروه را تنظیم می کند.
set Name(name)	Contact Group	نام این گروه تماس را تنظیم می کند.

روش های منسوخ شده

add Contact(contact)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

مخاطب داده شده را به این گروه اضافه می کند

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

پارامترها

نام	تایپ کنید	توضیحات
contact	Contact	مخاطبی که باید به گروه اضافه شود

بازگشت

Contact Group - این گروه تماس

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

• remove Contact(contact)

---

delete Group()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

این گروه تماس را حذف می کند.

فقط گروه های غیر سیستمی را حذف می کند. گروه های سیستم را نمی توان حذف کرد.

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

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

• is System Group()

---

get Contacts()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

تمام مخاطبین این گروه تماس را دریافت می کند.

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

بازگشت

Contact[] — مخاطبین این گروه

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

get Group Name()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

نام این گروه را برمی گرداند.

بازگشت

String - نام این گروه

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

get Id()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

شناسه این گروه تماس را دریافت می کند.

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

بازگشت

String - شناسه این گروه

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

get Name()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

نام این گروه تماس را دریافت می کند.

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

بازگشت

String - این نام این گروه تماس است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

• set Name(name)

---

is System Group()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

برای تعیین اینکه آیا این گروه مخاطب یک گروه سیستمی (غیرقابل حذف) است یا خیر، یک مقدار بولی دریافت می کند.

گروه‌های سیستمی مجموعه‌ای از گروه‌هایی هستند که در Google Contacts از پیش تعریف شده‌اند، مانند «مخاطبین من»، «خانواده»، «همکاران» و غیره. نام یک گروه سیستم معمولاً حاوی کلمات «گروه سیستم» است.

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
const myGroup = ContactsApp.getContactGroup('Work Friends');
const 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

---

remove Contact(contact)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

مخاطب داده شده را از این گروه حذف می کند

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

پارامترها

نام	تایپ کنید	توضیحات
contact	Contact	مخاطبی که باید از گروه حذف شود

بازگشت

Contact Group - این گروه تماس

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

• add Contact(contact)

---

set Group Name(name)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

نام این گروه را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
name	String	نامی که باید برای این گروه تعیین کنید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

set Name(name)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

نام این گروه تماس را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
name	String	نام جدید برای گروه تماس

بازگشت

Contact Group - این گروه تماس

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

• get Name()