Merge pull request #193 from BingAds/v13.0.18

v13.0.18

Author: qitia

src/Auth/ServiceClient.php

@@ -242,7 +242,7 @@ private function RefreshServiceProxy()
 			'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
 			// Disable keep_alive to avoid 'Process open FD table is full'
 			'keep_alive' => FALSE, 
-			'user_agent' => 'BingAdsSDKPHP ' . '13.0.17 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.18 ' . PHP_VERSION, 
 			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 

src/V13/Bulk/DownloadEntity.php

@@ -473,6 +473,15 @@ final class DownloadEntity
 
         /** Reserved. */
         const AdGroupLogoAdExtensions = 'AdGroupLogoAdExtensions';
+
+        /** Reserved. */
+        const LeadFormAdExtensions = 'LeadFormAdExtensions';
+
+        /** Reserved. */
+        const AccountLeadFormAdExtensions = 'AccountLeadFormAdExtensions';
+
+        /** Reserved. */
+        const CampaignLeadFormAdExtensions = 'CampaignLeadFormAdExtensions';
     }
 
 }

src/V13/CampaignManagement/AccountNegativeKeywordList.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Microsoft\BingAds\V13\CampaignManagement;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/campaign-management-service/accountnegativekeywordlist?view=bingads-13 AccountNegativeKeywordList Data Object
+     */
+    final class AccountNegativeKeywordList extends SharedList
+    {
+    }
+
+}

src/V13/CampaignManagement/AdGroup.php

@@ -153,11 +153,17 @@ final class AdGroup
         public $UrlCustomParameters;
 
         /**
-         * Indicates if predictive targeting is enabled for an AdGroup.
+         * This will be deprecated.
          * @var boolean
          */
         public $UseOptimizedTargeting;
 
+        /**
+         * Indicates if predictive targeting is enabled for an AdGroup.
+         * @var boolean
+         */
+        public $UsePredictiveTargeting;
+
         /**
          * Determines whether to use the account time zone or the time zone of the search user where the ads could be delivered.
          * @var boolean

src/V13/CampaignManagement/AdGroupAdditionalField.php

@@ -36,11 +36,14 @@ final class AdGroupAdditionalField
         /** Reserved. */
         const McpaBid = 'McpaBid';
 
-        /** Indicates if predictive targeting is enabled for an AdGroup. */
+        /** This will be deprecated. */
         const UseOptimizedTargeting = 'UseOptimizedTargeting';
 
         /** Settings for the frequency cap. */
         const FrequencyCapSettings = 'FrequencyCapSettings';
+
+        /** Indicates if predictive targeting is enabled for an AdGroup. */
+        const UsePredictiveTargeting = 'UsePredictiveTargeting';
     }
 
 }

src/V13/CampaignManagement/AdGroupCriterionType.php

@@ -92,7 +92,7 @@ final class AdGroupCriterionType
         /** Reserved. */
         const HotelCheckInDate = 'HotelCheckInDate';
 
-        /** Reserved. */
+        /** The ad group criterion is a genre criterion. */
         const Genre = 'Genre';
     }
 

src/V13/CampaignManagement/AddAudienceGroupsRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Adds array of audience groups to a specified campaign.
+     * Adds array of audience groups to the account.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addaudiencegroups?view=bingads-13 AddAudienceGroups Request Object
      * 
      * @uses AudienceGroup

src/V13/CampaignManagement/AddAudienceGroupsResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Adds array of audience groups to a specified campaign.
+     * Adds array of audience groups to the account.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addaudiencegroups?view=bingads-13 AddAudienceGroups Response Object
      * 
      * @uses BatchError

src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsRequest.php

