این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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
// "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, 'j.doe@example.com');

مولفه های

نام	تایپ کنید	شرح
`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', 'john.doe@example.com');
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', 'john.doe@example.com');
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