v.0.9.6

Author: Luca Bruno

.gitignore

@@ -1,2 +1,3 @@
 /vendor
 /composer.lock
+/composer.local.*

src/FacebookAds/Api.php

@@ -36,7 +36,7 @@ class Api {
   /**
    * @var string
    */
-  const VERSION = '0.0.1';
+  const VERSION = '0.9.6';
 
   /**
    * @var string

src/FacebookAds/Object/AbstractArchivableCrudObject.php

@@ -0,0 +1,73 @@
+<?php
+/**
+ * Copyright 2014 Facebook, Inc.
+ *
+ * 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\Api;
+
+abstract class AbstractArchivableCrudObject extends AbstractCrudObject {
+
+  /**
+   * @var string
+   */
+  const STATUS_DELETED = 'DELETED';
+
+  /**
+   * @var string
+   */
+  const STATUS_ARCHIVED = 'ARCHIVED';
+
+  /**
+   * @return string
+   */
+  public abstract function getStatusFieldName();
+
+  /**
+   * Archive this object
+   *
+   * @param array $params
+   * @return void
+   */
+  public function archive(array $params = array()) {
+    $this->getApi()->call(
+      $this->getNodePath(),
+      Api::HTTP_METHOD_POST,
+      array_merge($params, array(
+        $this->getStatusFieldName() => static::STATUS_ARCHIVED)));
+  }
+
+  /**
+   * Delete this object
+   *
+   * @param array $params
+   * @return void
+   */
+  public function delete(array $params = array()) {
+    $this->getApi()->call(
+      $this->getNodePath(),
+      Api::HTTP_METHOD_POST,
+      array_merge($params, array(
+        $this->getStatusFieldName() => static::STATUS_DELETED)));
+  }
+}

src/FacebookAds/Object/AbstractCrudObject.php

@@ -88,7 +88,6 @@ public function setApi(Api $api) {
     $this->api = static::assureApi($api);
   }
 
-
   /**
    * @return string
    */
@@ -304,11 +303,8 @@ public function delete(array $params = array()) {
       $this->getNodePath(),
       Api::HTTP_METHOD_DELETE,
       $params);
-
-    $this->data[static::FIELD_ID] = null;
   }
 
-
   /**
    * Perform object upsert
    *

src/FacebookAds/Object/AbstractObject.php

@@ -90,10 +90,16 @@ protected function exportData() {
         $data[$key] = $value;
       }
     }
-
     return $data;
   }
 
+  /**
+   * @return array
+   */
+  public static function getFields() {
+    return static::$fields;
+  }
+
   /**
    * @return string
    */

src/FacebookAds/Object/AdAccount.php

@@ -177,6 +177,16 @@ public function getAdImages(
     return $this->getManyByConnection(AdImage::className(), $fields, $params);
   }
 
+  /**
+   * @param array $fields
+   * @param array $params
+   * @return Cursor
+   */
+  public function getAdsPixels(
+    array $fields = array(), array $params = array()) {
+    return $this->getManyByConnection(AdsPixel::className(), $fields, $params);
+  }
+
   /**
    * @param array $fields
    * @param array $params

src/FacebookAds/Object/AdCampaign.php

@@ -28,7 +28,7 @@
 use FacebookAds\Object\Fields\AdCampaignFields;
 use FacebookAds\Traits\FieldValidation;
 
-class AdCampaign extends AbstractCrudObject {
+class AdCampaign extends AbstractArchivableCrudObject {
   use FieldValidation;
 
   /**
@@ -60,6 +60,13 @@ protected function getEndpoint() {
     return 'adcampaign_groups';
   }
 
+  /**
+   * @return string
+   */
+  public function getStatusFieldName() {
+    return AdCampaignFields::STATUS;
+  }
+
   /**
    * @param array $fields
    * @param array $params

src/FacebookAds/Object/AdCreative.php

@@ -24,6 +24,7 @@
 
 namespace FacebookAds\Object;
 
+use FacebookAds\Cursor;
 use FacebookAds\Object\Fields\AdCreativeFields;
 use FacebookAds\Traits\FieldValidation;
 
@@ -41,6 +42,7 @@ class AdCreative extends AbstractCrudObject {
     AdCreativeFields::NAME,
     AdCreativeFields::OBJECT_ID,
     AdCreativeFields::OBJECT_STORY_ID,
+    AdCreativeFields::OBJECT_STORY_SPEC,
     AdCreativeFields::BODY,
     AdCreativeFields::IMAGE_HASH,
     AdCreativeFields::IMAGE_FILE,

src/FacebookAds/Object/AdGroup.php

@@ -28,7 +28,7 @@
 use FacebookAds\Object\Fields\AdGroupFields;
 use FacebookAds\Traits\FieldValidation;
 
-class AdGroup extends AbstractCrudObject {
+class AdGroup extends AbstractArchivableCrudObject {
   use FieldValidation;
 
   /**
@@ -95,6 +95,13 @@ protected function getEndpoint() {
     return 'adgroups';
   }
 
+  /**
+   * @return string
+   */
+  public function getStatusFieldName() {
+    return AdGroupFields::ADGROUP_STATUS;
+  }
+
   /**
    * @param array $fields
    * @param array $params

src/FacebookAds/Object/AdSet.php

@@ -28,7 +28,7 @@
 use FacebookAds\Traits\FieldValidation;
 use FacebookAds\Cursor;
 
-class AdSet extends AbstractCrudObject {
+class AdSet extends AbstractArchivableCrudObject {
   use FieldValidation;
 
   /**
@@ -56,6 +56,8 @@ class AdSet extends AbstractCrudObject {
     AdSetFields::DAILY_BUDGET,
     AdSetFields::LIFETIME_BUDGET,
     AdSetFields::BUDGET_REMAINING,
+    AdSetFields::PACING_TYPE,
+    AdSetFields::CAMPAIGN_SCHEDULE,
   );
 
   /**
@@ -65,6 +67,13 @@ protected function getEndpoint() {
     return 'adcampaigns';
   }
 
+  /**
+   * @return string
+   */
+  public function getStatusFieldName() {
+    return AdSetFields::CAMPAIGN_STATUS;
+  }
+
   /**
    * @param array $fields
    * @param array $params