Class Contact

تماس بگیرید

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

یک مخاطب شامل نام، آدرس و جزئیات تماس مختلف یک مخاطب است.

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

روش	نوع برگشت	شرح مختصر
addAddress(label, address)	AddressField	آدرسی را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.
addCompany(company, title)	CompanyField	یک شرکت را به مخاطب اضافه می کند.
addCustomField(label, content)	CustomField	یک فیلد سفارشی را با یک برچسب توسعه یافته یا سفارشی به مخاطب اضافه می کند.
addDate(label, month, day, year)	DateField	تاریخ را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.
addEmail(label, address)	EmailField	یک آدرس ایمیل با یک برچسب استاندارد (خانه، محل کار و غیره) یا یک برچسب سفارشی اضافه کنید
addIM(label, address)	IMField	آدرس پیام فوری را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.
addPhone(label, number)	PhoneField	یک شماره تلفن با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.
addToGroup(group)	Contact	این مخاطب را به گروه تماس داده شده اضافه می کند.
addUrl(label, url)	UrlField	URL را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.
deleteContact()	void	این مخاطب را حذف می کند.
getAddresses()	AddressField[]	همه آدرس های این مخاطب را دریافت می کند.
getAddresses(label)	AddressField[]	همه آدرس‌های این مخاطب را با یک فیلد خاص مطابقت می‌دهد.
getCompanies()	CompanyField[]	همه شرکت ها را برای این تماس دریافت می کند.
getContactGroups()	ContactGroup[]	تمام گروه های مخاطبی را که حاوی این مخاطب هستند دریافت می کند.
getCustomFields()	CustomField[]	تمام فیلدهای سفارشی این مخاطب را دریافت می کند.
getCustomFields(label)	CustomField[]	همه فیلدهای سفارشی را برای این مخاطب مطابق با یک فیلد خاص دریافت می کند.
getDates()	DateField[]	تمام تاریخ های این مخاطب را دریافت می کند.
getDates(label)	DateField[]	همه تاریخ‌های مربوط به این مخاطب را با یک فیلد خاص مطابقت می‌دهد.
getEmailAddresses()	String[]	فهرستی از آدرس‌های ایمیل موجود برای این مخاطب را دریافت می‌کند.
getEmails()	EmailField[]	آدرس ایمیل این مخاطب را دریافت می کند.
getEmails(label)	EmailField[]	آدرس‌های ایمیل این مخاطب را مطابق با یک فیلد خاص دریافت می‌کند.
getFamilyName()	String	نام خانوادگی (نام خانوادگی) مخاطب را به صورت رشته ای دریافت می کند.
getFullName()	String	نام کامل (نام و نام خانوادگی) مخاطب را به صورت رشته ای دریافت می کند.
getGivenName()	String	نام داده شده (نام) مخاطب را به عنوان یک رشته دریافت می کند.
getHomeAddress()	String	آدرس خانه این مخاطب را دریافت می کند، یا اگر هیچ یک از آنها وجود نداشته باشد، رشته خالی را دریافت می کند.
getHomeFax()	String	شماره فکس اصلی این مخاطب یا رشته خالی را دریافت می کند اگر هیچ کدام وجود نداشته باشد.
getHomePhone()	String	شماره تلفن اصلی این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.
getIMs()	IMField[]	تمام آدرس های پیام فوری این مخاطب را دریافت می کند.
getIMs(label)	IMField[]	همه آدرس های پیام فوری را برای این مخاطب مطابق با یک فیلد خاص دریافت می کند.
getId()	String	شناسه منحصربه‌فرد این مخاطب را برمی‌گرداند.
getInitials()	String	حروف اول مخاطب را دریافت می کند.
getLastUpdated()	Date	تاریخ آخرین به روز رسانی این مخاطب را دریافت می کند.
getMaidenName()	String	نام اصلی مخاطب را به عنوان یک رشته دریافت می کند.
getMiddleName()	String	نام میانی مخاطب را به عنوان یک رشته دریافت می کند.
getMobilePhone()	String	شماره تلفن همراه این مخاطب یا رشته خالی را در صورتی که وجود نداشته باشد دریافت می کند.
getNickname()	String	نام مستعار مخاطب را به صورت رشته ای دریافت می کند.
getNotes()	String	یادداشت‌های مرتبط با این مخاطب را دریافت می‌کند، یا اگر هیچ یادداشتی وجود نداشته باشد، یک رشته خالی دریافت می‌کند.
getPager()	String	شماره تلفن پیجر این مخاطب یا رشته خالی را در صورتی که وجود نداشته باشد دریافت می کند.
getPhones()	PhoneField[]	همه شماره تلفن های این مخاطب را دریافت می کند.
getPhones(label)	PhoneField[]	همه شماره تلفن های این مخاطب را که با یک فیلد خاص مطابقت دارند دریافت می کند.
getPrefix()	String	پیشوند نام مخاطب را دریافت می کند.
getPrimaryEmail()	String	آدرس ایمیل اصلی مخاطب را به صورت رشته ای دریافت می کند.
getShortName()	String	نام کوتاه مخاطب را به صورت رشته ای دریافت می کند.
getSuffix()	String	پسوند نام مخاطب را دریافت می کند.
getUrls()	UrlField[]	همه URL های این مخاطب را دریافت می کند.
getUrls(label)	UrlField[]	همه نشانی‌های اینترنتی را برای این مخاطب مطابق با یک فیلد خاص دریافت می‌کند.
getUserDefinedField(key)	String	مقدار تعریف شده کاربر مرتبط با کلید داده شده را دریافت می کند.
getUserDefinedFields()	Object	تمام فیلدهای تعریف شده توسط کاربر را برای این مخاطب دریافت می کند و آنها را به عنوان ویژگی های یک شی جاوا اسکریپت برمی گرداند.
getWorkAddress()	String	آدرس محل کار این مخاطب یا رشته خالی را در صورت وجود ندارد.
getWorkFax()	String	شماره فکس کاری این مخاطب یا رشته خالی را در صورت وجود دریافت می کند.
getWorkPhone()	String	شماره تلفن محل کار این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.
removeFromGroup(group)	Contact	این مخاطب را از گروه تماس داده شده حذف می کند.
setFamilyName(familyName)	Contact	نام خانوادگی (نام خانوادگی) مخاطب را تنظیم می کند.
setFullName(fullName)	Contact	نام کامل (نام و نام خانوادگی) مخاطب را تنظیم می کند.
setGivenName(givenName)	Contact	نام داده شده (نام) مخاطب را تنظیم می کند.
setHomeAddress(addr)	void	آدرس خانه این مخاطب را تنظیم می کند.
setHomeFax(phone)	void	شماره فکس خانگی این مخاطب را تنظیم می کند.
setHomePhone(phone)	void	شماره تلفن خانه این مخاطب را تنظیم می کند.
setInitials(initials)	Contact	حروف اول مخاطب را تنظیم می کند.
setMaidenName(maidenName)	Contact	نام اصلی مخاطب را تنظیم می کند.
setMiddleName(middleName)	Contact	نام میانی مخاطب را تنظیم می کند.
setMobilePhone(phone)	void	شماره تلفن همراه این مخاطب را تنظیم می کند.
setNickname(nickname)	Contact	نام مستعار مخاطب را تنظیم می کند.
setNotes(notes)	Contact	یادداشت های مرتبط با این مخاطب را تنظیم می کند.
setPager(phone)	void	شماره پیجر این مخاطب را تنظیم می کند.
setPrefix(prefix)	Contact	پیشوند نام مخاطب را تنظیم می کند.
setPrimaryEmail(primaryEmail)	void	آدرس ایمیل اصلی این مخاطب را تنظیم می کند.
setShortName(shortName)	Contact	نام کوتاه مخاطب را تنظیم می کند.
setSuffix(suffix)	Contact	پسوند نام مخاطب را تنظیم می کند.
setUserDefinedField(key, value)	void	یک فیلد تعریف شده توسط کاربر را برای این مخاطب تنظیم می کند تا با یک کلید مشخص ذخیره شود.
setUserDefinedFields(o)	void	فیلدهای تعریف شده توسط کاربر برای این تماس را با ویژگی های شی داده شده تنظیم می کند.
setWorkAddress(addr)	void	آدرس کار این مخاطب را تنظیم می کند.
setWorkFax(phone)	void	شماره فکس کاری این مخاطب را تنظیم می کند.
setWorkPhone(phone)	void	شماره تلفن کاری این مخاطب را تنظیم می کند.

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

