Class AddressField

AddressField

เลิกใช้งานแล้ว โปรดใช้บริการขั้นสูงของ People API แทน

ช่องที่อยู่ในรายชื่อติดต่อ

วิธีการ

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

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

getAddress()

รับที่อยู่ของช่องนี้

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

รีเทิร์น

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
addressStringที่อยู่ใหม่

รีเทิร์น

AddressField — ช่องนี้เหมาะสำหรับการทำเชน

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

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

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

setAsPrimary()

ตั้งค่าฟิลด์นี้เป็นฟิลด์หลัก

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

รีเทิร์น

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
fieldFieldป้ายกำกับมาตรฐานใหม่

รีเทิร์น

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
labelStringป้ายกำกับใหม่สำหรับช่องนี้

รีเทิร์น

AddressField — ช่องนี้เหมาะสำหรับการทำเชน

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

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

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

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