Added in API level 5

Summary: Constants

ContactsContract.DataColumns

Kotlin |Java

protected static interface ContactsContract.DataColumns

android.provider.ContactsContract.DataColumns

Known indirect subclasses

ContactsContract.CommonDataKinds.Callable	Convenient functionalities for "callable" data.
ContactsContract.CommonDataKinds.Contactables	A special class of data items, used to refer to types of data that can be used to attempt to start communicating with a person (`Phone` and `Email`).
ContactsContract.CommonDataKinds.Email	A data kind representing an email address.
ContactsContract.CommonDataKinds.Event	A data kind representing an event.
ContactsContract.CommonDataKinds.GroupMembership	Group Membership.
ContactsContract.CommonDataKinds.Identity	A data kind representing an Identity related to the contact.
ContactsContract.CommonDataKinds.Im	This class was deprecated in API level 35. This field may not be well supported by some contacts apps and is discouraged to use.
ContactsContract.CommonDataKinds.Nickname	A data kind representing the contact's nickname.
ContactsContract.CommonDataKinds.Note	Notes about the contact.
ContactsContract.CommonDataKinds.Organization	A data kind representing an organization.
ContactsContract.CommonDataKinds.Phone	A data kind representing a telephone number.
ContactsContract.CommonDataKinds.Photo	A data kind representing a photo for the contact.
ContactsContract.CommonDataKinds.Relation	A data kind representing a relation.
ContactsContract.CommonDataKinds.SipAddress	This class was deprecated in API level 35. This field may not be well supported by some contacts apps and is discouraged to use.
ContactsContract.CommonDataKinds.StructuredName	A data kind representing the contact's proper name.
ContactsContract.CommonDataKinds.StructuredPostal	A data kind representing a postal addresses.
ContactsContract.CommonDataKinds.Website	A data kind representing a website related to the contact.
ContactsContract.Contacts.Data	A sub-directory of a single contact that contains all of the constituent raw contact `ContactsContract.Data` rows.
ContactsContract.Contacts.Entity	A sub-directory of a contact that contains all of its `ContactsContract.RawContacts` as well as `ContactsContract.Data` rows.
ContactsContract.Contacts.Photo	A read-only sub-directory of a single contact that contains the contact's primary photo.
ContactsContract.Data	Constants for the data table, which contains data points tied to a raw contact.
ContactsContract.DataColumnsWithJoins	Combines all columns returned by `ContactsContract.Data` table queries.
ContactsContract.RawContacts.Data	A sub-directory of a single raw contact that contains all of its `ContactsContract.Data` rows.
ContactsContract.RawContacts.Entity	A sub-directory of a single raw contact that contains all of its `ContactsContract.Data` rows.
ContactsContract.RawContactsEntity	Constants for the raw contacts entities table, which can be thought of as an outer join of the raw_contacts table with the data table.

Columns in the Data table.

See also:

ContactsContract.Data

Summary

Constants
`String`	`CARRIER_PRESENCE` This constant was deprecated in API level 31. The contacts database will only show presence information on devices where `CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL` is true, otherwise use `RcsUceAdapter`.
`int`	`CARRIER_PRESENCE_VT_CAPABLE` This constant was deprecated in API level 31. Same as `DataColumns#CARRIER_PRESENCE`.
`String`	`DATA1` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA10` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA11` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA12` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA13` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA14` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA15` Generic data column, the meaning is `MIMETYPE` specific.
`String`	`DATA2` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA3` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA4` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA5` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA6` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA7` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA8` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA9` Generic data column, the meaning is `MIMETYPE` specific
`String`	`DATA_VERSION` The version of this data record.
`String`	`IS_PRIMARY` Whether this is the primary entry of its kind for the raw contact it belongs to.
`String`	`IS_READ_ONLY` The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter.
`String`	`IS_SUPER_PRIMARY` Whether this is the primary entry of its kind for the aggregate contact it belongs to.
`String`	`MIMETYPE` The MIME type of the item represented by this row.
`String`	`PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME` The flattened `ComponentName` of a `PhoneAccountHandle` that is the preferred `PhoneAccountHandle` to call the contact with.
`String`	`PREFERRED_PHONE_ACCOUNT_ID` The ID of a `PhoneAccountHandle` that is the preferred `PhoneAccountHandle` to call the contact with.
`String`	`RAW_CONTACT_ID` A reference to the `RawContacts#_ID` that this data belongs to.
`String`	`RES_PACKAGE` The package name to use when creating `Resources` objects for this data row.
`String`	`SYNC1` Generic column for use by sync adapters.
`String`	`SYNC2` Generic column for use by sync adapters.
`String`	`SYNC3` Generic column for use by sync adapters.
`String`	`SYNC4` Generic column for use by sync adapters.

Constants

CARRIER_PRESENCE

Added in API level 23
Deprecated in API level 31

public static final String CARRIER_PRESENCE

