เลิกใช้งานแล้ว โปรดใช้บริการขั้นสูงของ People API แทน
ช่องที่อยู่ในรายชื่อติดต่อ
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
getAddress() | String | รับที่อยู่ของช่องนี้ |
getLabel() | Object | รับป้ายกำกับสำหรับช่องนี้ |
isPrimary() | Boolean | รับข้อมูลว่านี่เป็นค่าในช่องหลักหรือไม่ |
setAddress(address) |
| ตั้งค่าที่อยู่ของช่องนี้ |
setAsPrimary() |
| ตั้งค่าฟิลด์นี้เป็นฟิลด์หลัก |
setLabel(field) |
| ตั้งค่าป้ายกำกับของช่องนี้ |
setLabel(label) |
| ตั้งค่าป้ายกำกับของช่องนี้ |
เอกสารประกอบโดยละเอียด
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 | คำอธิบาย |
---|---|---|
address | String | ที่อยู่ใหม่ |
รีเทิร์น
— ช่องนี้เหมาะสำหรับการทำเชน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();
รีเทิร์น
— FieldValue นี้สำหรับการทำเชนAddressField
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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 | คำอธิบาย |
---|---|---|
field |
| ป้ายกำกับมาตรฐานใหม่ |
รีเทิร์น
— FieldValue นี้สำหรับการทำเชนAddressField
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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 | คำอธิบาย |
---|---|---|
label | String | ป้ายกำกับใหม่สำหรับช่องนี้ |
รีเทิร์น
— ช่องนี้เหมาะสำหรับการทำเชนAddressField
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.google.com/m8/feeds