Class IMField

IMField

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

یک فیلد پیام فوری در یک مخاطب.

روش ها

روش	نوع برگشت	شرح مختصر
getAddress()	String	آدرس این فیلد را دریافت کنید.
getLabel()	Object	برچسب این فیلد را دریافت می کند.
isPrimary()	Boolean	دریافت می کند که آیا این مقدار فیلد اصلی است یا خیر.
setAddress(address)	IMField	آدرس این فیلد را تنظیم می کند.
setAsPrimary()	IMField	این فیلد را روی اولیه قرار می دهد.
setLabel(field)	IMField	برچسب این فیلد را تنظیم می کند.
setLabel(label)	IMField	برچسب این فیلد را تنظیم می کند.

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

روش	نوع برگشت	شرح مختصر
deleteIMField()	void	این قسمت پیام رسانی فوری را حذف می کند.

مستندات دقیق

getAddress()

آدرس این فیلد را دریافت کنید.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

بازگشت

String - آدرس به عنوان یک رشته

مجوز

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

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

---

getLabel()

برچسب این فیلد را دریافت می کند. این ممکن است یک فیلد، ExtendedField یا یک رشته باشد.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

بازگشت

Object - برچسب این فیلد

مجوز

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

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

---

isPrimary()

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

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

بازگشت

Boolean - آیا این اولیه است

مجوز

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

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

---

setAddress(address)

آدرس این فیلد را تنظیم می کند.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

پارامترها

نام	تایپ کنید	توضیحات
address	String	آدرس جدید

بازگشت

IMField - این فیلد برای زنجیره‌بندی مفید است

مجوز

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

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

---

setAsPrimary()

این فیلد را روی اولیه قرار می دهد.

// Sets the the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

بازگشت

IMField - این FieldValue برای زنجیره‌سازی

مجوز

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

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

---

setLabel(field)

برچسب این فیلد را تنظیم می کند.

// Sets the label to 'Work' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

پارامترها

نام	تایپ کنید	توضیحات
field	Field	برچسب استاندارد جدید

بازگشت

IMField - این FieldValue برای زنجیره‌سازی

مجوز

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

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

---

setLabel(label)

برچسب این فیلد را تنظیم می کند.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

پارامترها

نام	تایپ کنید	توضیحات
label	String	برچسب جدید برای این زمینه

بازگشت

IMField - این فیلد برای زنجیره‌بندی مفید است

مجوز

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

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

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

deleteIMField()

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

این قسمت پیام رسانی فوری را حذف می کند.

// Retrieves and deletes the AIM instant messaging field for contact 'John
// Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var imFields = contacts[0].getIMs(ContactsApp.Field.AIM);
imFields[0].deleteIMField();

مجوز

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

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