Class Contact

連絡先

非推奨。代わりに、People API 拡張サービスを使用してください。

Contact には、連絡先の名前、住所、さまざまな連絡先情報が含まれます。

サポート終了のメソッド

メソッド	戻り値の型	概要
addAddress(label, address)	AddressField	標準ラベルまたはカスタムラベルを付けて、連絡先に住所を追加します。
addCompany(company, title)	CompanyField	会社を連絡先に追加します。
addCustomField(label, content)	CustomField	拡張ラベルまたはカスタムラベルを使用して連絡先にカスタム フィールドを追加します。
addDate(label, month, day, year)	DateField	標準ラベルまたはカスタムラベルを付けて、連絡先に日付を追加します。
addEmail(label, address)	EmailField	標準ラベル（自宅、職場など）またはカスタムラベルを使ってメールアドレスを追加します
addIM(label, address)	IMField	標準ラベルまたはカスタムラベルを使用して、連絡先に IM アドレスを追加します。
addPhone(label, number)	PhoneField	標準ラベルまたはカスタムラベルを付けて、連絡先に電話番号を追加します。
addToGroup(group)	Contact	この連絡先を指定の連絡先グループに追加します。
addUrl(label, url)	UrlField	標準ラベルまたはカスタムラベルを付けて、連絡先に URL を追加します。
deleteContact()	void	この連絡先を削除します。
getAddresses()	AddressField[]	この連絡先のすべての住所を取得します。
getAddresses(label)	AddressField[]	特定のフィールドに一致するこの連絡先のすべての住所を取得します。
getCompanies()	CompanyField[]	この連絡先のすべての会社を取得します。
getContactGroups()	ContactGroup[]	この連絡先を含むすべての連絡先グループを取得します。
getCustomFields()	CustomField[]	この連絡先のすべてのカスタム フィールドを取得します。
getCustomFields(label)	CustomField[]	特定のフィールドに一致するこの連絡先のすべてのカスタム フィールドを取得します。
getDates()	DateField[]	この連絡先のすべての日付を取得します。
getDates(label)	DateField[]	特定のフィールドに一致するこの連絡先のすべての日付を取得します。
getEmailAddresses()	String[]	この連絡先で使用できるメールアドレスのリストを取得します。
getEmails()	EmailField[]	この連絡先のメールアドレスを取得します。
getEmails(label)	EmailField[]	特定のフィールドに一致するこの連絡先のメールアドレスを取得します。
getFamilyName()	String	連絡先の姓（姓）を文字列として取得します。
getFullName()	String	連絡先のフルネーム（姓と名）を文字列として取得します。
getGivenName()	String	連絡先の名（名）を文字列として取得します。
getHomeAddress()	String	この連絡先の自宅の住所を取得します。存在しない場合は空の文字列です。
getHomeFax()	String	この連絡先の自宅 FAX 番号を取得します。存在しない場合は空の文字列です。
getHomePhone()	String	この連絡先の自宅の電話番号を取得します。存在しない場合は空の文字列です。
getIMs()	IMField[]	この連絡先のすべての IM アドレスを取得します。
getIMs(label)	IMField[]	特定のフィールドに一致するこの連絡先のすべての IM アドレスを取得します。
getId()	String	この連絡先の一意の ID を返します。
getInitials()	String	連絡先のイニシャルを取得します。
getLastUpdated()	Date	この連絡先が最後に更新された日付を取得します。
getMaidenName()	String	連絡先の旧姓を文字列として取得します。
getMiddleName()	String	連絡先のミドルネームを文字列として取得します。
getMobilePhone()	String	この連絡先の携帯電話番号を取得します。存在しない場合は空の文字列です。
getNickname()	String	連絡先のニックネームを文字列として取得します。
getNotes()	String	この連絡先に関連付けられているメモを取得します。メモがない場合は空の文字列を取得します。
getPager()	String	この連絡先のページャーの電話番号を取得します。存在しない場合は空の文字列です。
getPhones()	PhoneField[]	この連絡先のすべての電話番号を取得します。
getPhones(label)	PhoneField[]	特定のフィールドに一致するこの連絡先のすべての電話番号を取得します。
getPrefix()	String	連絡先の名前の接頭辞を取得します。
getPrimaryEmail()	String	連絡先のメインのメールアドレスを文字列として取得します。
getShortName()	String	連絡先の略称を文字列として取得します。
getSuffix()	String	連絡先の名前の接尾辞を取得します。
getUrls()	UrlField[]	この連絡先のすべての URL を取得します。
getUrls(label)	UrlField[]	特定のフィールドに一致するこの連絡先のすべての URL を取得します。
getUserDefinedField(key)	String	指定されたキーに関連付けられたユーザー定義の値を取得します。
getUserDefinedFields()	Object	この連絡先のユーザー定義フィールドをすべて取得し、JavaScript オブジェクトのプロパティとして返します。
getWorkAddress()	String	この連絡先の勤務先住所を取得します。住所が存在しない場合は空の文字列です。
getWorkFax()	String	この連絡先の仕事用 FAX 番号を取得します。存在しない場合は空の文字列です。
getWorkPhone()	String	この連絡先の仕事用電話番号を取得します。存在しない場合は空の文字列です。
removeFromGroup(group)	Contact	指定した連絡先グループからこの連絡先を削除します。
setFamilyName(familyName)	Contact	連絡先の姓を設定します。
setFullName(fullName)	Contact	連絡先のフルネーム（姓と名）を設定します。
setGivenName(givenName)	Contact	連絡先の名（ファースト ネーム）を設定します。
setHomeAddress(addr)	void	この連絡先の自宅の住所を設定します。
setHomeFax(phone)	void	この連絡先の自宅 FAX 番号を設定します。
setHomePhone(phone)	void	この連絡先の自宅の電話番号を設定します。
setInitials(initials)	Contact	連絡先のイニシャルを設定します。
setMaidenName(maidenName)	Contact	連絡先の旧姓を設定します。
setMiddleName(middleName)	Contact	連絡先のミドルネームを設定します。
setMobilePhone(phone)	void	この連絡先の携帯電話番号を設定します。
setNickname(nickname)	Contact	連絡先のニックネームを設定します。
setNotes(notes)	Contact	この連絡先に関連付けられているメモを設定します。
setPager(phone)	void	この連絡先のポケベル番号を設定します。
setPrefix(prefix)	Contact	連絡先の名前に接頭辞を設定します。
setPrimaryEmail(primaryEmail)	void	この連絡先のメインのメールアドレスを設定します。
setShortName(shortName)	Contact	連絡先の略称を設定します。
setSuffix(suffix)	Contact	連絡先の名前に接尾辞を設定します。
setUserDefinedField(key, value)	void	特定のキーで保存される、この連絡先のユーザー定義フィールドを 1 つ設定します。
setUserDefinedFields(o)	void	この連絡先のユーザー定義フィールドを、指定されたオブジェクトのプロパティに設定します。
setWorkAddress(addr)	void	この連絡先の勤務先住所を設定します。
setWorkFax(phone)	void	この連絡先の仕事用 FAX 番号を設定します。
setWorkPhone(phone)	void	この連絡先の仕事用の電話番号を設定します。

