تمت إزالة هذا العمود. استخدِم بدلاً من ذلك خدمة People API المتقدّمة.
حقل عنوان URL في جهة اتصال.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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
: العنوان كسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
- تصنيف هذا الحقل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
address | String | العنوان الجديد |
استرجاع الكرة
: هذا الحقل مفيد للسلاسلUrlField
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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 هذه للتسلسلUrlField
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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 هذه للتسلسلUrlField
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | التصنيف الجديد لهذا الحقل |
استرجاع الكرة
: هذا الحقل مفيد للسلاسلUrlField
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds