Auto-generated php SDK code update

Summary: ignore-conflict-markers Reviewed By: liliarizona Differential Revision: D69566812 fbshipit-source-id: a6043e856ed8c5725e79b9361100027d9bcfae17
facebook · Feb 13, 2025 · c83b450 · c83b450
1 parent 46ffd2c
commit c83b450
Show file tree

Hide file tree

Showing 98 changed files with 889 additions and 876 deletions.
diff --git a/src/FacebookAds/ApiConfig.php b/src/FacebookAds/ApiConfig.php
@@ -9,7 +9,7 @@
 
 namespace FacebookAds;
 class ApiConfig {
-  const APIVersion = '21.0';
-  const SDKVersion = '21.0.3';
+  const APIVersion = '22.0';
+  const SDKVersion = '22.0.0';
   const TYPE_CHECKER_STRICT_MODE = false;
 }
diff --git a/src/FacebookAds/Object/AdAccount.php b/src/FacebookAds/Object/AdAccount.php
@@ -75,6 +75,7 @@
 use FacebookAds\Object\Values\AdVideoSwapModeValues;
 use FacebookAds\Object\Values\AdVideoUnpublishedContentTypeValues;
 use FacebookAds\Object\Values\AdVideoUploadPhaseValues;
+use FacebookAds\Object\Values\AdVideoVideoStateValues;
 use FacebookAds\Object\Values\AdsInsightsActionAttributionWindowsValues;
 use FacebookAds\Object\Values\AdsInsightsActionBreakdownsValues;
 use FacebookAds\Object\Values\AdsInsightsActionReportTimeValues;
