Trang này được dịch bởi Cloud Translation API.

Class IMField

Không dùng nữa. Thay vào đó, hãy dùng API Người dùng nâng cao dịch vụ

Trường nhắn tin nhanh trong Danh bạ.

Phương thức

Phương thức	Loại 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 xem đây có phải là giá trị chính của trường hay không.
`setAddress(address)`	`IMField`	Đặt địa chỉ cho 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	Loại dữ liệu trả về	Mô tả ngắn
`deleteIMField()`	`void`	Xoá trường nhắn tin nhanh 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getLabel()`

Lấy nhãn cho trường này. Đây có thể là một Trường, ExtendedField hoặc Chuỗi.

// 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());
}

Cầu thủ trả bóng

Object — nhãn cho trường này

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`isPrimary()`

Lấy xem đây có phải là giá trị chính của trường 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Cầu thủ trả bóng

Boolean — đây có phải là danh sách chính hay không

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`setAddress(address)`

Đặt địa chỉ cho 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Tham 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 tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`setAsPrimary()`

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

// 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();

Cầu thủ trả bóng

IMField — trường này dùng để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Tham số

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

Cầu thủ trả bóng

IMField — trường này dùng để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Tham 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 tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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 dùng nữa và không nên dùng trong các tập lệnh mới.

Xoá trường nhắn tin nhanh này.

// 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();

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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