v2.6 Breaking Changes

Summary:
- Deprecated the `connectionobjects` API which retrieved all object types and replace it with other APIs that return specific object types
- Deprecated `max_product_count` since Facebook now automatically optimizes the number of products to show for Dynamic Product ads. In order to opt-out of Carousel format, specify `force_single_link=true`.
- Deprecated `product_ad_behavior` field at the Ad Set level
- The `fields` parameter no longer accepts breakdowns, such as age or gender. Now you should specified this in 'breakdowns' parameter in query. This includes:- `age`, `country`, `gender`, `frequency_value`,`hourly_stats_aggregated_by_advertiser_time_zone`, `hourly_stats_aggregated_by_audience_time_zone`, `impression_device`, `place_page_id`, `placement`, `product_id`, and `region`This appplies to /insights for all object levels.

Test Plan:
Run all tests;

Alternatively if you want to check specific breaking changes, choose the one's related to it, e.g.

  for f in docs/*INSIGHTS*; do ./bin/docsmith.php test $f; done
  for f in docs/*DPA*; do ./bin/docsmith.php test $f; done

Author: duliomatos

README.md

@@ -1,5 +1,9 @@
 # Facebook Ads API SDK for PHP
 
+**IMPORTANT**: This is the legacy SDK. This will be deprecated when API v2.7 is released
+Please start migrating to the autogenerated SDK which you can find [here](https://github.com/facebook/facebook-php-ads-sdk).
+
+
 [![Packagist](https://img.shields.io/packagist/v/facebook/php-ads-sdk.svg?style=flat-square)](https://packagist.org/packages/facebook/php-ads-sdk)
 [![License](https://img.shields.io/badge/license-Facebook%20Platform-blue.svg?style=flat-square)](https://github.com/facebook/facebook-php-ads-sdk/blob/master/LICENSE)
 [![Travis](https://img.shields.io/travis/facebook/facebook-php-ads-sdk.svg?style=flat-square)](https://travis-ci.org/facebook/facebook-php-ads-sdk)

examples/connectionobjects.php

@@ -35,7 +35,7 @@ class Api {
   /**
    * @var string
    */
-  const VERSION = '2.5.1';
+  const VERSION = '2.6.0';
 
   /**
    * @var Api

src/FacebookAds/Api.php

@@ -156,17 +156,6 @@ public function getBroadCategoryTargeting(
     );
   }
 
-  /**
-   * @param array $fields
-   * @param array $params
-   * @return Cursor
-   */
-  public function getConnectionObjects(
-    array $fields = array(), array $params = array()) {
-    return $this->getManyByConnection(
-      ConnectionObject::className(), $fields, $params, 'connectionobjects');
-  }
-
   /**
    * @param array $fields
    * @param array $params

src/FacebookAds/Object/AdAccount.php

@@ -40,7 +40,6 @@ class InsightsFields extends AbstractEnum {
   const AD_NAME = 'ad_name';
   const ADSET_ID = 'adset_id';
   const ADSET_NAME = 'adset_name';
-  const AGE = 'age';
   const APP_STORE_CLICKS = 'app_store_clicks';
   const BUYING_TYPE = 'buying_type';
   const CALL_TO_ACTION_CLICKS = 'call_to_action_clicks';
@@ -54,7 +53,6 @@ class InsightsFields extends AbstractEnum {
   const COST_PER_TOTAL_ACTION = 'cost_per_total_action';
   const COST_PER_UNIQUE_CLICK = 'cost_per_unique_click';
   const COST_PER_UNIQUE_ACTION_TYPE = 'cost_per_unique_action_type';
-  const COUNTRY = 'country';
   const CPM = 'cpm';
   const CPP = 'cpp';
   const CTR = 'ctr';
@@ -72,23 +70,13 @@ class InsightsFields extends AbstractEnum {
   const ESTIMATED_AD_RECALL_RATE_UPPPER_BOUND
       = 'estimated_ad_recall_rate_upper_bound';
   const FREQUENCY = 'frequency';
-  const FREQUENCY_VALUE = 'frequency_value';
-  const GENDER = 'gender';
-  const HOURLY_STATS_AGGREGATED_BY_ADVERTISER_TIME_ZONE
-      = 'hourly_stats_aggregated_by_advertiser_time_zone';
-  const HOURLY_STATS_AGGREGATED_BY_AUDIENCE_TIME_ZONE
-      = 'hourly_stats_aggregated_by_audience_time_zone';
   const IMPRESSIONS = 'impressions';
-  const IMPRESSION_DEVICE = 'impression_device';
   const INLINE_LINK_CLICKS = 'inline_link_clicks';
   const INLINE_POST_ENGAGEMENT = 'inline_post_engagement';
   const NEWSFEED_AVG_POSITION = 'newsfeed_avg_position';
   const NEWSFEED_CLICKS = 'newsfeed_clicks';
   const NEWSFEED_IMPRESSIONS = 'newsfeed_impresions';
-  const PLACEMENT = 'placement';
-  const PRODUCT_ID = 'product_id';
   const REACH = 'reach';
-  const REGION = 'region';
   const RELEVANCE_SCORE = 'relevance_score';
   const SOCIAL_CLICKS = 'social_clicks';
   const SOCIAL_IMPRESSIONS = 'social_impressions';

src/FacebookAds/Object/ConnectionObject.php

@@ -33,9 +33,9 @@ class TemplateDataFields extends AbstractEnum {
 
   const CALL_TO_ACTION = 'call_to_action';
   const DESCRIPTION = 'description';
+  const FORCE_SINGLE_LINK = 'force_single_link';
   const LINK = 'link';
   const MESSAGE = 'message';
   const NAME = 'name';
-  const MAX_PRODUCT_COUNT = 'max_product_count';
   const PICTURE = 'picture';
 }

src/FacebookAds/Object/Fields/ConnectionObjectFields.php

@@ -33,12 +33,15 @@ class InsightsBreakdowns extends AbstractEnum {
 
   const AGE = 'age';
   const COUNTRY = 'country';
+  const FREQUENCY_VALUE = 'frequency_value';
   const GENDER = 'gender';
   const HOURLY_STATS_AGGREGATED_BY_ADVERTISER_TIME_ZONE =
     'hourly_stats_aggregated_by_advertiser_time_zone';
   const HOURLY_STATS_AGGREGATED_BY_AUDIENCE_TIME_ZONE =
     'hourly_stats_aggregated_by_audience_time_zone';
   const IMPRESSION_DEVICE = 'impression_device';
-  const PLACE_PAGE_ID = 'place_page_id';
   const PLACEMENT = 'placement';
+  const PLACE_PAGE_ID = 'place_page_id';
+  const PRODUCT_ID = 'product_id';
+  const REGION = 'region';
 }