addAddress(label, address)

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

آدرسی را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var address = contacts[0].addAddress(ContactsApp.Field.WORK_ADDRESS,
                                    '123 Main St, Some City, NY 10011');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب آدرس جدید، یا از ContactsApp.Field یا یک رشته سفارشی
address	String	آدرس جدید

بازگشت

AddressField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getAddresses()

---

addCompany(company, title)

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

یک شرکت را به مخاطب اضافه می کند.

// The code below retrieves a contact named "John Doe" and adds the company "Google" and the
// job title "Product Manager".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

پارامترها

نام	تایپ کنید	توضیحات
company	String	نام شرکتی که باید به این مخاطب اضافه شود
title	String	عنوان شغلی مرتبط با این مخاطب برای این شرکت

بازگشت

CompanyField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getCompanies()

---

addCustomField(label, content)

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

یک فیلد سفارشی را با یک برچسب توسعه یافته یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.ExtendedField یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field named 'HOBBY'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب آدرس جدید، یا از ContactsApp.ExtendedField یا یک رشته سفارشی
content	Object	مقدار برای ذخیره در فیلد سفارشی

بازگشت

CustomField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getCustomFields()

---

addDate(label, month, day, year)

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

تاریخ را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب تاریخ جدید، یا از ContactsApp.Field یا یک رشته سفارشی
month	Month	ماه، از ContactApps.Month
day	Integer	روز
year	Integer	سال

