FanJups · FanJups · Dec 23, 2019 · May 20, 2019 · May 29, 2019 · Jun 14, 2019
diff --git a/.travis.yml b/.travis.yml
@@ -0,0 +1,11 @@
+language: java
+jdk:
+  - oraclejdk8
+
+dist: trusty
+
+branches:
+  only:
+  - master
+
+install: mvn package
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,33 @@ All notable changes to this project will be documented in this file.
 
 
 ## Unreleased
+    - Server-side API added search_string to CustomData.
+
+## v5.0.3
+
+  - Added function `getHeader()` in APIException class which provides header information
+  - Made `omit_response_on_success` configurable for addToBatch method in APIRequest
+## v5.0.1
+
+### Added
+  - Added `CrashRepoter`, more context available [here](https://developers.facebook.com/docs/business-sdk/guides/crash-reports)
+
+## v5.0.0
+### Changed
+- Graph API call upgrade to [v5.0](https://developers.facebook.com/docs/graph-api/changelog/version5.0)
+
+## v4.0.8
+
+ - Added strongly typed Server-Side API with normalization for Web (https://developers.facebook.com/docs/marketing-api/facebook-pixel/server-side-api/using-the-api)
+
+## v4.0.6
+
+### Fixed
+ - Add back `source` param in `APIRequestCreateAdVideo`.
+
+## v4.0.0
+### Changed
+- Graph API call upgrade to [v4.0](https://developers.facebook.com/docs/graph-api/changelog/version4.0)
 
 ## v3.3.1
 ### Changed

diff --git a/examples/AdAccountAdSetsPost2CreateMAIA.java b/examples/AdAccountAdSetsPost2CreateMAIA.java
@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
+ *
+ * You are hereby granted a non-exclusive, worldwide, royalty-free license to
+ * use, copy, modify, and distribute this software in source code or binary
+ * form for use in connection with the web services and APIs provided by
+ * Facebook.
+ *
+ * As with any software that integrates with the Facebook platform, your use
+ * of this software is subject to the Facebook Developer Principles and
+ * Policies [http://developers.facebook.com/policy/]. This copyright notice
+ * shall be included in all copies or substantial portions of the software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+ import com.facebook.ads.sdk.*;
+import java.io.File;
+import java.util.Arrays;
+
+public class AdAccountAdSetsPost2CreateMAIA {
+  public static void main (String args[]) throws APIException {
+
+    String access_token = "<ACCESS_TOKEN>";
+    String app_secret = "<APP_SECRET>";
+    String app_id = "<APP_ID>";
+    String id = "<AD_ACCOUNT_ID>";
+    APIContext context = new APIContext(access_token).enableDebug(true);
+
+    new AdAccount(id, context).createAdSet()
+      .setName("Mobile App Installs Ad Set")
+      .setDailyBudget(1000L)
+      .setBidAmount(2L)
+      .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
+      .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_APP_INSTALLS)
+      .setCampaignId("<adCampaignAppInstallsID>")
+      .setPromotedObject("{\"application_id\":\"<appID>\",\"object_store_url\":\"<appLink>\"}")
+      .setTargeting(
+          new Targeting()
+            .setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
+            .setFieldGeoLocations(
+              new TargetingGeoLocation()
+                .setFieldCountries(Arrays.asList("US"))
+            )
+            .setFieldPublisherPlatforms(Arrays.asList("facebook", "audience_network"))
+            .setFieldUserOs(Arrays.asList("IOS"))
+        )
+      .setStatus(AdSet.EnumStatus.VALUE_PAUSED)
+      .execute();
+
+  }
+}
diff --git a/examples/AdAccountAdSetsPostAdSetCreateCpa.java b/examples/AdAccountAdSetsPostAdSetCreateCpa.java
@@ -38,14 +38,15 @@ public static void main (String args[]) throws APIException {
       .setName("A CPA Ad Set")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setDailyBudget(5000L)
-      .setStartTime("2019-05-06T08:46:40-0700")
-      .setEndTime("2019-05-13T08:46:40-0700")
+      .setStartTime("2019-12-12T23:42:39-0800")
+      .setEndTime("2019-12-19T23:42:39-0800")
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
       .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
       .setBidAmount(1000L)
       .setPromotedObject("{\"page_id\":\"<pageID>\"}")
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostAdSetCreateCpaAppEvents.java b/examples/AdAccountAdSetsPostAdSetCreateCpaAppEvents.java
@@ -38,15 +38,16 @@ public static void main (String args[]) throws APIException {
       .setName("A CPA Ad Set optimized for App Events")
       .setCampaignId("<adCampaignAppInstallsID>")
       .setDailyBudget(300L)
-      .setStartTime("2019-05-06T08:48:58-0700")
-      .setEndTime("2019-05-13T08:48:58-0700")
+      .setStartTime("2019-12-12T23:43:36-0800")
+      .setEndTime("2019-12-19T23:43:36-0800")
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
       .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_OFFSITE_CONVERSIONS)
       .setBidAmount(100L)
       .setStatus(AdSet.EnumStatus.VALUE_PAUSED)
       .setPromotedObject("{\"application_id\":\"<appID>\",\"object_store_url\":\"<appLink>\",\"custom_event_type\":\"PURCHASE\"}")
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostBehaviorTargeting.java b/examples/AdAccountAdSetsPostBehaviorTargeting.java
@@ -52,6 +52,7 @@ public static void main (String args[]) throws APIException {
                 .setFieldId(6004386044572L)
                 .setFieldName("Android Owners (All)")
             ))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostBidMultiplier.java b/examples/AdAccountAdSetsPostBidMultiplier.java
@@ -45,6 +45,7 @@ public static void main (String args[]) throws APIException {
       .setPromotedObject("{\"product_set_id\":\"<productSetID>\",\"custom_event_type\":\"ADD_TO_CART\"}")
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostCreateAdSet.java b/examples/AdAccountAdSetsPostCreateAdSet.java
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
     new AdAccount(id, context).createAdSet()
       .setName("My First AdSet")
       .setLifetimeBudget(20000L)
-      .setStartTime("2019-05-06T08:44:23-0700")
-      .setEndTime("2019-05-13T08:44:23-0700")
+      .setStartTime("2019-12-12T23:41:41-0800")
+      .setEndTime("2019-12-19T23:41:41-0800")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setBidAmount(500L)
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
@@ -52,6 +52,7 @@ public static void main (String args[]) throws APIException {
                 .setFieldId(6002714895372L)
                 .setFieldName("All travelers")
             ))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGenders(Arrays.asList(1L))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
@@ -67,11 +68,6 @@ public static void main (String args[]) throws APIException {
                     .setFieldKey("4081")
                 ))
             )
-            .setFieldHomeOwnership(Arrays.asList(
-              new IDName()
-                .setFieldId(6006371327132L)
-                .setFieldName("Renters")
-            ))
             .setFieldInterests(Arrays.asList(
               new IDName()
                 .setFieldId("<adsInterestID>")

diff --git a/examples/AdAccountAdSetsPostCreateAudienceNetwork.java b/examples/AdAccountAdSetsPostCreateAudienceNetwork.java
@@ -44,6 +44,7 @@ public static void main (String args[]) throws APIException {
       .setTargeting(
           new Targeting()
             .setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostDailyBudget20.java b/examples/AdAccountAdSetsPostDailyBudget20.java
@@ -37,14 +37,15 @@ public static void main (String args[]) throws APIException {
     new AdAccount(id, context).createAdSet()
       .setName("My First Adset")
       .setDailyBudget(2000L)
-      .setStartTime("2019-04-29T08:47:49-0700")
-      .setEndTime("2019-05-06T08:47:49-0700")
+      .setStartTime("2019-12-05T23:43:07-0800")
+      .setEndTime("2019-12-12T23:43:07-0800")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setBidAmount(100L)
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)
       .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_LINK_CLICKS)
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostDemographicTargeting.java b/examples/AdAccountAdSetsPostDemographicTargeting.java
@@ -0,0 +1,87 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
+ *
+ * You are hereby granted a non-exclusive, worldwide, royalty-free license to
+ * use, copy, modify, and distribute this software in source code or binary
+ * form for use in connection with the web services and APIs provided by
+ * Facebook.
+ *
+ * As with any software that integrates with the Facebook platform, your use
+ * of this software is subject to the Facebook Developer Principles and
+ * Policies [http://developers.facebook.com/policy/]. This copyright notice
+ * shall be included in all copies or substantial portions of the software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+ import com.facebook.ads.sdk.*;
+import java.io.File;
+import java.util.Arrays;
+
+public class AdAccountAdSetsPostDemographicTargeting {
+  public static void main (String args[]) throws APIException {
+
+    String access_token = "<ACCESS_TOKEN>";
+    String app_secret = "<APP_SECRET>";
+    String app_id = "<APP_ID>";
+    String id = "<AD_ACCOUNT_ID>";
+    APIContext context = new APIContext(access_token).enableDebug(true);
+
+    new AdAccount(id, context).createAdSet()
+      .setName("My First AdSet")
+      .setDailyBudget(10000L)
+      .setBidAmount(300L)
+      .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
+      .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
+      .setCampaignId("<adCampaignLinkClicksID>")
+      .setPromotedObject("{\"page_id\":\"<pageID>\"}")
+      .setTargeting(
+          new Targeting()
+            .setFieldAgeMax(24L)
+            .setFieldAgeMin(20L)
+            .setFieldBehaviors(Arrays.asList(
+              new IDName()
+                .setFieldId(6002714895372L)
+                .setFieldName("All travelers")
+            ))
+            .setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
+            .setFieldGenders(Arrays.asList(1L))
+            .setFieldGeoLocations(
+              new TargetingGeoLocation()
+                .setFieldCities(Arrays.asList(
+                  new TargetingGeoLocationCity()
+                    .setFieldDistanceUnit("mile")
+                    .setFieldKey(777934L)
+                    .setFieldRadius(10L)
+                ))
+                .setFieldCountries(Arrays.asList("US"))
+                .setFieldRegions(Arrays.asList(
+                  new TargetingGeoLocationRegion()
+                    .setFieldKey("4081")
+                ))
+            )
+            .setFieldInterests(Arrays.asList(
+              new IDName()
+                .setFieldId("<adsInterestID>")
+                .setFieldName("<adsInterestName>")
+            ))
+            .setFieldLifeEvents(Arrays.asList(
+              new IDName()
+                .setFieldId(6002714398172L)
+                .setFieldName("Newlywed (1 year)")
+            ))
+            .setFieldPublisherPlatforms(Arrays.asList("facebook", "audience_network"))
+        )
+      .setStatus(AdSet.EnumStatus.VALUE_PAUSED)
+      .execute();
+
+  }
+}
diff --git a/examples/AdAccountAdSetsPostInterestTargeting.java b/examples/AdAccountAdSetsPostInterestTargeting.java
@@ -47,6 +47,7 @@ public static void main (String args[]) throws APIException {
             .setFieldAgeMax(24L)
             .setFieldAgeMin(20L)
             .setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_MOBILE))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldFlexibleSpec(Arrays.asList(
               new FlexibleTargeting()
                 .setFieldInterests(Arrays.asList(

diff --git a/examples/AdAccountAdSetsPostLifetimeBudget200Duration10Days.java b/examples/AdAccountAdSetsPostLifetimeBudget200Duration10Days.java
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
     new AdAccount(id, context).createAdSet()
       .setName("My First Adset")
       .setLifetimeBudget(20000L)
-      .setStartTime("2019-04-29T08:48:12-0700")
-      .setEndTime("2019-05-09T08:48:12-0700")
+      .setStartTime("2019-12-05T23:43:17-0800")
+      .setEndTime("2019-12-15T23:43:17-0800")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setBidAmount(100L)
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)

diff --git a/examples/AdAccountAdSetsPostOfferClaim.java b/examples/AdAccountAdSetsPostOfferClaim.java
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
     new AdAccount(id, context).createAdSet()
       .setName("My Offer Claim AdSet")
       .setLifetimeBudget(56000L)
-      .setStartTime("2019-04-29T08:47:26-0700")
-      .setEndTime("2019-05-06T08:47:26-0700")
+      .setStartTime("2019-12-05T23:42:58-0800")
+      .setEndTime("2019-12-12T23:42:58-0800")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_LINK_CLICKS)
       .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_LINK_CLICKS)
@@ -48,6 +48,7 @@ public static void main (String args[]) throws APIException {
           new Targeting()
             .setFieldAgeMax(55L)
             .setFieldAgeMin(25L)
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGenders(Arrays.asList(1L))
             .setFieldGeoLocations(
               new TargetingGeoLocation()

diff --git a/examples/AdAccountAdSetsPostOptimizePostEngagement.java b/examples/AdAccountAdSetsPostOptimizePostEngagement.java
@@ -37,8 +37,8 @@ public static void main (String args[]) throws APIException {
     new AdAccount(id, context).createAdSet()
       .setName("My First Adset")
       .setLifetimeBudget(20000L)
-      .setStartTime("2019-04-29T08:48:35-0700")
-      .setEndTime("2019-05-09T08:48:35-0700")
+      .setStartTime("2019-12-05T23:43:27-0800")
+      .setEndTime("2019-12-15T23:43:27-0800")
       .setCampaignId("<adCampaignLinkClicksID>")
       .setBidAmount(500L)
       .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
@@ -53,6 +53,7 @@ public static void main (String args[]) throws APIException {
                 .setFieldName("All travelers")
             ))
             .setFieldDevicePlatforms(Arrays.asList(Targeting.EnumDevicePlatforms.VALUE_DESKTOP))
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGenders(Arrays.asList(1L))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
@@ -68,11 +69,6 @@ public static void main (String args[]) throws APIException {
                     .setFieldKey("4081")
                 ))
             )
-            .setFieldHomeOwnership(Arrays.asList(
-              new IDName()
-                .setFieldId(6006371327132L)
-                .setFieldName("Renters")
-            ))
             .setFieldLifeEvents(Arrays.asList(
               new IDName()
                 .setFieldId(6002714398172L)

diff --git a/examples/AdAccountAdSetsPostPageLikes.java b/examples/AdAccountAdSetsPostPageLikes.java
@@ -43,6 +43,7 @@ public static void main (String args[]) throws APIException {
       .setCampaignId("<adCampaignLinkClicksID>")
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostPlacementTargeting.java b/examples/AdAccountAdSetsPostPlacementTargeting.java
@@ -43,6 +43,7 @@ public static void main (String args[]) throws APIException {
       .setCampaignId("<adCampaignLinkClicksID>")
       .setTargeting(
           new Targeting()
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))

diff --git a/examples/AdAccountAdSetsPostReach.java b/examples/AdAccountAdSetsPostReach.java
@@ -50,6 +50,7 @@ public static void main (String args[]) throws APIException {
                     .setFieldKey("3847")
                 ))
             )
+            .setFieldFacebookPositions(Arrays.asList("feed"))
             .setFieldGeoLocations(
               new TargetingGeoLocation()
                 .setFieldCountries(Arrays.asList("US"))