This constant was deprecated in API level 31.
The contacts database will only show presence information on devices where CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL is true, otherwise use RcsUceAdapter.

Carrier presence information.

Type: INTEGER (A bitmask of CARRIER_PRESENCE_* fields)

Constant Value: "carrier_presence"

CARRIER_PRESENCE_VT_CAPABLE

Added in API level 23
Deprecated in API level 31

public static final int CARRIER_PRESENCE_VT_CAPABLE

This constant was deprecated in API level 31.
Same as DataColumns#CARRIER_PRESENCE.

Indicates that the entry is Video Telephony (VT) capable on the current carrier. An allowed bitmask of CARRIER_PRESENCE.

Constant Value: 1 (0x00000001)

DATA1

Added in API level 5

public static final String DATA1

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data1"

DATA10

Added in API level 5

public static final String DATA10

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data10"

DATA11

Added in API level 5

public static final String DATA11

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data11"

DATA12

Added in API level 5

public static final String DATA12

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data12"

DATA13

Added in API level 5

public static final String DATA13

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data13"

DATA14

Added in API level 5

public static final String DATA14

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data14"

DATA15

Added in API level 5

public static final String DATA15

Generic data column, the meaning is MIMETYPE specific. By convention, this field is used to store BLOBs (binary data).

Constant Value: "data15"

DATA2

Added in API level 5

public static final String DATA2

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data2"

DATA3

Added in API level 5

public static final String DATA3

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data3"

DATA4

Added in API level 5

public static final String DATA4

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data4"

DATA5

Added in API level 5

public static final String DATA5

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data5"

DATA6

Added in API level 5

public static final String DATA6

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data6"

DATA7

Added in API level 5

public static final String DATA7

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data7"

DATA8

Added in API level 5

public static final String DATA8

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data8"

DATA9

Added in API level 5

public static final String DATA9

Generic data column, the meaning is MIMETYPE specific

Constant Value: "data9"

DATA_VERSION

Added in API level 5

public static final String DATA_VERSION

The version of this data record. This is a read-only value. The data column is guaranteed to not change without the version going up. This value is monotonically increasing.

Type: INTEGER

Constant Value: "data_version"

IS_PRIMARY

Added in API level 5

public static final String IS_PRIMARY

Whether this is the primary entry of its kind for the raw contact it belongs to.

Type: INTEGER (if set, non-0 means true)

Constant Value: "is_primary"

IS_READ_ONLY

Added in API level 11

public static final String IS_READ_ONLY

The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter. See ContactsContract#CALLER_IS_SYNCADAPTER.

Type: INTEGER

Constant Value: "is_read_only"

IS_SUPER_PRIMARY

Added in API level 5

public static final String IS_SUPER_PRIMARY

Whether this is the primary entry of its kind for the aggregate contact it belongs to. Any data record that is "super primary" must also be "primary".

Type: INTEGER (if set, non-0 means true)

Constant Value: "is_super_primary"

MIMETYPE

Added in API level 5

public static final String MIMETYPE

The MIME type of the item represented by this row.

Constant Value: "mimetype"

PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

Added in API level 28

public static final String PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

The flattened ComponentName of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with.

On a multi-SIM device this field can be used in a CommonDataKinds.Phone row to indicate the PhoneAccountHandle to call the number with, instead of using TelecomManager.getDefaultOutgoingPhoneAccount(String) or asking every time.

TelecomManager.placeCall(Uri, android.os.Bundle) should be called with TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the ComponentName from this field.

See also:

Constant Value: "preferred_phone_account_component_name"

PREFERRED_PHONE_ACCOUNT_ID

Added in API level 28

public static final String PREFERRED_PHONE_ACCOUNT_ID

The ID of a PhoneAccountHandle that is the preferred PhoneAccountHandle to call the contact with. Used by CommonDataKinds.Phone.

TelecomManager.placeCall(Uri, android.os.Bundle) should be called with TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE set to the PhoneAccountHandle using the id from this field.

See also:

Constant Value: "preferred_phone_account_id"

RAW_CONTACT_ID

Added in API level 5

public static final String RAW_CONTACT_ID

A reference to the RawContacts#_ID that this data belongs to.

Constant Value: "raw_contact_id"

RES_PACKAGE

Added in API level 21

public static final String RES_PACKAGE

The package name to use when creating Resources objects for this data row. This value is only designed for use when building user interfaces, and should not be used to infer the owner.

Constant Value: "res_package"

SYNC1

Added in API level 5

public static final String SYNC1

Generic column for use by sync adapters.

Constant Value: "data_sync1"

SYNC2

Added in API level 5

public static final String SYNC2

Generic column for use by sync adapters.

Constant Value: "data_sync2"

SYNC3

Added in API level 5

public static final String SYNC3

Generic column for use by sync adapters.

Constant Value: "data_sync3"

SYNC4

Added in API level 5

public static final String SYNC4

Generic column for use by sync adapters.

Constant Value: "data_sync4"