דף זה תורגם על ידי Cloud Translation API.

Class EmailField

הוצא משימוש. במקום זאת, כדאי להשתמש בשירות המתקדם של People API

שדה אימייל באיש קשר.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`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 – הכתובת כמחרוזת

אישור

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

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 – ערך השדה הזה לשרשור

אישור

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

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 – ערך השדה הזה לשרשור

אישור

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

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