(Data Success) Updated Documentation, remove deprecated fields, added…

… missing message fields (#26)

* Updated docs

* Added missing fields to Message.java

* Updated version to 2.0.1

* Removed old V204 events

* Added extra comment to changeS

* Added Nick's requested changes

CHANGES.MD

@@ -1,10 +1,22 @@
-2.0 (2018-03-28)
+2.0.1 (2018-04-06)
 =================
 
-- Add content level decisions in ApplyDecisionFieldSet.java.
-- Add support for V205 content events
-- Removed support for send message and submit review events.
-- Add support for filtering get decisions by entity type SESSION.
+- Improved documentation in CHANGES.MD and README.md.
+- Added missing fields to Message.java
+- Removed deprecated files.
+
+2.0 (2018-03-30)
+=================
+
+- Adds support for Sift Science API Version 205, including new [`$create_content`](https://siftscience.com/developers/docs/curl/events-api/reserved-events/create-content) and [`$update_content`](https://siftscience.com/developers/docs/curl/events-api/reserved-events/update-content) formats
+- V205 APIs are now called -- **this is an incompatible change**
+- Adds support for content decisions to [Decisions API](https://siftscience.com/developers/docs/curl/decisions-api)
+
+
+INCOMPATIBLE CHANGES INTRODUCED IN API V205:
+- `$create_content` and `$update_content` have significantly changed, and the old format will be rejected
+- `$send_message` and `$submit_review` events are no longer valid
+- V205 improves server-side event data validation. In V204 and earlier, server-side validation accepted some events that did not conform to the published APIs in our [developer documentation](https://siftscience.com/developers/docs/curl/events-api). V205 does not modify existing event APIs other than those mentioned above, but may reject invalid event data that were previously accepted. **Please test your integration on V205 in sandbox before using in production.**
 
 
 1.5 (2018-02-09)

README.md

@@ -1,6 +1,6 @@
 # Sift Science Java API
 
-The official Java bindings for the latest version (v204) of the [Sift Science API](https://siftscience.com/developers/docs/java/apis-overview) .
+The official Java bindings for the latest version (v205) of the [Sift Science API](https://siftscience.com/developers/docs/java/apis-overview) .
 
 ## Requirements
 Java 1.7 or later.
@@ -11,13 +11,13 @@ Java 1.7 or later.
 <dependency>
     <groupId>com.siftscience</groupId>
     <artifactId>sift-java</artifactId>
-    <version>1.5</version>
+    <version>2.0.1</version>
 </dependency>
 ```
 ### Gradle
 ```
 dependencies {
-    compile 'com.siftscience:sift-java:1.5'
+    compile 'com.siftscience:sift-java:2.0.1'
 }
 ```
 ### Other
@@ -241,6 +241,21 @@ ApplyDecisionRequest request = client.buildRequest(
 );
 ```
 
+To apply a decision to a piece of content, create a request with accountId, userId, contentId and ApplyDecisionFieldSet.
+```java
+ApplyDecisionRequest request = client.buildRequest(
+        new ApplyDecisionFieldSet()
+            .setAccountId("your_account_id")
+            .setUserId("a_user_id")
+            .setContentId("a_content_id")
+            .setDecisionId("decision_id")
+            .setSource(DecisionSource.MANUAL_REVIEW)
+            .setAnalyst("[email protected]")
+            .setDescription("description of decision applied")
+);
+```
+
+
 #### Get decisions
 
 [API Docs](https://siftscience.com/developers/docs/java/decisions-api/get-decisions)

build.gradle

@@ -5,7 +5,7 @@ apply plugin: 'signing'
 apply plugin: 'java-library-distribution'
 
 group = 'com.siftscience'
-version = '2.0'
+version = '2.0.1'
 sourceCompatibility = 1.7
 targetCompatibility = 1.7
 

src/main/java/com/siftscience/model/Message.java

@@ -9,7 +9,9 @@ public class Message {
     @Expose @SerializedName("$body") private String body;
     @Expose @SerializedName("$contact_email") private String contactEmail;
     @Expose @SerializedName("$recipient_user_ids") private List<String> recipientUserIds;
+    @Expose @SerializedName("$root_content_id") private String rootContentId;
     @Expose @SerializedName("$images") private List<Image> images;
+    @Expose @SerializedName("$subject") private String subject;
 
     public String getBody() {
         return body;
@@ -46,4 +48,20 @@ public Message setRecipientUserIds(List<String> recipientUserIds) {
         this.recipientUserIds = recipientUserIds;
         return this;
     }
+
+    public String getSubject() { return subject; }
+
+    public Message setSubject(String subject) {
+        this.subject = subject;
+        return this;
+    }
+
+    public String getRootContentId() {
+        return rootContentId;
+    }
+
+    public Message setRootContentId(String rootContentId) {
+        this.rootContentId = rootContentId;
+        return this;
+    }
 }

src/test/java/com/siftscience/ContentEventTest.java

@@ -873,6 +873,8 @@ public void testUpdateMessage() throws Exception {
             "       \"$body\": \"Let's meet at 5pm\",\n" +
             "       \"$contact_email\": \"[email protected]\",\n" +
             "       \"$recipient_user_ids\": [\"fy9h989sjphh71\"],\n" +
+            "       \"$subject\": \"Hello world\",\n" +
+            "       \"$root_content_id\": \"posting-123\",\n" +
             "       \"$images\": [{\n" +
             "           \"$md5_hash\": \"aflshdfbalsubdf3234sfdkjb\",\n" +
             "           \"$link\": \"https://www.domain.com/file.png\",\n" +
@@ -911,6 +913,8 @@ public void testUpdateMessage() throws Exception {
             .setBody("Let's meet at 5pm")
             .setContactEmail("[email protected]")
             .setRecipientUserIds(Collections.singletonList("fy9h989sjphh71"))
+            .setSubject("Hello world")
+            .setRootContentId("posting-123")
             .setImages(images);
 
         // Build and execute the request against the mock server.