このページは Cloud Translation API によって翻訳されました。

Class CustomField

連絡先のカスタムフィールド。

メソッド

メソッド	戻り値の型	概要
`getLabel()`	`Object`	このフィールドのラベルを取得します。
`setLabel(label)`	`CustomField`	このフィールドのラベルを設定します。

サポート終了のメソッド

メソッド	戻り値の型	概要
`deleteCustomField()`	`void`	このフィールドを削除します。
`getValue()`	`Object`	フィールドの値を取得します。
`setLabel(field)`	`CustomField`	このフィールドのラベルを設定します。
`setValue(value)`	`CustomField`	このフィールドの値を設定します。

詳細なドキュメント

`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

`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 - このフィールド、チェーンに便利です

承認

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

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

承認

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

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 - フィールドに格納される値

承認

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

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 - このフィールド、チェーンに便利です

承認

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

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 - このフィールド、チェーンに便利です

承認

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

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