Class CustomField

CustomField

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

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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
getLabel()	Object	الحصول على تصنيف هذا الحقل
setLabel(label)	CustomField	لضبط تصنيف هذا الحقل.

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

الطريقة	نوع الإرجاع	وصف قصير
deleteCustomField()	void	يؤدي هذا الإجراء إلى حذف هذا الحقل.
getValue()	Object	للحصول على قيمة الحقل.
setLabel(field)	CustomField	لضبط تصنيف هذا الحقل.
setValue(value)	CustomField	لضبط قيمة هذا الحقل.

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

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

---

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

الإرجاع

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

التفويض

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

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

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

deleteCustomField()

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

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

var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i = 0; i < fields.length; i++) {
  if (fields[i].getLabel() == 'foo') {
    fields[i].deleteCustomField();
  }
}

التفويض

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

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

---

getValue()

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

للحصول على قيمة الحقل.

// Logs the value of all the custom fields for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

الإرجاع

Object - القيمة المخزنة في الحقل

التفويض

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

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

---

setLabel(field)

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

لضبط تصنيف هذا الحقل.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

المعلمات

الاسم	النوع	الوصف
field	ExtendedField	التصنيف القياسي الجديد

الإرجاع

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

التفويض

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

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

---

setValue(value)

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

لضبط قيمة هذا الحقل.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

المعلمات

الاسم	النوع	الوصف
value	Object	والقيمة الجديدة

الإرجاع

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

التفويض

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

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