Introduces new Contacts API for ranking promotion. (b2b651f1) · Commits · e / os / android_frameworks_base

core/java/android/provider/ContactsContract.java

+85 −0

Original line number	Diff line number	Diff line
		@@ -6155,6 +6155,91 @@ public final class ContactsContract {
		public static final String DATA1 = "data1";
		}

		/**
		* <p>
		* API allowing applications to send usage information for each {@link Data} row to the
		* Contacts Provider.
		* </p>
		* <p>
		* With the feedback, Contacts Provider may return more contextually appropriate results for
		* Data listing, typically supplied with
		* {@link ContactsContract.Contacts#CONTENT_FILTER_URI},
		* {@link ContactsContract.CommonDataKinds.Email#CONTENT_FILTER_URI},
		* {@link ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI}, and users can benefit
		* from better ranked (sorted) lists in applications that show auto-complete list.
		* </p>
		* <p>
		* There is no guarantee for how this feedback is used, or even whether it is used at all.
		* The ranking algorithm will make best efforts to use the feedback data, but the exact
		* implementation, the storage data structures as well as the resulting sort order is device
		* and version specific and can change over time.
		* </p>
		* <p>
		* When updating usage information, users of this API need to use
		* {@link ContentResolver#update(Uri, ContentValues, String, String[])} with a Uri constructed
		* from {@link DataUsageFeedback#FEEDBACK_URI}. The Uri must contain one or more data id(s) as
		* its last path. They also need to append a query parameter to the Uri, to specify the type of
		* the communication, which enables the Contacts Provider to differentiate between kinds of
		* interactions using the same contact data field (for example a phone number can be used to
		* make phone calls or send SMS).
		* </p>
		* <p>
		* Selection and selectionArgs are ignored and must be set to null. To get data ids,
		* you may need to call {@link ContentResolver#query(Uri, String[], String, String[], String)}
		* toward {@link Data#CONTENT_URI}.
		* </p>
		* <p>
		* Example:
		* <pre>
		* Uri uri = DataUsageFeedback.UPDATE_URI.buildUpon()
		* .appendPath(TextUtils.join(",", dataIds))
		* .appendQueryParameter(DataUsageFeedback.METHOD, DataUsageFeedback.METHOD_CALL)
		* .build();
		* resolver.update(uri, new ContentValues(), null, null);
		* </pre>
		* </p>
		* @hide
		*/
		public static final class DataUsageFeedback {

		/**
		* The content:// style URI for sending usage feedback.
		* Must be used with {@link ContentResolver#update(Uri, ContentValues, String, String[])}.
		*/
		public static final Uri FEEDBACK_URI =
		Uri.withAppendedPath(Data.CONTENT_URI, "usagefeedback");

		/**
		* <p>
		* Name for query parameter specifying the type of data usage.
		* </p>
		*/
		public static final String USAGE_TYPE = "method";

		/**
		* <p>
		* Type of usage for voice interaction, which includes phone call, voice chat, and
		* video chat.
		* </p>
		*/
		public static final String USAGE_TYPE_CALL = "call";

		/**
		* <p>
		* Type of usage for text interaction involving longer messages, which includes email.
		* </p>
		*/
		public static final String USAGE_TYPE_LONG_TEXT = "long_text";

		/**
		* <p>
		* Type of usage for text interaction involving shorter messages, which includes SMS,
		* text chat with email addresses.
		* </p>
		*/
		public static final String USAGE_TYPE_SHORT_TEXT = "short_text";
		}

		/**
		* Helper methods to display QuickContact dialogs that allow users to pivot on
		* a specific {@link Contacts} entry.