@@ -13,7 +13,7 @@
     final class ApplyAssetGroupListingGroupActionsRequest
     {
         /**
-         * A list of AssetGroupListingGroupAction objects that each contain an Action element and a ListingGroup element.All of the asset group listing group actions must be for the same asset group
+         * A list of AssetGroupListingGroupAction objects that each contain an Action element and a ListingGroup element.
          * @var AssetGroupListingGroupAction[]
          */
         public $ListingGroupActions;

src/V13/CampaignManagement/AssetGroupStatus.php

@@ -11,16 +11,16 @@
      */
     final class AssetGroupStatus
     {
-        /** The status of the AssetGroup is Active. */
+        /** The asset group is active, which indicates that the asset group can be served. */
         const Active = 'Active';
 
-        /** The status of the AssetGroup is Paused. */
+        /** The asset group is paused, which indicates that the asset group will not serve. */
         const Paused = 'Paused';
 
-        /** The status of the AssetGroup is Deleted. */
+        /** This status is for internal use only. */
         const Deleted = 'Deleted';
 
-        /** Reserved. */
+        /** The asset group is expired. */
         const Expired = 'Expired';
     }
 

src/V13/CampaignManagement/CampaignAdditionalField.php

@@ -65,6 +65,9 @@ final class CampaignAdditionalField
 
         /** Reserved. */
         const CallToActionSetting = 'CallToActionSetting';
+
+        /** Reserved. */
+        const PageFeedInPerformanceMaxSettings = 'PageFeedInPerformanceMaxSettings';
     }
 
 }

src/V13/CampaignManagement/CampaignConversionGoal.php

@@ -13,13 +13,13 @@
     final class CampaignConversionGoal
     {
         /**
-         * Reserved.
+         * The Microsoft Advertising assigned identifier of a campaign.
          * @var integer
          */
         public $CampaignId;
 
         /**
-         * Reserved.
+         * The Microsoft Advertising assigned identifier of a conversion goal.
          * @var integer
          */
         public $GoalId;

src/V13/CampaignManagement/CampaignType.php

@@ -29,7 +29,7 @@ final class CampaignType
         /** The campaign is a Hotel campaign. */
         const Hotel = 'Hotel';
 
-        /** Reserved. */
+        /** The campaign is a Performance max campaign. */
         const PerformanceMax = 'PerformanceMax';
     }
 

src/V13/CampaignManagement/DealCriterion.php

@@ -4,13 +4,13 @@
 
 {
     /**
-     * Reserved.
+     * Defines a criterion that can be used to show ads for a specific deal.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/dealcriterion?view=bingads-13 DealCriterion Data Object
      */
     final class DealCriterion extends Criterion
     {
         /**
-         * Reserved.
+         * The Microsoft Advertising identifier of the Deal.
          * @var integer
          */
         public $DealId;

src/V13/CampaignManagement/FrequencyCapSettings.php

@@ -18,12 +18,6 @@ final class FrequencyCapSettings
          */
         public $CapValue;
 
-        /**
-         * What unit to limit the ad serves.
-         * @var string
-         */
-        public $FrequencyCapUnit;
-
         /**
          * The smallest time interval to limit ad serves.
          * @var FrequencyCapTimeGranularity

src/V13/CampaignManagement/FrequencyCapTimeGranularity.php

@@ -17,14 +17,8 @@ final class FrequencyCapTimeGranularity
         /** The number of days to limit ad serves by. */
         const DAY = 'DAY';
 
-        /** The number of weeks to limit ad serves by.. */
+        /** The number of weeks to limit ad serves by. */
         const WEEK = 'WEEK';
-
-        /** The number of months to limit ad serves by. */
-        const MONTH = 'MONTH';
-
-        /** Limit ad serves by the lifetime of the ad. */
-        const LIFETIME = 'LIFETIME';
     }
 
 }

src/V13/CampaignManagement/GenreCriterion.php

