Class IMField

IMField

Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao People API

Trường tin nhắn tức thời trong một Người liên hệ.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
getAddress()	String	Lấy địa chỉ cho trường này.
getLabel()	Object	Lấy nhãn cho trường này.
isPrimary()	Boolean	Lấy thông tin về việc đây có phải là giá trị trường chính hay không.
setAddress(address)	IMField	Đặt địa chỉ của trường này.
setAsPrimary()	IMField	Đặt trường này thành trường chính.
setLabel(field)	IMField	Đặt nhãn cho trường này.
setLabel(label)	IMField	Đặt nhãn cho trường này.

Các phương thức ngừng hoạt động

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
deleteIMField()	void	Xoá trường tin nhắn tức thời này.

Tài liệu chi tiết

getAddress()

Lấy địa chỉ cho trường này.

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

Cầu thủ trả bóng

String – địa chỉ dưới dạng chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

getLabel()

Lấy nhãn cho trường này. Đây có thể là Field, ExtendedField hoặc String.

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Cầu thủ trả bóng

Object – nhãn của trường này

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

isPrimary()

Lấy thông tin về việc đây có phải là giá trị trường chính hay không.

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Cầu thủ trả bóng

Boolean – liệu đây có phải là địa chỉ chính hay không

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

setAddress(address)

Đặt địa chỉ của trường này.

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

Thông số

Tên	Loại	Mô tả
address	String	địa chỉ mới

Cầu thủ trả bóng

IMField – trường này, hữu ích cho việc liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

setAsPrimary()

Đặt trường này thành trường chính.

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

Cầu thủ trả bóng

IMField – FieldValue này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

setLabel(field)

Đặt nhãn cho trường này.

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Thông số

Tên	Loại	Mô tả
field	Field	nhãn tiêu chuẩn mới

Cầu thủ trả bóng

IMField – FieldValue này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

---

setLabel(label)

Đặt nhãn cho trường này.

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Thông số

Tên	Loại	Mô tả
label	String	nhãn mới cho trường này

Cầu thủ trả bóng

IMField – trường này, hữu ích cho việc liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Các phương thức ngừng hoạt động

deleteIMField()

Không dùng nữa. Hàm này không còn được dùng nữa và bạn không nên sử dụng trong các tập lệnh mới.

Xoá trường tin nhắn tức thời này.

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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