サポート終了のメソッド

addAddress(label, address)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベルまたはカスタムラベルを付けて、連絡先に住所を追加します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var address = contacts[0].addAddress(ContactsApp.Field.WORK_ADDRESS,
                                    '123 Main St, Some City, NY 10011');

パラメータ

名前	型	説明
label	Object	新しい住所のラベル。ContactsApp.Field またはカスタム文字列で指定します。
address	String	新しい住所

リターン

AddressField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getAddresses()

---

addCompany(company, title)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

会社を連絡先に追加します。

// The code below retrieves a contact named "John Doe" and adds the company "Google" and the
// job title "Product Manager".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

パラメータ

名前	型	説明
company	String	この連絡先に追加する会社名。
title	String	この会社のこの連絡先に関連付けられている役職

リターン

CompanyField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getCompanies()

---

addCustomField(label, content)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

拡張ラベルまたはカスタムラベルを使用して連絡先にカスタム フィールドを追加します。

ラベルには、ContactsApp.ExtendedField またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field named 'HOBBY'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

パラメータ

名前	型	説明
label	Object	新しい住所のラベル。ContactsApp.ExtendedField またはカスタム文字列で指定します。
content	Object	カスタム フィールドに格納する値。

リターン

CustomField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getCustomFields()

---

addDate(label, month, day, year)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベルまたはカスタムラベルを付けて、連絡先に日付を追加します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

パラメータ

名前	型	説明
label	Object	新しい日付のラベル。ContactsApp.Field またはカスタム文字列で指定します。
month	Month	ContactApps.Month からの
day	Integer	今日
year	Integer	年

リターン

DateField - 新しく作成された日付

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getDates()

---

addEmail(label, address)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベル（自宅、職場など）またはカスタムラベルを使ってメールアドレスを追加する

// The code below retrieves a contact named "John Doe" and adds the email address
// "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

パラメータ

名前	型	説明
label	Object	新しいメールのラベル。ContactsApp.Field またはカスタム文字列で指定します。
address	String	新しいメールアドレス