@@ -4,13 +4,13 @@
 
 {
     /**
-     * Reserved.
+     * Defines a criterion that can be used to show ads from a specific genre.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/genrecriterion?view=bingads-13 GenreCriterion Data Object
      */
     final class GenreCriterion extends Criterion
     {
         /**
-         * Reserved.
+         * The Microsoft Advertising identifier of the Genre.
          * @var integer
          */
         public $GenreId;

src/V13/CampaignManagement/GoogleImportOption.php

@@ -36,7 +36,7 @@ final class GoogleImportOption extends ImportOption
         public $AdjustmentForCampaignBudgets;
 
         /**
-         * The identifier of the Microsoft Merchant Center store that you want to associate with imported product ads and product filters.
+         * Note: AssociatedStoreId is deprecated.
          * @var integer
          */
         public $AssociatedStoreId;
@@ -179,6 +179,12 @@ final class GoogleImportOption extends ImportOption
          */
         public $NewLocationTargets;
 
+        /**
+         * Reserved.
+         * @var boolean
+         */
+        public $NewLogoAdExtensions;
+
         /**
          * Import negative keyword lists that have not previously been imported.
          * @var boolean
@@ -479,6 +485,12 @@ final class GoogleImportOption extends ImportOption
          */
         public $UpdateLocationTargets;
 
+        /**
+         * Reserved.
+         * @var boolean
+         */
+        public $UpdateLogoAdExtensions;
+
         /**
          * Import updates to existing negative keyword lists.
          * @var boolean
@@ -527,6 +539,12 @@ final class GoogleImportOption extends ImportOption
          */
         public $UpdateSitelinkAdExtensions;
 
+        /**
+         * Reserved.
+         * @var boolean
+         */
+        public $UpdateSitelinkUrls;
+
         /**
          * Import updates to the status of existing ad groups.
          * @var boolean

src/V13/CampaignManagement/ImportAdditionalField.php

@@ -44,6 +44,15 @@ final class ImportAdditionalField
 
         /** Reserved. */
         const UpdateAdUrls = 'UpdateAdUrls';
+
+        /** Reserved. */
+        const NewLogoAdExtensions = 'NewLogoAdExtensions';
+
+        /** Reserved. */
+        const UpdateLogoAdExtensions = 'UpdateLogoAdExtensions';
+
+        /** Reserved. */
+        const UpdateSitelinkUrls = 'UpdateSitelinkUrls';
     }
 
 }

src/V13/CampaignManagement/LanguageName.php

@@ -122,6 +122,24 @@ final class LanguageName
         /** Reserved. */
         const Russian = 'Russian';
 
+        /** Reserved. */
+        const Malay = 'Malay';
+
+        /** Reserved. */
+        const Thai = 'Thai';
+
+        /** Reserved. */
+        const Indonesian = 'Indonesian';
+
+        /** Reserved. */
+        const Tagalog = 'Tagalog';
+
+        /** Reserved. */
+        const Vietnamese = 'Vietnamese';
+
+        /** Reserved. */
+        const Hindi = 'Hindi';
+
         /** The corresponding language name. */
         const All = 'All';
     }

src/V13/CampaignManagement/PerformanceMaxSetting.php

@@ -10,10 +10,16 @@
     final class PerformanceMaxSetting extends Setting
     {
         /**
-         * Reserved.
+         * If false, then the entire domain will be targeted, and ad assets will be dynamically generated to match landing page content.
          * @var boolean
          */
         public $FinalUrlExpansionOptOut;
+
+        /**
+         * Reserved.
+         * @var integer[]
+         */
+        public $PageFeedIds;
     }
 
 }

src/V13/CustomerBilling/BillingDocumentInfo.php

@@ -59,6 +59,12 @@ final class BillingDocumentInfo
          * @var integer
          */
         public $CustomerId;
+
+        /**
+         * Reserved.
+         * @var integer
+         */
+        public $CampaignId;
     }
 
 }

src/V13/CustomerBilling/CheckFeatureAdoptionCouponEligibilityRequest.php

@@ -4,21 +4,21 @@
 
 {
     /**
-     * Reserved.
+     * Check the FAC eligibility of an account.
      * @link https:/learn.microsoft.com/advertising/customer-billing-service/checkfeatureadoptioncouponeligibility?view=bingads-13 CheckFeatureAdoptionCouponEligibility Request Object
      * 
      * @used-by BingAdsCustomerBillingService::CheckFeatureAdoptionCouponEligibility
      */
     final class CheckFeatureAdoptionCouponEligibilityRequest
     {
         /**
-         * Reserved.
+         * The identifier of the feature.
          * @var integer
          */
         public $FeatureId;
 
         /**
-         * Reserved.
+         * A list of account identifiers to check for eligibility.
          * @var integer[]
          */
         public $AccountIds;

src/V13/CustomerBilling/CheckFeatureAdoptionCouponEligibilityResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Check the FAC eligibility of an account.
      * @link https:/learn.microsoft.com/advertising/customer-billing-service/checkfeatureadoptioncouponeligibility?view=bingads-13 CheckFeatureAdoptionCouponEligibility Response Object
      * 
      * @used-by BingAdsCustomerBillingService::CheckFeatureAdoptionCouponEligibility