Add Support for Dynamic Local Awareness

Summary: as above

Test Plan: documentation code samples

Author: Luca Bruno

src/FacebookAds/Object/AdAccount.php

@@ -344,6 +344,17 @@ public function getMinimumBudgets(
       MinimumBudget::className(), $fields, $params, 'minimum_budgets');
   }
 
+  /**
+   * @param array $fields
+   * @param array $params
+   * @return Cursor
+   */
+  public function getPlacePageSets(
+    array $fields = array(), array $params = array()) {
+    return $this->getManyByConnection(
+      PlacePageSet::className(), $fields, $params);
+  }
+
   /**
    * @param array $fields
    * @param array $params

src/FacebookAds/Object/Fields/AdCreativeFields.php

@@ -37,6 +37,7 @@ class AdCreativeFields extends AbstractEnum {
   const APPLINK_TREATMENT = 'applink_treatment';
   const BODY = 'body';
   const CALL_TO_ACTION_TYPE = 'call_to_action_type';
+  const DYNAMIC_AD_VOICE = 'dynamic_ad_voice';
   const FOLLOW_REDIRECT = 'follow_redirect';
   const ID = 'id';
   const IMAGE_HASH = 'image_hash';
@@ -54,6 +55,7 @@ class AdCreativeFields extends AbstractEnum {
   const OBJECT_STORE_URL = 'object_store_url';
   const OBJECT_TYPE = 'object_type';
   const OBJECT_URL = 'object_url';
+  const PLACE_PAGE_SET_ID = 'place_page_set_id';
   const PREVIEW_URL = 'preview_url';
   const PRODUCT_SET_ID = 'product_set_id';
   const RUN_STATUS = 'run_status';

src/FacebookAds/Object/Fields/ObjectStory/TemplateDataFields.php

@@ -37,4 +37,5 @@ class TemplateDataFields extends AbstractEnum {
   const MESSAGE = 'message';
   const NAME = 'name';
   const MAX_PRODUCT_COUNT = 'max_product_count';
+  const PICTURE = 'picture';
 }

src/FacebookAds/Object/Fields/PlacePageSetFields.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * Copyright (c) 2014-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.
+ *
+ */
+
+namespace FacebookAds\Object\Fields;
+
+use FacebookAds\Enum\AbstractEnum;
+
+/**
+ * @method static PlacePageSetFields getInstance()
+ */
+class PlacePageSetFields extends AbstractEnum {
+
+  const ACCOUNT_ID = 'account_id';
+  const ID = 'id';
+  const NAME = 'name';
+  const PAGES_COUNT = 'pages_count';
+  const PARENT_PAGE = 'parent_page';
+}

src/FacebookAds/Object/PlacePageSet.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * Copyright (c) 2014-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.
+ *
+ */
+
+namespace FacebookAds\Object;
+
+use FacebookAds\Object\Fields\PlacePageSetFields;
+use FacebookAds\Object\Traits\CannotDelete;
+use FacebookAds\Object\Traits\FieldValidation;
+
+class PlacePageSet extends AbstractCrudObject {
+  use FieldValidation;
+  use CannotDelete;
+
+  /**
+   * @return string
+   */
+  protected function getEndpoint() {
+    return 'ad_place_page_sets';
+  }
+
+  /**
+   * @return PlacePageSetFields
+   */
+  public static function getFieldsEnum() {
+    return PlacePageSetFields::getInstance();
+  }
+}

src/FacebookAds/Object/Values/InsightsBreakdowns.php

@@ -39,5 +39,6 @@ class InsightsBreakdowns extends AbstractEnum {
   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';
 }