หน้านี้ได้รับการแปลโดย Cloud Translation API

Class EmailField

เลิกใช้งานแล้ว แต่ให้ใช้บริการขั้นสูงของ People API แทน

ช่องอีเมลในรายชื่อติดต่อ

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getAddress()`	`String`	รับที่อยู่สำหรับช่องนี้
`getLabel()`	`Object`	รับป้ายกำกับของช่องนี้
`isPrimary()`	`Boolean`	รับว่านี่เป็นค่าช่องหลักหรือไม่
`setAddress(address)`	`EmailField`	ตั้งค่าที่อยู่ของช่องนี้
`setAsPrimary()`	`EmailField`	ตั้งค่าช่องนี้เป็นค่าหลัก
`setLabel(field)`	`EmailField`	ตั้งค่าป้ายกํากับของช่องนี้
`setLabel(label)`	`EmailField`	ตั้งค่าป้ายกํากับของช่องนี้

วิธีการที่เลิกใช้งาน

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`deleteEmailField()`	`void`	ลบอีเมลนี้ออกจากรายชื่อติดต่อ
`getDisplayName()`	`String`	แสดงชื่อที่แสดงสําหรับอีเมลนี้
`setDisplayName(name)`	`EmailField`	ตั้งค่าชื่อที่แสดงสําหรับอีเมลนี้

เอกสารประกอบโดยละเอียด

`getAddress()`

รับที่อยู่สำหรับช่องนี้

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

รีเทิร์น

String — ที่อยู่เป็นสตริง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`address`	`String`	ที่อยู่ใหม่

รีเทิร์น

EmailField — ช่องนี้มีประโยชน์สำหรับการต่อเชื่อม

การให้สิทธิ์

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

`setAsPrimary()`

ตั้งค่าช่องนี้เป็นค่าหลัก

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

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`field`	`Field`	ป้ายกำกับมาตรฐานใหม่

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`label`	`String`	ป้ายกำกับใหม่สำหรับช่องนี้

รีเทิร์น

EmailField — ช่องนี้มีประโยชน์สำหรับการต่อเชื่อม

การให้สิทธิ์

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

วิธีการที่เลิกใช้งาน

`deleteEmailField()`

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ลบอีเมลนี้ออกจากรายชื่อติดต่อ

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

การให้สิทธิ์

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

`getDisplayName()`

แสดงชื่อที่แสดงสําหรับอีเมลนี้

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

รีเทิร์น

String — ชื่อที่แสดงสําหรับอีเมลนี้

การให้สิทธิ์

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

`setDisplayName(name)`

ตั้งค่าชื่อที่แสดงสําหรับอีเมลนี้

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อที่แสดงใหม่สำหรับอีเมลนี้

รีเทิร์น

EmailField — ช่องอีเมลนี้มีประโยชน์สำหรับการต่อเชื่อม

การให้สิทธิ์

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