Class Contact

連絡先

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

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