リターン

EmailField - 新しく追加されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

addIM(label, address)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベルまたはカスタムラベルを使用して、連絡先に IM アドレスを追加します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds the IM address "ChatWithJohn"
// with the the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

パラメータ

名前	型	説明
label	Object	新しい IM アドレスのラベル。ContactsApp.Field またはカスタム文字列で指定します。
address	String	新しい IM アドレス

リターン

IMField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getIMs()

---

addPhone(label, number)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベルまたはカスタムラベルを付けて、連絡先に電話番号を追加します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

パラメータ

名前	型	説明
label	Object	新しい電話番号のラベル。ContactsApp.Field またはカスタム文字列で指定します。
number	String	新しい電話番号

リターン

PhoneField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getPhones()

---

addToGroup(group)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先を指定の連絡先グループに追加します。

// The code below creates a new contact and then adds it to the contact group named
// "Work Friends"
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

パラメータ

名前	型	説明
group	ContactGroup	この連絡先を追加する連絡先グループ

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• removeFromGroup(group)

---

addUrl(label, url)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

標準ラベルまたはカスタムラベルを付けて連絡先の URL を追加します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addUrl(ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com');

パラメータ

名前	型	説明
label	Object	新しい住所のラベル。ContactsApp.Field またはカスタム文字列で指定します。
url	String	新しい URL

リターン

UrlField - 新しく作成されたフィールド

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getUrls()

---

deleteContact()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先を削除します。

var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].deleteContact();
}

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getAddresses()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての住所を取得します。

// The code below logs the addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

リターン

AddressField[] - アドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addAddress(label, address)

---

