Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao của API People
Trường tin nhắn nhanh trong một Người liên hệ.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
get | String | Lấy địa chỉ cho trường này. |
get | Object | Lấy nhãn cho trường này. |
is | Boolean | Xác định xem đây có phải là giá trị trường chính hay không. |
set |
| Đặt địa chỉ của trường này. |
set |
| Đặt trường này thành chính. |
set |
| Đặt nhãn của trường này. |
set |
| Đặt nhãn của 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 |
---|---|---|
| void | Xoá trường tin nhắn 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.
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 yêu cầu được uỷ 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à 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.
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 cho trường này
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.google.com/m8/feeds
isPrimary()
Xác định xem đâ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à phương thức chính không
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ỉ 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');
Tham số
Tên | Loại | Mô tả |
---|---|---|
address | String | địa chỉ mới |
Cầu thủ trả bóng
– trường này hữu ích cho việc tạo chuỗiIMField
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 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
– FieldValue này để tạo chuỗiIMField
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
field |
| nhãn tiêu chuẩn mới |
Cầu thủ trả bóng
– FieldValue này để tạo chuỗiIMField
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của 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');
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
– trường này hữu ích cho việc tạo chuỗiIMField
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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()
deleteIMField()
Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.
Xoá trường tin nhắn nhanh 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.google.com/m8/feeds