بازگشت

DateField - تاریخ تازه ایجاد شده

مجوز

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

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

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

• getDates()

---

addEmail(label, address)

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

یک آدرس ایمیل با یک برچسب استاندارد (خانه، محل کار و غیره) یا یک برچسب سفارشی اضافه کنید

// The code below retrieves a contact named "John Doe" and adds the email address
// "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب ایمیل جدید، یا از ContactsApp.Field یا یک رشته سفارشی
address	String	آدرس ایمیل جدید

بازگشت

EmailField - فیلد تازه اضافه شده

مجوز

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

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

---

addIM(label, address)

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

آدرس پیام فوری را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds the IM address "ChatWithJohn"
// with the the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب آدرس پیام فوری جدید، یا از ContactsApp.Field یا یک رشته سفارشی
address	String	آدرس IM جدید

بازگشت

IMField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getIMs()

---

addPhone(label, number)

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

یک شماره تلفن با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب شماره تلفن جدید، یا از ContactsApp.Field یا یک رشته سفارشی
number	String	شماره تلفن جدید

بازگشت

PhoneField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getPhones()

---

addToGroup(group)

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

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

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

پارامترها

نام	تایپ کنید	توضیحات
group	ContactGroup	گروه تماس برای افزودن این مخاطب به آن

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• removeFromGroup(group)

---

addUrl(label, url)

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

URL را با برچسب استاندارد یا سفارشی به مخاطب اضافه می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addUrl(ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com');

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب آدرس جدید، یا از ContactsApp.Field یا یک رشته سفارشی
url	String	URL جدید

بازگشت

UrlField - فیلد تازه ایجاد شده

مجوز

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

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

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

• getUrls()

---

deleteContact()

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

این مخاطب را حذف می کند.

var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].deleteContact();
}

مجوز

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

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

---

getAddresses()

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

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

// The code below logs the addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

بازگشت

AddressField[] - لیستی از آدرس ها

مجوز

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

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

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

• addAddress(label, address)

---

getAddresses(label)

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

همه آدرس‌های این مخاطب را با یک فیلد خاص مطابقت می‌دهد.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