@@ -433,7 +434,6 @@ public function createAdCreative(array $fields = array(), array $params = array(
       'image_file' => 'string',
       'image_hash' => 'string',
       'image_url' => 'string',
-      'instagram_actor_id' => 'string',
       'instagram_branded_content' => 'map',
       'instagram_permalink_url' => 'string',
       'instagram_user_id' => 'string',
@@ -455,6 +455,7 @@ public function createAdCreative(array $fields = array(), array $params = array(
       'portrait_customizations' => 'map',
       'product_set_id' => 'string',
       'recommender_settings' => 'map',
+      'regional_regulation_disclaimer_spec' => 'map',
       'source_instagram_media_id' => 'string',
       'template_url' => 'string',
       'template_url_spec' => 'string',
@@ -1011,6 +1012,7 @@ public function createAdSet(array $fields = array(), array $params = array(), $p
       'frequency_control_specs' => 'list<Object>',
       'full_funnel_exploration_mode' => 'full_funnel_exploration_mode_enum',
       'is_dynamic_creative' => 'bool',
+      'is_sac_cfca_terms_certified' => 'bool',
       'lifetime_budget' => 'unsigned int',
       'lifetime_imps' => 'unsigned int',
       'lifetime_min_spend_target' => 'unsigned int',
@@ -3002,6 +3004,33 @@ public function createSubscribedApp(array $fields = array(), array $params = arr
     return $pending ? $request : $request->execute();
   }
 
+  public function getSuggestedProductTags(array $fields = array(), array $params = array(), $pending = false) {
+    $this->assureId();
+
+    $param_types = array(
+      'image_hash' => 'string',
+      'instagram_actor_id' => 'string',
+      'is_shops_ad' => 'bool',
+      'page_id' => 'string',
+    );
+    $enums = array(
+    );
+
+    $request = new ApiRequest(
+      $this->api,
+      $this->data['id'],
+      RequestInterface::METHOD_GET,
+      '/suggested_product_tags',
+      new AdAccountSuggestedTag(),
+      'EDGE',
+      AdAccountSuggestedTag::getFieldsEnum()->getValues(),
+      new TypeChecker($param_types, $enums)
+    );
+    $request->addParams($params);
+    $request->addFields($fields);
+    return $pending ? $request : $request->execute();
+  }
+
   public function getTargetingBrowse(array $fields = array(), array $params = array(), $pending = false) {
     $this->assureId();
 
@@ -3342,6 +3371,37 @@ public function getVideoAds(array $fields = array(), array $params = array(), $p
     return $pending ? $request : $request->execute();
   }
 
+  public function createVideoAd(array $fields = array(), array $params = array(), $pending = false) {
+    $this->assureId();
+
+    $param_types = array(
+      'description' => 'string',
+      'privacy' => 'string',
+      'title' => 'string',
+      'upload_phase' => 'upload_phase_enum',
+      'video_id' => 'string',
+      'video_state' => 'video_state_enum',
+    );
+    $enums = array(
+      'upload_phase_enum' => AdVideoUploadPhaseValues::getInstance()->getValues(),
+      'video_state_enum' => AdVideoVideoStateValues::getInstance()->getValues(),
+    );
+
+    $request = new ApiRequest(
+      $this->api,
+      $this->data['id'],
+      RequestInterface::METHOD_POST,
+      '/video_ads',
+      new AdVideo(),
+      'EDGE',
+      AdVideo::getFieldsEnum()->getValues(),
+      new TypeChecker($param_types, $enums)
+    );
+    $request->addParams($params);
+    $request->addFields($fields);
+    return $pending ? $request : $request->execute();
+  }
+
   public function getSelf(array $fields = array(), array $params = array(), $pending = false) {
     $this->assureId();
 

diff --git a/src/FacebookAds/Object/AdPromotedObject.php b/src/FacebookAds/Object/AdPromotedObject.php
@@ -15,6 +15,7 @@
 use FacebookAds\TypeChecker;
 use FacebookAds\Object\Fields\AdPromotedObjectFields;
 use FacebookAds\Object\Values\AdPromotedObjectCustomEventTypeValues;
+use FacebookAds\Object\Values\AdPromotedObjectLeadAdsCustomEventTypeValues;
 
 /**
  * This class is auto-generated.
@@ -37,6 +38,7 @@ public static function getFieldsEnum() {
   protected static function getReferencedEnums() {
     $ref_enums = array();
     $ref_enums['CustomEventType'] = AdPromotedObjectCustomEventTypeValues::getInstance()->getValues();
+    $ref_enums['LeadAdsCustomEventType'] = AdPromotedObjectLeadAdsCustomEventTypeValues::getInstance()->getValues();
     return $ref_enums;
   }
 

diff --git a/src/FacebookAds/Object/AdSet.php b/src/FacebookAds/Object/AdSet.php
@@ -676,6 +676,7 @@ public function updateSelf(array $fields = array(), array $params = array(), $pe
       'execution_options' => 'list<execution_options_enum>',
       'existing_customer_budget_percentage' => 'unsigned int',
       'full_funnel_exploration_mode' => 'full_funnel_exploration_mode_enum',
+      'is_sac_cfca_terms_certified' => 'bool',
       'lifetime_budget' => 'unsigned int',
       'lifetime_imps' => 'unsigned int',
       'lifetime_min_spend_target' => 'unsigned int',

diff --git a/src/FacebookAds/Object/AdVideo.php b/src/FacebookAds/Object/AdVideo.php
@@ -68,14 +68,37 @@ protected static function getReferencedEnums() {
     $ref_enums['SwapMode'] = AdVideoSwapModeValues::getInstance()->getValues();
     $ref_enums['UnpublishedContentType'] = AdVideoUnpublishedContentTypeValues::getInstance()->getValues();
     $ref_enums['UploadPhase'] = AdVideoUploadPhaseValues::getInstance()->getValues();
+    $ref_enums['VideoState'] = AdVideoVideoStateValues::getInstance()->getValues();
     $ref_enums['ValidationAdPlacements'] = AdVideoValidationAdPlacementsValues::getInstance()->getValues();
     $ref_enums['Type'] = AdVideoTypeValues::getInstance()->getValues();
-    $ref_enums['VideoState'] = AdVideoVideoStateValues::getInstance()->getValues();
     $ref_enums['BackdatedTimeGranularity'] = AdVideoBackdatedTimeGranularityValues::getInstance()->getValues();
     return $ref_enums;
   }
 
 
+  public function getBoostAdsList(array $fields = array(), array $params = array(), $pending = false) {
+    $this->assureId();
+
+    $param_types = array(
+    );
+    $enums = array(
+    );
+
+    $request = new ApiRequest(
+      $this->api,
+      $this->data['id'],
+      RequestInterface::METHOD_GET,
+      '/boost_ads_list',
+      new AbstractCrudObject(),
+      'EDGE',
+      array(),
+      new TypeChecker($param_types, $enums)
+    );
+    $request->addParams($params);
+    $request->addFields($fields);
+    return $pending ? $request : $request->execute();
+  }
+
   public function getCaptions(array $fields = array(), array $params = array(), $pending = false) {
     $this->assureId();
 
@@ -592,7 +615,7 @@ public function updateSelf(array $fields = array(), array $params = array(), $pe
       'call_to_action' => 'Object',
       'content_category' => 'content_category_enum',
       'content_tags' => 'list<string>',
-      'custom_labels' => 'string',
+      'custom_labels' => 'list<string>',
       'description' => 'string',
       'direct_share_status' => 'unsigned int',
       'embeddable' => 'bool',

diff --git a/src/FacebookAds/Object/MerchantReport.php → src/FacebookAds/Object/AdsEligibility.php b/src/FacebookAds/Object/MerchantReport.php → src/FacebookAds/Object/AdsEligibility.php
@@ -13,7 +13,7 @@
 use FacebookAds\Cursor;
 use FacebookAds\Http\RequestInterface;
 use FacebookAds\TypeChecker;
-use FacebookAds\Object\Fields\MerchantReportFields;
+use FacebookAds\Object\Fields\AdsEligibilityFields;
 
 /**
  * This class is auto-generated.
@@ -24,13 +24,13 @@
  *
  */
 
-class MerchantReport extends AbstractObject {
+class AdsEligibility extends AbstractObject {
 
   /**
-   * @return MerchantReportFields
+   * @return AdsEligibilityFields
    */
   public static function getFieldsEnum() {
-    return MerchantReportFields::getInstance();
+    return AdsEligibilityFields::getInstance();
   }
 
   protected static function getReferencedEnums() {

diff --git a/src/FacebookAds/Object/AdsDataPartner.php → src/FacebookAds/Object/AdsMcmeConversion.php b/src/FacebookAds/Object/AdsDataPartner.php → src/FacebookAds/Object/AdsMcmeConversion.php
@@ -13,7 +13,7 @@
 use FacebookAds\Cursor;
 use FacebookAds\Http\RequestInterface;
 use FacebookAds\TypeChecker;
-use FacebookAds\Object\Fields\AdsDataPartnerFields;
+use FacebookAds\Object\Fields\AdsMcmeConversionFields;
 
 /**
  * This class is auto-generated.
@@ -24,13 +24,13 @@
  *
  */
 
-class AdsDataPartner extends AbstractCrudObject {
+class AdsMcmeConversion extends AbstractCrudObject {
 
   /**
-   * @return AdsDataPartnerFields
+   * @return AdsMcmeConversionFields
    */
   public static function getFieldsEnum() {
-    return AdsDataPartnerFields::getInstance();
+    return AdsMcmeConversionFields::getInstance();
   }
 
   protected static function getReferencedEnums() {
@@ -52,9 +52,9 @@ public function getSelf(array $fields = array(), array $params = array(), $pendi
       $this->data['id'],
       RequestInterface::METHOD_GET,
       '/',
-      new AdsDataPartner(),
+      new AdsMcmeConversion(),
       'NODE',
-      AdsDataPartner::getFieldsEnum()->getValues(),
+      AdsMcmeConversion::getFieldsEnum()->getValues(),
       new TypeChecker($param_types, $enums)
     );
     $request->addParams($params);

diff --git a/src/FacebookAds/Object/Album.php b/src/FacebookAds/Object/Album.php
@@ -225,6 +225,7 @@ public function createPhoto(array $fields = array(), array $params = array(), $p
       'place' => 'Object',
       'privacy' => 'string',
       'profile_id' => 'int',
+      'provenance_info' => 'map',
       'proxied_app_id' => 'string',
       'published' => 'bool',
       'qn' => 'string',

diff --git a/src/FacebookAds/Object/Application.php b/src/FacebookAds/Object/Application.php
@@ -166,6 +166,7 @@ public function createActivity(array $fields = array(), array $params = array(),
       'app_user_id' => 'string',
       'application_tracking_enabled' => 'bool',
       'attribution' => 'string',
+      'attribution_sources' => 'list<map>',
       'auto_publish' => 'bool',
       'bundle_id' => 'string',
       'bundle_short_version' => 'string',
@@ -187,8 +188,10 @@ public function createActivity(array $fields = array(), array $params = array(),
       'install_referrer' => 'string',
       'install_timestamp' => 'unsigned int',
       'installer_package' => 'string',
+      'is_fb' => 'bool',
       'limited_data_use' => 'bool',
       'migration_bundle' => 'string',
+      'operational_parameters' => 'list<map>',
       'page_id' => 'unsigned int',
       'page_scoped_user_id' => 'unsigned int',
       'receipt_data' => 'string',
@@ -1025,18 +1028,27 @@ public function createMmpAuditing(array $fields = array(), array $params = array
     $param_types = array(
       'advertiser_id' => 'string',
       'attribution' => 'string',
+      'attribution_method' => 'string',
       'attribution_model' => 'string',
+      'attribution_referrer' => 'string',
       'auditing_token' => 'string',
       'click_attr_window' => 'unsigned int',
       'custom_events' => 'list<Object>',
       'decline_reason' => 'string',
+      'device_os' => 'string',
       'engagement_type' => 'string',
       'event' => 'string',
+      'event_id' => 'string',
       'event_reported_time' => 'unsigned int',
       'fb_ad_id' => 'unsigned int',
+      'fb_adgroup_id' => 'unsigned int',
       'fb_click_time' => 'unsigned int',
       'fb_view_time' => 'unsigned int',
+      'google_install_referrer' => 'string',
+      'inactivity_window_hours' => 'unsigned int',
+      'install_id' => 'string',
       'is_fb' => 'bool',
+      'meta_install_referrer' => 'string',
       'used_install_referrer' => 'bool',
       'view_attr_window' => 'unsigned int',
     );
@@ -1209,30 +1221,6 @@ public function createOccludesPopup(array $fields = array(), array $params = arr
     return $pending ? $request : $request->execute();
   }
 
-  public function createPaymentCurrency(array $fields = array(), array $params = array(), $pending = false) {
-    $this->assureId();
-
-    $param_types = array(
-      'currency_url' => 'string',
-    );
-    $enums = array(
-    );
-
-    $request = new ApiRequest(
-      $this->api,
-      $this->data['id'],
-      RequestInterface::METHOD_POST,
-      '/payment_currencies',
-      new Application(),
-      'EDGE',
-      Application::getFieldsEnum()->getValues(),
-      new TypeChecker($param_types, $enums)
-    );
-    $request->addParams($params);
-    $request->addFields($fields);
-    return $pending ? $request : $request->execute();
-  }
-
   public function getPermissions(array $fields = array(), array $params = array(), $pending = false) {
     $this->assureId();
 

diff --git a/src/FacebookAds/Object/Business.php b/src/FacebookAds/Object/Business.php
@@ -2295,10 +2295,8 @@ public function createOpenBridgeConfiguration(array $fields = array(), array $pa
       'destination_id' => 'string',
       'endpoint' => 'string',
       'fallback_domain' => 'string',
-      'fallback_domain_enabled' => 'bool',
       'first_party_domain' => 'string',
       'host_business_id' => 'unsigned int',
-      'host_external_id' => 'string',
       'instance_id' => 'string',
       'instance_version' => 'string',
       'is_sgw_instance' => 'bool',

diff --git a/src/FacebookAds/Object/Domain.php → ...ds/Object/CatalogContentVersionConfig.php b/src/FacebookAds/Object/Domain.php → ...ds/Object/CatalogContentVersionConfig.php
@@ -13,7 +13,7 @@
 use FacebookAds\Cursor;
 use FacebookAds\Http\RequestInterface;
 use FacebookAds\TypeChecker;
-use FacebookAds\Object\Fields\DomainFields;
+use FacebookAds\Object\Fields\CatalogContentVersionConfigFields;
 
 /**
  * This class is auto-generated.
@@ -24,13 +24,13 @@
  *
  */
 
-class Domain extends AbstractCrudObject {
+class CatalogContentVersionConfig extends AbstractCrudObject {
 
   /**
-   * @return DomainFields
+   * @return CatalogContentVersionConfigFields
    */
   public static function getFieldsEnum() {
-    return DomainFields::getInstance();
+    return CatalogContentVersionConfigFields::getInstance();
   }
 
   protected static function getReferencedEnums() {
@@ -52,9 +52,9 @@ public function getSelf(array $fields = array(), array $params = array(), $pendi
       $this->data['id'],
       RequestInterface::METHOD_GET,
       '/',
-      new Domain(),
+      new CatalogContentVersionConfig(),
       'NODE',
-      Domain::getFieldsEnum()->getValues(),
+      CatalogContentVersionConfig::getFieldsEnum()->getValues(),
       new TypeChecker($param_types, $enums)
     );
     $request->addParams($params);

diff --git a/src/FacebookAds/Object/CustomAudience.php b/src/FacebookAds/Object/CustomAudience.php
@@ -379,6 +379,8 @@ public function getSelf(array $fields = array(), array $params = array(), $pendi
 
     $param_types = array(
       'ad_account_id' => 'string',
+      'special_ad_categories' => 'list<string>',
+      'special_ad_category_countries' => 'list<string>',
       'target_countries' => 'list<string>',
     );
     $enums = array(