Class IMField

IMField

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

ช่องการรับส่งข้อความโต้ตอบแบบทันทีในรายชื่อติดต่อ

เมธอด

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

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
deleteIMField()	void	ลบช่องการรับส่งข้อความทันทีนี้

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

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 — ป้ายกำกับของช่องนี้

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

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

• 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 — ระบุว่าเป็นภาษาหลักหรือไม่

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

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

• 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	ที่อยู่ใหม่

รีเทิร์น

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

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

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

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

รีเทิร์น

IMField — FieldValue นี้สําหรับการต่อเชื่อม

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

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

• 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	ป้ายกำกับมาตรฐานใหม่

รีเทิร์น

IMField — FieldValue นี้สําหรับการต่อเชื่อม

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

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

• 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	ป้ายกำกับใหม่สำหรับช่องนี้

รีเทิร์น

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

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

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

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

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

deleteIMField()

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

ลบช่องการรับส่งข้อความทันทีนี้

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

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

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

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