AddressField[] - لیستی از آدرس ها

مجوز

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

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

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

• addAddress(label, address)

---

getCompanies()

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

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

// The code below logs the company names of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

بازگشت

CompanyField[] - فهرستی از شرکت ها

مجوز

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

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

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

• addCompany(company, title)

---

getContactGroups()

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

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

// The code below gets a contact named "John Doe" and retrieves all the contact groups that
// the contact belongs to
var contacts = ContactsApp.getContactsByName('John Doe');
var groups = contacts[0].getContactGroups();

بازگشت

ContactGroup[] - گروه هایی که این مخاطب را در بر می گیرند

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

• addToGroup(group)

---

getCustomFields()

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

تمام فیلدهای سفارشی این مخاطب را دریافت می کند.

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

بازگشت

CustomField[] - لیستی از فیلدهای سفارشی

مجوز

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

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

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

• addCustomField(label, content)

---

getCustomFields(label)

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

همه فیلدهای سفارشی را برای این مخاطب مطابق با یک فیلد خاص دریافت می کند.

این برچسب می تواند یک برچسب استاندارد از ContactsApp.ExtendedField یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact that are in the ContactsApp.ExtendedField.HOBBY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.ExtendedField یا یک رشته سفارشی

بازگشت

CustomField[] - فهرستی از فیلدهای سفارشی

مجوز

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

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

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

• addCustomField(label, content)

---

getDates()

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

تمام تاریخ‌های این مخاطب را دریافت می‌کند.

// The code below retrieves a contact named "John Doe" and logs the label of the date
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

بازگشت

DateField[] - فهرستی از تاریخ ها

مجوز

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

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

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

• addDate(label, month, day, year)

---

getDates(label)

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

همه تاریخ‌های مربوط به این مخاطب را با یک فیلد خاص مطابقت می‌دهد.

این برچسب می تواند یک برچسب استاندارد از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the day of the month
// associated with that contact that are in the ContactsApp.Field.BIRTHDAY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

DateField[] - فهرستی از تاریخ ها

مجوز

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

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

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

• addDate(label, month, day, year)

---

getEmailAddresses()

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

فهرستی از آدرس‌های ایمیل موجود برای این مخاطب را دریافت می‌کند.

بازگشت

String[] - فهرستی از آدرس های ایمیل موجود برای این مخاطب

مجوز

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

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

---

getEmails()

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

آدرس ایمیل این مخاطب را دریافت می کند.

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

بازگشت

EmailField[] - فهرست آدرس‌های ایمیل برای مخاطب

مجوز

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

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

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

• addEmail(label, address)

---

getEmails(label)

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

آدرس‌های ایمیل این مخاطب را مطابق با یک فیلد خاص دریافت می‌کند.

این برچسب می تواند یک برچسب استاندارد از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact that are in the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

EmailField[] - فهرست آدرس‌های ایمیل برای مخاطب

مجوز

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

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

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

• addEmail(label, address)

---

getFamilyName()

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

نام خانوادگی (نام خانوادگی) مخاطب را به صورت رشته ای دریافت می کند.

// The code below logs the family name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

بازگشت

String - نام خانوادگی مخاطب

مجوز

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

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

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

• setFamilyName(familyName)

---

getFullName()

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

نام کامل (نام و نام خانوادگی) مخاطب را به صورت رشته ای دریافت می کند.

// The code below logs the full name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFullName());
}

بازگشت

String - نام کامل مخاطب

مجوز

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

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

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

• setFullName(fullName)

---

getGivenName()

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

نام داده شده (نام) مخاطب را به عنوان یک رشته دریافت می کند.

// The code below logs the given name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

بازگشت

String - نام داده شده مخاطب

مجوز

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

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

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

• setGivenName(givenName)

---

getHomeAddress()

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

آدرس خانه این مخاطب را دریافت می کند، یا اگر هیچ یک از آنها وجود نداشته باشد، رشته خالی را دریافت می کند.

بازگشت

String - آدرس خانه این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getHomeFax()

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

