Class EmailField

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.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

החזרות

String - הכתובת כמחרוזת

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

---

getLabel()

הפונקציה מקבלת את התווית של השדה הזה. השדה יכול להיות Field , ExtendedField או String.

// 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 – התווית של השדה הזה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• 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 – האם זו הכתובת הראשית

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

פרמטרים

שם	תיאור	התיאור
address	String	הכתובת החדשה

החזרות

EmailField – השדה הזה, שימושי לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

החזרות

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.
var contacts = ContactsApp.getContactsByName('John Doe');
var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var 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'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

---

getDisplayName()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הפונקציה מחזירה את השם המוצג של כתובת האימייל הזו.

// Logs the display name for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var 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 the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

פרמטרים

שם	תיאור	התיאור
name	String	השם החדש לתצוגה של כתובת האימייל הזו

החזרות

EmailField – שדה האימייל הזה, שימושי לשרשורים

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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