# ContactsContract.Contacts.AggregationSuggestions.Builder

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Ctors](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#inhmethods)  

# ContactsContract.Contacts.AggregationSuggestions.Builder

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder "View this page in Kotlin")\|Java

`
public
static
final

class
ContactsContract.Contacts.AggregationSuggestions.Builder
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|---------------------------------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.provider.ContactsContract.Contacts.AggregationSuggestions.Builder |

<br />

*** ** * ** ***

A convenience builder for aggregation suggestion content URIs.

## Summary

|                                                              ### Public constructors                                                              ||
|------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#Builder())`() ` |

|                                                                                                                                                                                                                                              ### Public methods                                                                                                                                                                                                                                               ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | ` `[addNameParameter](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#addNameParameter(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` name) ` Add a name to be used when searching for aggregation suggestions. |
| ` `[Uri](https://developer.android.com/reference/android/net/Uri)                                                                                                                | ` `[build](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#build())`() ` Combine all of the options that have been set and return a new[Uri](https://developer.android.com/reference/android/net/Uri)object for fetching aggregation suggestions.         |
| ` `[ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | ` `[setContactId](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#setContactId(long))`(long contactId) ` Optional existing contact ID.                                                                                                                    |
| ` `[ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | ` `[setLimit](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#setLimit(int))`(int limit) ` Sets the Maximum number of suggested aggregations that should be returned.                                                                                     |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public constructors

### Builder

```
public Builder ()
```

<br />

<br />

## Public methods

### addNameParameter

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public ContactsContract.Contacts.AggregationSuggestions.Builder addNameParameter (String name)
```

Add a name to be used when searching for aggregation suggestions.

<br />

|                            Parameters                             ||
|--------|-----------------------------------------------------------|
| `name` | `String`: name to find aggregation suggestions for <br /> |

|                                                                                                                           Returns                                                                                                                           ||
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| [ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | This Builder object to allow for chaining of calls to builder methods <br /> |

### build

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public Uri build ()
```

Combine all of the options that have been set and return a new[Uri](https://developer.android.com/reference/android/net/Uri)object for fetching aggregation suggestions.

<br />

|                                Returns                                 ||
|----------------------------------------------------------------|--------|
| [Uri](https://developer.android.com/reference/android/net/Uri) | <br /> |

### setContactId

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public ContactsContract.Contacts.AggregationSuggestions.Builder setContactId (long contactId)
```

Optional existing contact ID. If it is not provided, the search will be based exclusively on the values supplied with[addNameParameter(String)](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder#addNameParameter(java.lang.String)).

<br />

|                               Parameters                                ||
|-------------|------------------------------------------------------------|
| `contactId` | `long`: contact to find aggregation suggestions for <br /> |

|                                                                                                                           Returns                                                                                                                           ||
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| [ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | This Builder object to allow for chaining of calls to builder methods <br /> |

### setLimit

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public ContactsContract.Contacts.AggregationSuggestions.Builder setLimit (int limit)
```

Sets the Maximum number of suggested aggregations that should be returned.

<br />

|                             Parameters                              ||
|---------|------------------------------------------------------------|
| `limit` | `int`: The maximum number of suggested aggregations <br /> |

|                                                                                                                           Returns                                                                                                                           ||
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| [ContactsContract.Contacts.AggregationSuggestions.Builder](https://developer.android.com/reference/android/provider/ContactsContract.Contacts.AggregationSuggestions.Builder) | This Builder object to allow for chaining of calls to builder methods <br /> |