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

Class EmailField

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 email 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
`getAddress()`	`String`	Lấy địa chỉ cho trường này.
`getLabel()`	`Object`	Lấy nhãn cho trường này.
`isPrimary()`	`Boolean`	Xác định xem đây có phải là giá trị trường chính hay không.
`setAddress(address)`	`EmailField`	Đặt địa chỉ của trường này.
`setAsPrimary()`	`EmailField`	Đặt trường này thành chính.
`setLabel(field)`	`EmailField`	Đặt nhãn của trường này.
`setLabel(label)`	`EmailField`	Đặ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
`deleteEmailField()`	`void`	Xoá địa chỉ email này khỏi mục Liên hệ.
`getDisplayName()`	`String`	Trả về tên hiển thị cho địa chỉ email này.
`setDisplayName(name)`	`EmailField`	Đặt tên hiển thị cho địa chỉ email 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

EmailField – trường này hữu ích cho việc tạo 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

`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

EmailField – FieldValue này để tạo 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

`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`	`Field`	nhãn tiêu chuẩn mới

Cầu thủ trả bóng

EmailField – FieldValue này để tạo 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

`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

EmailField – trường này hữu ích cho việc tạo 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

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

`deleteEmailField()`

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á địa chỉ email này khỏi mục Liên hệ.

// Retrieves and deletes the work email address for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

Ủ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

`getDisplayName()`

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.

Trả về tên hiển thị cho địa chỉ email này.

// Logs the display name for the work email address for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
Logger.log(workEmail[0].getDisplayName());

Cầu thủ trả bóng

String – tên hiển thị của email 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

`setDisplayName(name)`

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.

Đặt tên hiển thị cho địa chỉ email này.

// Sets the display name to 'Doe, John' for the work email address for contact
// 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên hiển thị mới cho địa chỉ email này

Cầu thủ trả bóng

EmailField – trường email này hữu ích cho việc tạo 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