Filter get-users API by last login

cloudinary-core/src/main/java/com/cloudinary/provisioning/Account.java

@@ -305,13 +305,41 @@ public ApiResponse users(Boolean pending, List<String> userIds, String prefix, S
      * @throws Exception If the request fails.
      */
     public ApiResponse users(Boolean pending, List<String> userIds, String prefix, String subAccountId, Map<String, Object> options) throws Exception {
+        return users(pending, userIds, prefix, subAccountId, options, null, null, null);
+    }
+
+    /**
+     * Get a list of the users according to filters.
+     *
+     * @param pending      Optional. Limit results to pending users (true), users that are not pending (false), or all users (null)
+     * @param userIds      Optionals. List of user IDs. Up to 100
+     * @param prefix       Optional. Search by prefix of the user's name or email. Case-insensitive
+     * @param subAccountId Optional. Return only users who have access to the given sub-account
+     * @param options      Generic advanced options map, see online documentation.
+     * @param lastLogin    Optional. Return only users that last logged in in the specified range of dates (true), users that didn’t last logged in in that range (false), or all users (null).
+     * @param from         Optional. Last login start date.
+     * @param to           Optional. Last login end date.
+     * @return the users' details.
+     * @throws Exception If the request fails.
+     */
+    public ApiResponse users(Boolean pending, List<String> userIds, String prefix, String subAccountId, Map<String, Object> options, Boolean lastLogin, Date from, Date to) throws Exception {
         List<String> uri = Arrays.asList(PROVISIONING, ACCOUNTS, accountId, USERS);
-        return callAccountApi(Api.HttpMethod.GET, uri,
-                ObjectUtils.asMap("accountId", accountId,
-                        "pending", pending,
-                        "ids", userIds,
-                        "prefix", prefix,
-                        "sub_account_id", subAccountId), options);
+        Map map = ObjectUtils.asMap("accountId", accountId,
+		        "pending", pending,
+		        "ids", userIds,
+		        "prefix", prefix,
+		        "sub_account_id", subAccountId);
+        if (lastLogin != null){
+            map.put("last_login", lastLogin);
+        }
+        if (from != null){
+            map.put("from", ObjectUtils.toISO8601(from));
+        }
+        if (to != null){
+            map.put("to", ObjectUtils.toISO8601(to));
+        }
+		return callAccountApi(Api.HttpMethod.GET, uri,
+                map, options);
     }
 
     /**

cloudinary-test-common/src/main/java/com/cloudinary/test/AbstractAccountApiTest.java

@@ -233,6 +233,36 @@ public void testGetUsersBySubAccountIds() throws Exception {
         assertEquals(1, ((ArrayList) usersBySubAccount.get("users")).size());
     }
 
+    @Test
+    public void testGetUserByLastLoginTrue() throws Exception {
+        final long timeMillis = System.currentTimeMillis();
+        final String userName = String.format("SDK TEST Get Users By Last Login True %d", timeMillis);
+        final String userEmail = String.format("sdk-test-get-users-by-llt+%d@cloudinary.com", timeMillis);
+
+        createUser(userName,
+                userEmail,
+                Account.Role.BILLING,
+                Collections.<String>emptyList());
+
+        ApiResponse userByLastLogin = account.users(true, null, userName.substring(0, userName.length() - 1), null, null, true, new Date(), new Date());
+        assertEquals(0, ((ArrayList) userByLastLogin.get("users")).size());
+    }
+
+    @Test
+    public void testGetUserByLastLoginFalse() throws Exception {
+        final long timeMillis = System.currentTimeMillis();
+        final String userName = String.format("SDK TEST Get Users By Last Login False %d", timeMillis);
+        final String userEmail = String.format("sdk-test-get-users-by-llf+%d@cloudinary.com", timeMillis);
+
+        createUser(userName,
+                userEmail,
+                Account.Role.BILLING,
+                Collections.<String>emptyList());
+
+        ApiResponse userByLastLogin = account.users(true, null, userName.substring(0, userName.length() - 1), null, null, false, new Date(), new Date());
+        assertEquals(1, ((ArrayList) userByLastLogin.get("users")).size());
+    }
+
     @Test
     public void testGetUsersThrowsWhenSubAccountIdDoesntExist() throws Exception {
         final String subAccountId = randomLetters();