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[] همه آدرس‌های IM را برای این مخاطب دریافت می‌کند.
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 شماره تلفن کاری این مخاطب را تنظیم می کند.

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

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

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

برچسب می تواند از 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

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

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

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

// 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

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

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

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

برچسب می تواند از 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

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

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

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

برچسب می تواند از 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

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

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

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

// 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

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

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

برچسب می تواند از 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

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

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

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

برچسب می تواند از 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

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

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

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

// 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

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

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

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

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

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

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

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

مجوز

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

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

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

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

// 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

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

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

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

برچسب می تواند از 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

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

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

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

// 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

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

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

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

// 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[] - گروه هایی که این مخاطب را در بر می گیرند

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

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

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

// 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

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

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

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

این برچسب می تواند یک برچسب استاندارد از 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

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

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

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

// 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

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

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

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

این برچسب می تواند یک برچسب استاندارد از 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

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

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

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

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

این برچسب می تواند یک برچسب استاندارد از 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

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

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

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

// 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

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

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

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

// 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

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

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

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

// 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

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

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

برچسب می تواند از 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

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

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

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

var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
var id = contact.getId();

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

// 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

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

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

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

// 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

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

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

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

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

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

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

برچسب می تواند از 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

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

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

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

// 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

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

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

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

// 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

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

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

// 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

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

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

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

// 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

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

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

همه 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

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

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

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

برچسب می تواند از 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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

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

// 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

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

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

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

// 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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

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

// 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

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

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

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

پارامترها

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

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

پارامترها

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

مجوز

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

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

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

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

// 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

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

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

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

پارامترها

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

مجوز

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

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

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

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

// 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

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

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

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

// 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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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

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

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

پارامترها

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

مجوز

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

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