Class UrlField

UrlField

非推奨。代わりに、People API Advanced の サービス

連絡先の URL フィールド。

メソッド

メソッド	戻り値の型	概要
getAddress()	String	このフィールドのアドレスを取得します。
getLabel()	Object	このフィールドのラベルを取得します。
isPrimary()	Boolean	これがプライマリ フィールド値かどうかを取得します。
setAddress(address)	UrlField	このフィールドのアドレスを設定します。
setAsPrimary()	UrlField	このフィールドをプライマリに設定します。
setLabel(field)	UrlField	このフィールドのラベルを設定します。
setLabel(label)	UrlField	このフィールドのラベルを設定します。

サポート終了のメソッド

メソッド	戻り値の型	概要
deleteUrlField()	void	この URL フィールドを削除します。

詳細なドキュメント

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 - 文字列でのアドレス

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• 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 - このフィールドのラベル

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• 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 - プライマリかどうか

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• 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	新しい住所

戻る

UrlField - このフィールド、チェーン接続に有用

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

戻る

UrlField - この FieldValue（チェーン用）

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• 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	新しい標準ラベルは

戻る

UrlField - この FieldValue（チェーン用）

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

• 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	このフィールドの新しいラベルです。

戻る

UrlField - このフィールド、チェーンに便利です

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

サポート終了のメソッド

deleteUrlField()

非推奨。この関数は非推奨のため、新しいスクリプトでは使用しないでください。

この URL フィールドを削除します。

// Retrieves and deletes the Blog URL field for contact 'John
// Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var urlFields = contacts[0].getUrls(ContactsApp.Field.BLOG);
urlFields[0].deleteUrlField();

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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