شماره فکس اصلی این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.

بازگشت

String - شماره فکس اصلی این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getHomePhone()

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

شماره تلفن اصلی این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.

بازگشت

String - شماره تلفن اصلی این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getIMs()

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

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

// The code below logs the IM addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

بازگشت

IMField[] - لیستی از آدرس های IM

مجوز

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

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

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

• addIM(label, address)

---

getIMs(label)

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

همه آدرس های پیام فوری را برای این مخاطب مطابق با یک فیلد خاص دریافت می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK label.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

IMField[] - لیستی از آدرس های IM

مجوز

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

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

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

• addIM(label, address)

---

getId()

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

شناسه منحصربه‌فرد این مخاطب را برمی‌گرداند.

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var id = contact.getId();

بازگشت

String - شناسه این مخاطب

مجوز

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

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

---

getInitials()

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

حروف اول مخاطب را دریافت می کند.

// The code below logs the initials of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getInitials());
}

بازگشت

String - حروف اول مخاطب

مجوز

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

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

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

• setInitials(initials)

---

getLastUpdated()

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

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

// The code below logs the last updated date of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

بازگشت

Date - تاریخ آخرین به روز رسانی این مخاطب

مجوز

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

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

---

getMaidenName()

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

نام اصلی مخاطب را به عنوان یک رشته دریافت می کند.

// The code below logs the maiden name of all the contacts whose names contain "Jane"
var contacts = ContactsApp.getContactsByName('Jane');
for (var i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

بازگشت

String - نام اصلی مخاطب

مجوز

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

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

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

• setMaidenName(maidenName)

---

getMiddleName()

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

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

// The code below logs the middle name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

بازگشت

String - نام میانی مخاطب

مجوز

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

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

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

• setMiddleName(middleName)

---

getMobilePhone()

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

شماره تلفن همراه این مخاطب یا رشته خالی را در صورتی که وجود نداشته باشد دریافت می کند.

بازگشت

String - شماره تلفن همراه این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getNickname()

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

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

// The code below logs the nickname of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNickname());
}

بازگشت

String - نام مستعار مخاطب

مجوز

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

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

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

• setNickname(nickname)

---

getNotes()

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

یادداشت‌های مرتبط با این مخاطب را دریافت می‌کند، یا اگر هیچ یادداشتی وجود نداشته باشد، یک رشته خالی دریافت می‌کند.

// The code below logs the notes of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNotes());
}

بازگشت

String - یادداشت های مرتبط با این مخاطب

مجوز

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

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

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

• setNotes(notes)

---

getPager()

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

شماره تلفن پیجر این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.

بازگشت

String - شماره تلفن پیجر این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getPhones()

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

همه شماره تلفن های این مخاطب را دریافت می کند.

// The code below logs the phone numbers of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

بازگشت

PhoneField[] - فهرستی از شماره تلفن

مجوز

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

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

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

• addPhone(label, number)

---

getPhones(label)

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

همه شماره تلفن های این مخاطب را که با یک فیلد خاص مطابقت دارند دریافت می کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the phone numbers
// associated with that contact that are in the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

PhoneField[] - فهرستی از شماره تلفن

مجوز

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

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

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

• addPhone(label, number)

---

getPrefix()

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

پیشوند نام مخاطب را دریافت می کند.

// The code below logs the prefix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

بازگشت

String - پیشوند نام مخاطب

مجوز

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

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

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

• setPrefix(prefix)

---

getPrimaryEmail()

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

آدرس ایمیل اصلی مخاطب را به صورت رشته ای دریافت می کند.

// The code below logs the primary email address of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

بازگشت

String - آدرس ایمیل اصلی مخاطب

مجوز

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

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

---

getShortName()

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

نام کوتاه مخاطب را به صورت رشته ای دریافت می کند.

// The code below logs the short name of all the contacts whose names contain "Johnathan"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var i in contacts) {
  Logger.log(contacts[i].getShortName());
}

بازگشت

String - نام کوتاه مخاطب

مجوز

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

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

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

• setShortName(shortName)

---

getSuffix()

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

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

// The code below logs the suffix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

بازگشت

String - پسوند نام مخاطب

مجوز

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

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

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

• setSuffix(suffix)

---

getUrls()

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

همه URL های این مخاطب را دریافت می کند.

// The code below logs the URLs of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

بازگشت

UrlField[] - فهرستی از URL ها

مجوز

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

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

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

• addUrl(label, url)

---

getUrls(label)

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

همه نشانی‌های اینترنتی را برای این مخاطب مطابق با یک فیلد خاص دریافت می‌کند.

برچسب می تواند از ContactsApp.Field یا یک رشته برچسب سفارشی باشد.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

پارامترها

نام	تایپ کنید	توضیحات
label	Object	برچسب برای مطابقت، یا از ContactsApp.Field یا یک رشته سفارشی

بازگشت

UrlField[] - فهرستی از URL ها

مجوز

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

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

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

• addUrl(label, url)

---

getUserDefinedField(key)

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

مقدار تعریف شده کاربر مرتبط با کلید داده شده را دریافت می کند.

پارامترها

نام	تایپ کنید	توضیحات
key	String	کلید می تواند هر نوع اصلی باشد (String، int و غیره)

بازگشت

String - محتوای تعریف شده توسط کاربر که با این کلید ذخیره شده است

مجوز

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

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

---

getUserDefinedFields()

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

تمام فیلدهای تعریف شده توسط کاربر را برای این مخاطب دریافت می کند و آنها را به عنوان ویژگی های یک شی جاوا اسکریپت برمی گرداند.

بازگشت

Object - فیلدهایی را که کاربر برای این مخاطب تعریف کرده است، به عنوان ویژگی های یک شی جاوا اسکریپت

مجوز

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

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

---

getWorkAddress()

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

آدرس محل کار این مخاطب یا رشته خالی را در صورت وجود ندارد.

بازگشت

String - آدرس کار این مخاطب، یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getWorkFax()

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

شماره فکس کاری این مخاطب یا رشته خالی را در صورت وجود دریافت می کند.

بازگشت

String - شماره فکس کار این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

getWorkPhone()

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

شماره تلفن محل کار این مخاطب یا رشته خالی را دریافت می کند، اگر هیچ کدام وجود نداشته باشد.

بازگشت

String - شماره تلفن کار این مخاطب یا رشته خالی اگر وجود ندارد

مجوز

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

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

---

removeFromGroup(group)

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

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

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

پارامترها

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

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• addToGroup(group)

---

setFamilyName(familyName)

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

نام خانوادگی (نام خانوادگی) مخاطب را تنظیم می کند.

// The code below changes the family name of all the contacts whose names are "John Doe"
// to "Doe-Smith"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

پارامترها

نام	تایپ کنید	توضیحات
familyName	String	نام خانوادگی جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getFamilyName()

---

setFullName(fullName)

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

نام کامل (نام و نام خانوادگی) مخاطب را تنظیم می کند.

// The code below changes the full name of all the contacts whose names are "John Doe"
// to "Johnny Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

پارامترها

نام	تایپ کنید	توضیحات
fullName	String	نام کامل جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getFullName()

---

setGivenName(givenName)

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

نام داده شده (نام) مخاطب را تنظیم می کند.

// The code below changes the given name of all the contacts whose names are "John Doe"
// to "Johnny"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setGivenName('Johnny');
}

پارامترها

نام	تایپ کنید	توضیحات
givenName	String	نام داده شده جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getGivenName()

---

setHomeAddress(addr)

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

آدرس خانه این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
addr	String	آدرس خانه برای تنظیم

مجوز

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

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

---

setHomeFax(phone)

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

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

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره فکس خانگی برای تنظیم

مجوز

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

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

---

setHomePhone(phone)

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

شماره تلفن خانه این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره تلفن خانه برای تنظیم

مجوز

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

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

---

setInitials(initials)

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

حروف اول مخاطب را تنظیم می کند.

// The code below sets the initials of all the contacts whose names are "Johnathan Doe"
// to "JD"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setInitials('JD');
}

پارامترها

نام	تایپ کنید	توضیحات
initials	String	حروف اول جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getInitials()

---

setMaidenName(maidenName)

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

نام اصلی مخاطب را تنظیم می کند.

// The code below changes the maiden name of all the contacts whose names are "Jane Doe"
// to "Smith"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var i in contacts) {
  contacts[i].setMaidenName('Smith');
}

پارامترها

نام	تایپ کنید	توضیحات
maidenName	String	نام دخترانه جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getMaidenName()

---

setMiddleName(middleName)

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

نام میانی مخاطب را تنظیم می کند.

// The code below changes the middle name of all the contacts whose names are "John Doe"
// to "Danger"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setMiddleName('Danger');
}

پارامترها

نام	تایپ کنید	توضیحات
middleName	String	نام میانی جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getMiddleName()

---

setMobilePhone(phone)

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

شماره تلفن همراه این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره تلفن همراه برای تنظیم

مجوز

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

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

---

setNickname(nickname)

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

نام مستعار مخاطب را تنظیم می کند.

// The code below changes the nickname of all the contacts whose names are "John Doe"
// to "JohnnyD"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

پارامترها

نام	تایپ کنید	توضیحات
nickname	String	نام مستعار جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getNickname()

---

setNotes(notes)

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

یادداشت های مرتبط با این مخاطب را تنظیم می کند.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

پارامترها

نام	تایپ کنید	توضیحات
notes	String	یادداشت هایی که برای این مخاطب ذخیره می شود

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getNotes()

---

setPager(phone)

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

شماره پیجر این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره پیجر برای تنظیم

مجوز

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

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

---

setPrefix(prefix)

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

پیشوند نام مخاطب را تنظیم می کند.

// The code below sets the prefix of all the contacts whose names are "Johnathan Doe"
// to "Mr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setPrefix('Mr');
}

پارامترها

نام	تایپ کنید	توضیحات
prefix	String	پیشوند جدید نام مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getPrefix()

---

setPrimaryEmail(primaryEmail)

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

آدرس ایمیل اصلی این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
primaryEmail	String	آدرس ایمیل اصلی برای تنظیم

مجوز

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

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

---

setShortName(shortName)

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

نام کوتاه مخاطب را تنظیم می کند.

// The code below changes the short name of all the contacts whose names are "Johnathan Doe"
// to "John"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setShortName('John');
}

پارامترها

نام	تایپ کنید	توضیحات
shortName	String	نام کوتاه جدید مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getShortName()

---

setSuffix(suffix)

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

پسوند نام مخاطب را تنظیم می کند.

// The code below sets the suffix of all the contacts whose names are "Johnathan Doe"
// to "Jr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

پارامترها

نام	تایپ کنید	توضیحات
suffix	String	پسوند جدید نام مخاطب

بازگشت

Contact - این مخاطب

مجوز

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

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

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

• getSuffix()

---

setUserDefinedField(key, value)

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

یک فیلد تعریف شده توسط کاربر را برای این مخاطب تنظیم می کند تا با یک کلید مشخص ذخیره شود.

پارامترها

نام	تایپ کنید	توضیحات
key	String	کلید می تواند هر نوع اصلی باشد (String، int و غیره)
value	String	مقدار می تواند از هر نوع اصلی باشد (String، int و غیره)

مجوز

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

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

---

setUserDefinedFields(o)

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

فیلدهای تعریف شده توسط کاربر برای این تماس را با ویژگی های شی داده شده تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
o	Object	یک شی با یک یا چند ویژگی به شکل {key: value}

مجوز

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

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

---

setWorkAddress(addr)

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

آدرس کار این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
addr	String	آدرس محل کار برای تنظیم

مجوز

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

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

---

setWorkFax(phone)

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

شماره فکس کاری این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره فکس کار برای تنظیم

مجوز

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

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

---

setWorkPhone(phone)

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

شماره تلفن کاری این مخاطب را تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
phone	String	شماره تلفن محل کار برای تنظیم

مجوز

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

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