getAddresses(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべての住所を取得します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

AddressField[] - アドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addAddress(label, address)

---

getCompanies()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての会社を取得します。

// The code below logs the company names of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

リターン

CompanyField[] - 会社のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addCompany(company, title)

---

getContactGroups()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先を含むすべての連絡先グループを取得します。

// The code below gets a contact named "John Doe" and retrieves all the contact groups that
// the contact belongs to
var contacts = ContactsApp.getContactsByName('John Doe');
var groups = contacts[0].getContactGroups();

リターン

ContactGroup[] - この連絡先を含むグループ

関連ドキュメント

• addToGroup(group)

---

getCustomFields()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべてのカスタム フィールドを取得します。

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

リターン

CustomField[] - カスタム フィールドのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addCustomField(label, content)

---

getCustomFields(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべてのカスタム フィールドを取得します。

ラベルには、ContactsApp.ExtendedField の標準ラベルか、カスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact that are in the ContactsApp.ExtendedField.HOBBY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.ExtendedField またはカスタム文字列で指定します。

リターン

CustomField[] - カスタム フィールドのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addCustomField(label, content)

---

getDates()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての日付を取得します。

// The code below retrieves a contact named "John Doe" and logs the label of the date
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

リターン

DateField[] - 日付のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addDate(label, month, day, year)

---

getDates(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべての日付を取得します。

ラベルには、ContactsApp.Field の標準ラベルか、カスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the day of the month
// associated with that contact that are in the ContactsApp.Field.BIRTHDAY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

DateField[] - 日付のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addDate(label, month, day, year)

---

getEmailAddresses()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先で使用できるメールアドレスのリストを取得します。

リターン

String[] - この連絡先で使用できるメールアドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getEmails()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のメールアドレスを取得します。

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

リターン

EmailField[] - 連絡先のメールアドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addEmail(label, address)

---

getEmails(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のメールアドレスを取得します。

ラベルには、ContactsApp.Field の標準ラベルか、カスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact that are in the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

EmailField[] - 連絡先のメールアドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addEmail(label, address)

---

getFamilyName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の姓（姓）を文字列として取得します。

// The code below logs the family name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

リターン

String - 連絡先の姓

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setFamilyName(familyName)

---

getFullName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のフルネーム（姓と名）を文字列として取得します。

// The code below logs the full name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFullName());
}

リターン

String - 連絡先のフルネーム

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setFullName(fullName)

---

getGivenName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名（名）を文字列として取得します。

// The code below logs the given name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

リターン

String - 連絡先の名

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setGivenName(givenName)

---

getHomeAddress()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅の住所を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の自宅住所。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getHomeFax()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅 FAX 番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の自宅 FAX 番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getHomePhone()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅の電話番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の自宅の電話番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getIMs()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての IM アドレスを取得します。

// The code below logs the IM addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

リターン

IMField[] - IM アドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addIM(label, address)

---

getIMs(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべての IM アドレスを取得します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK label.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

IMField[] - IM アドレスのリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addIM(label, address)

---

getId()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の一意の ID を返します。

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var id = contact.getId();

リターン

String - この連絡先の ID

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getInitials()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のイニシャルを取得します。

// The code below logs the initials of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getInitials());
}

リターン

String - 連絡先のイニシャル

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setInitials(initials)

---

getLastUpdated()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の最終更新日を取得します。

// The code below logs the last updated date of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

リターン

Date - この連絡先の最終更新日

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getMaidenName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の旧姓を文字列として取得します。

// The code below logs the maiden name of all the contacts whose names contain "Jane"
var contacts = ContactsApp.getContactsByName('Jane');
for (var i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

リターン

String - 連絡先の旧姓

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setMaidenName(maidenName)

---

getMiddleName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のミドルネームを文字列として取得します。

// The code below logs the middle name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

リターン

String - 連絡先のミドルネーム

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setMiddleName(middleName)

---

getMobilePhone()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の携帯電話番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の携帯電話番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getNickname()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のニックネームを文字列として取得します。

// The code below logs the nickname of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNickname());
}

リターン

String - 連絡先のニックネーム

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setNickname(nickname)

---

getNotes()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先に関連付けられているメモを取得します。メモがない場合は空の文字列を取得します。

// The code below logs the notes of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNotes());
}

リターン

String - この連絡先に関連付けられているメモ

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setNotes(notes)

---

getPager()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のページャーの電話番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先のポケベル電話番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getPhones()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての電話番号を取得します。

// The code below logs the phone numbers of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

リターン

PhoneField[] - 電話番号のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addPhone(label, number)

---

getPhones(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべての電話番号を取得します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the phone numbers
// associated with that contact that are in the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

PhoneField[] - 電話番号のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addPhone(label, number)

---

getPrefix()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名前の接頭辞を取得します。

// The code below logs the prefix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

リターン

String - 連絡先の名前の接頭辞

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setPrefix(prefix)

---

getPrimaryEmail()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のメインのメールアドレスを文字列として取得します。

// The code below logs the primary email address of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

リターン

String - 連絡先のメインのメールアドレス

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getShortName()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の略称を文字列として取得します。

// The code below logs the short name of all the contacts whose names contain "Johnathan"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var i in contacts) {
  Logger.log(contacts[i].getShortName());
}

リターン

String - 連絡先の略称

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setShortName(shortName)

---

getSuffix()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名前の接尾辞を取得します。

// The code below logs the suffix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

リターン

String - 連絡先の名前の接尾辞

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• setSuffix(suffix)

---

getUrls()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のすべての URL を取得します。

// The code below logs the URLs of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

リターン

UrlField[] - URL のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addUrl(label, url)

---

getUrls(label)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のフィールドに一致するこの連絡先のすべての URL を取得します。

ラベルには、ContactsApp.Field またはカスタムラベル文字列のいずれかを使用できます。

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

パラメータ

名前	型	説明
label	Object	照合するラベル。ContactsApp.Field またはカスタム文字列で指定します。

リターン

UrlField[] - URL のリスト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addUrl(label, url)

---

getUserDefinedField(key)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

指定されたキーに関連付けられたユーザー定義の値を取得します。

パラメータ

名前	型	説明
key	String	任意の基本型（String、int など）をキーにすることができます。

リターン

String - このキーで保存されているユーザー定義のコンテンツ

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getUserDefinedFields()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のユーザー定義フィールドをすべて取得し、JavaScript オブジェクトのプロパティとして返します。

リターン

Object - この連絡先のユーザー定義フィールド（JavaScript オブジェクトのプロパティ）

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getWorkAddress()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の勤務先住所を取得します。住所が存在しない場合は空の文字列です。

リターン

String - この連絡先の勤務先住所。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getWorkFax()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の仕事用 FAX 番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の仕事用 FAX 番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

getWorkPhone()

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の仕事用電話番号を取得します。存在しない場合は空の文字列です。

リターン

String - この連絡先の仕事用電話番号。存在しない場合は空の文字列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

removeFromGroup(group)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

指定した連絡先グループからこの連絡先を削除します。

// The code below gets all the contacts named "John Doe" and then removes each of them from
// the "Work Friends" contact group
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

パラメータ

名前	型	説明
group	ContactGroup	この連絡先を削除する連絡先グループ

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• addToGroup(group)

---

setFamilyName(familyName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の姓を設定します。

// The code below changes the family name of all the contacts whose names are "John Doe"
// to "Doe-Smith"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

パラメータ

名前	型	説明
familyName	String	連絡先の新しい姓

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getFamilyName()

---

setFullName(fullName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のフルネーム（姓と名）を設定します。

// The code below changes the full name of all the contacts whose names are "John Doe"
// to "Johnny Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

パラメータ

名前	型	説明
fullName	String	連絡先の新しい氏名

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getFullName()

---

setGivenName(givenName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名（ファースト ネーム）を設定します。

// The code below changes the given name of all the contacts whose names are "John Doe"
// to "Johnny"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setGivenName('Johnny');
}

パラメータ

名前	型	説明
givenName	String	新しい名が入力されます。

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getGivenName()

---

setHomeAddress(addr)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅の住所を設定します。

パラメータ

名前	型	説明
addr	String	設定する自宅の住所

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setHomeFax(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅 FAX 番号を設定します。

パラメータ

名前	型	説明
phone	String	設定する自宅の FAX 番号

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setHomePhone(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の自宅の電話番号を設定します。

パラメータ

名前	型	説明
phone	String	設定する自宅の電話番号

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setInitials(initials)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のイニシャルを設定します。

// The code below sets the initials of all the contacts whose names are "Johnathan Doe"
// to "JD"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setInitials('JD');
}

パラメータ

名前	型	説明
initials	String	連絡先の新しいイニシャル

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getInitials()

---

setMaidenName(maidenName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の旧姓を設定します。

// The code below changes the maiden name of all the contacts whose names are "Jane Doe"
// to "Smith"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var i in contacts) {
  contacts[i].setMaidenName('Smith');
}

パラメータ

名前	型	説明
maidenName	String	連絡先の旧姓

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getMaidenName()

---

setMiddleName(middleName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のミドルネームを設定します。

// The code below changes the middle name of all the contacts whose names are "John Doe"
// to "Danger"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setMiddleName('Danger');
}

パラメータ

名前	型	説明
middleName	String	新しいミドルネーム

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getMiddleName()

---

setMobilePhone(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の携帯電話番号を設定します。

パラメータ

名前	型	説明
phone	String	設定する携帯電話番号

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setNickname(nickname)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先のニックネームを設定します。

// The code below changes the nickname of all the contacts whose names are "John Doe"
// to "JohnnyD"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

パラメータ

名前	型	説明
nickname	String	連絡先の新しいニックネーム

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getNickname()

---

setNotes(notes)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先に関連付けられているメモを設定します。

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

パラメータ

名前	型	説明
notes	String	この連絡先に対して保存されるメモです。

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getNotes()

---

setPager(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のポケベル番号を設定します。

パラメータ

名前	型	説明
phone	String	設定するページャー番号です

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setPrefix(prefix)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名前に接頭辞を設定します。

// The code below sets the prefix of all the contacts whose names are "Johnathan Doe"
// to "Mr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setPrefix('Mr');
}

パラメータ

名前	型	説明
prefix	String	新しい接頭辞

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getPrefix()

---

setPrimaryEmail(primaryEmail)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のメインのメールアドレスを設定します。

パラメータ

名前	型	説明
primaryEmail	String	設定するメインのメールアドレスです

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setShortName(shortName)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の略称を設定します。

// The code below changes the short name of all the contacts whose names are "Johnathan Doe"
// to "John"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setShortName('John');
}

パラメータ

名前	型	説明
shortName	String	連絡先の新しい略称

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getShortName()

---

setSuffix(suffix)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

連絡先の名前に接尾辞を設定します。

// The code below sets the suffix of all the contacts whose names are "Johnathan Doe"
// to "Jr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

パラメータ

名前	型	説明
suffix	String	新しいサフィックス

リターン

Contact - この連絡先

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

関連ドキュメント

• getSuffix()

---

setUserDefinedField(key, value)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

特定のキーで保存される、この連絡先のユーザー定義フィールドを 1 つ設定します。

パラメータ

名前	型	説明
key	String	任意の基本型（String、int など）をキーにすることができます。
value	String	任意の基本型（String、int など）を指定できます。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setUserDefinedFields(o)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先のユーザー定義フィールドを、指定されたオブジェクトのプロパティに設定します。

パラメータ

名前	型	説明
o	Object	{key: value} 形式の 1 つ以上のプロパティを持つオブジェクト

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setWorkAddress(addr)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の勤務先住所を設定します。

パラメータ

名前	型	説明
addr	String	設定する職場の住所です

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setWorkFax(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の仕事用 FAX 番号を設定します。

パラメータ

名前	型	説明
phone	String	設定する仕事の FAX 番号

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

---

setWorkPhone(phone)

非推奨。この関数は非推奨であるため、新しいスクリプトでは使用できません。

この連絡先の仕事用の電話番号を設定します。

パラメータ

名前	型	説明
phone	String	設定する仕事用電話番号

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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