Class PhoneField

PhoneField

تمّت إزالة هذا العمود. بدلاً من ذلك، يمكنك استخدام People API المتقدمة الخدمة

حقل رقم الهاتف في جهة اتصال.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
getLabel()	Object	الحصول على تصنيف هذا الحقل
isPrimary()	Boolean	يحدد ما إذا كانت هذه هي قيمة الحقل الأساسية.
setAsPrimary()	PhoneField	لضبط هذا الحقل على أنّه أساسي.
setLabel(field)	PhoneField	لضبط تصنيف هذا الحقل.
setLabel(label)	PhoneField	لضبط تصنيف هذا الحقل.

طرق متوقّفة نهائيًا

الطريقة	نوع الإرجاع	وصف قصير
deletePhoneField()	void	يؤدي هذا الإجراء إلى حذف حقل رقم الهاتف هذا.
getPhoneNumber()	String	يمكنك الحصول على رقم الهاتف لهذا الحقل.
setPhoneNumber(number)	PhoneField	لضبط رقم الهاتف لهذا الحقل.

الوثائق التفصيلية

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 - تصنيف هذا الحقل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

• 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

---

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

الإرجاع

PhoneField — قيمة 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	التصنيف القياسي الجديد

الإرجاع

PhoneField — قيمة 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	التصنيف الجديد لهذا الحقل

الإرجاع

PhoneField — هذا الحقل مفيد للتسلسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

طرق متوقّفة نهائيًا

deletePhoneField()

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يؤدي هذا الإجراء إلى حذف حقل رقم الهاتف هذا.

// Retrieves and deletes the work phone number field for contact 'John
// Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].deletePhoneField();

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

---

getPhoneNumber()

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يمكنك الحصول على رقم الهاتف لهذا الحقل.

// Logs the work phone number for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
Logger.log(phoneFields[0].getPhoneNumber());

الإرجاع

String: الرقم كسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

---

setPhoneNumber(number)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

لضبط رقم الهاتف لهذا الحقل.

// Sets the work phone number for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var phoneFields = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
phoneFields[0].setPhoneNumber('212-555-1234');

المعلمات

الاسم	النوع	الوصف
number	String	الرقم الجديد

الإرجاع

PhoneField — هذا الحقل مفيد للتسلسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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