/// <summary>
/// Returns a list of profiles of users whom the current user may know.
/// </summary>
/// <param name="filter">Types of potential friends to return.</param>
/// <param name="count">Number of suggestions to return.</param>
/// <param name="offset">Offset needed to return a specific subset of suggestions.</param>
/// <param name="fields">Profile fields to return.</param>
/// <param name="nameCase">Case for declension of user name and surname.</param>
/// <returns>Returns a <see cref="List{T}"/> of <see cref="User"/> objects.</returns>
public async Task <Response <ItemsList <User> > > GetSuggestions(
FriendSuggestionsTypes filter = FriendSuggestionsTypes.All, int count = 500, int offset = 0,
List <UserProfileFields> fields = null, NameCases nameCase = NameCases.Nominative)
=> await Request <ItemsList <User> >("getSuggestions", new MethodParams
{
{ "filter", filter == FriendSuggestionsTypes.All ? null : Utils.ToEnumString(filter) },
{ "count", count, false, new[] { 0, 500 } },
{ "offset", offset },
{ "fields", fields },
{ "name_case", Utils.ToEnumString(nameCase) }
});
/// <summary>
/// Returns a list of profiles of users whom the current user may know.
/// </summary>
/// <param name="filter">Types of potential friends to return.</param>
/// <param name="count">Number of suggestions to return.</param>
/// <param name="offset">Offset needed to return a specific subset of suggestions.</param>
/// <param name="fields">Profile fields to return.</param>
/// <param name="nameCase">Case for declension of user name and surname.</param>
/// <returns>Returns a <see cref="List{T}"/> of <see cref="User"/> objects.</returns>
public async Task<Response<ItemsList<User>>> GetSuggestions(
FriendSuggestionsTypes filter = FriendSuggestionsTypes.All, int count = 500, int offset = 0,
List<UserProfileFields> fields = null, NameCases nameCase = NameCases.Nominative)
=> await Request<ItemsList<User>>("getSuggestions", new MethodParams
{
{"filter", filter == FriendSuggestionsTypes.All ? null : Utils.ToEnumString(filter)},
{"count", count, false, new[] {0, 500}},
{"offset", offset},
{"fields", fields},
{"name_case", Utils.ToEnumString(nameCase)}
});
