Merge pull request #189 from BingAds/v13.0.17

v13.0.17

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.16.1 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.17 ' . PHP_VERSION, 
 			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 

src/V13/AdInsight/GetKeywordLocationsRequest.php

@@ -42,7 +42,7 @@ final class GetKeywordLocationsRequest
         public $Level;
 
         /**
-         * The country from which the search originated.
+         * The country/region from which the search originated.
          * @var string
          */
         public $ParentCountry;

src/V13/AdInsight/KeywordLocation.php

@@ -18,7 +18,7 @@ final class KeywordLocation
         public $Device;
 
         /**
-         * The country, state, metropolitan area, or city where users entered the search query.
+         * The country/region, state, metropolitan area, or city where users entered the search query.
          * @var string
          */
         public $Location;

src/V13/Bulk/DownloadEntity.php

@@ -447,20 +447,32 @@ final class DownloadEntity
         /** Reserved. */
         const AdGroupHotelListingGroups = 'AdGroupHotelListingGroups';
 
-        /** Reserved. */
+        /** Array of asset groups to add to the specified campaign. */
         const AssetGroups = 'AssetGroups';
 
-        /** Reserved. */
+        /** Array of audience groups. */
         const AudienceGroups = 'AudienceGroups';
 
-        /** Reserved. */
+        /** Defines a negative site assigned to an campaign that can be uploaded and downloaded in a bulk file. */
         const CampaignNegativeWebpages = 'CampaignNegativeWebpages';
 
-        /** Reserved. */
+        /** The list of Audience Group associations. */
         const AudienceGroupAssetGroupAssociations = 'AudienceGroupAssetGroupAssociations';
 
-        /** Reserved. */
+        /** The list of listing groups that correspond directly to the identifiers specified in the request. */
         const AssetGroupListingGroups = 'AssetGroupListingGroups';
+
+        /** Reserved. */
+        const LogoAdExtensions = 'LogoAdExtensions';
+
+        /** Reserved. */
+        const AccountLogoAdExtensions = 'AccountLogoAdExtensions';
+
+        /** Reserved. */
+        const CampaignLogoAdExtensions = 'CampaignLogoAdExtensions';
+
+        /** Reserved. */
+        const AdGroupLogoAdExtensions = 'AdGroupLogoAdExtensions';
     }
 
 }

src/V13/CampaignManagement/AdAdditionalField.php

@@ -21,6 +21,9 @@ final class AdAdditionalField
 
         /** Request that the LongHeadlines element be included within each returned ResponsiveAd object. */
         const LongHeadlines = 'LongHeadlines';
+
+        /** Reserved. */
+        const ImageTargetDimension = 'ImageTargetDimension';
     }
 
 }

src/V13/CampaignManagement/AdExtensionEditorialReason.php

@@ -18,7 +18,7 @@ final class AdExtensionEditorialReason
         public $Location;
 
         /**
-         * The list of publisher countries whose editorial guidelines do not allow the specified term.
+         * The list of publisher countries or regions whose editorial guidelines do not allow the specified term.
          * @var string[]
          */
         public $PublisherCountries;

src/V13/CampaignManagement/AdGroup.php

@@ -75,7 +75,7 @@ final class AdGroup
         public $ForwardCompatibilityMap;
 
         /**
-         * Reserved.
+         * Settings for the frequency cap.
          * @var FrequencyCapSettings[]
          */
         public $FrequencyCapSettings;
@@ -153,7 +153,7 @@ final class AdGroup
         public $UrlCustomParameters;
 
         /**
-         * Reserved.
+         * Indicates if predictive targeting is enabled for an AdGroup.
          * @var boolean
          */
         public $UseOptimizedTargeting;

src/V13/CampaignManagement/AdGroupAdditionalField.php

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

src/V13/CampaignManagement/AdGroupCriterionType.php

@@ -91,6 +91,9 @@ final class AdGroupCriterionType
 
         /** Reserved. */
         const HotelCheckInDate = 'HotelCheckInDate';
+
+        /** Reserved. */
+        const Genre = 'Genre';
     }
 
 }

src/V13/CampaignManagement/AddAssetGroupsRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Adds array of asset groups to a specified campaign.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addassetgroups?view=bingads-13 AddAssetGroups Request Object
      * 
      * @uses AssetGroup
@@ -13,13 +13,13 @@
     final class AddAssetGroupsRequest
     {
         /**
-         * Reserved.
+         * Array of asset groups to add to the specified campaign.
          * @var AssetGroup[]
          */
         public $AssetGroups;
 
         /**
-         * Reserved.
+         * The ID of the Performace Max campaign.
          * @var integer
          */
         public $CampaignId;

src/V13/CampaignManagement/AddAssetGroupsResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Adds array of asset groups to a specified campaign.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addassetgroups?view=bingads-13 AddAssetGroups Response Object
      * 
      * @uses BatchError
@@ -13,13 +13,13 @@
     final class AddAssetGroupsResponse
     {
         /**
-         * Reserved.
+         * Array of asset group IDs to update for the specified campaign.
          * @var integer[]
          */
         public $AssetGroupIds;
 
         /**
-         * Reserved.
+         * An array of BatchError objects that contain details for any request items that weren't successful.
          * @var BatchError[]
          */
         public $PartialErrors;

src/V13/CampaignManagement/AddAudienceGroupsRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Adds array of audience groups to a specified campaign.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addaudiencegroups?view=bingads-13 AddAudienceGroups Request Object
      * 
      * @uses AudienceGroup
@@ -13,7 +13,7 @@
     final class AddAudienceGroupsRequest
     {
         /**
-         * Reserved.
+         * Array of audience groups.
          * @var AudienceGroup[]
          */
         public $AudienceGroups;

src/V13/CampaignManagement/AddAudienceGroupsResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Adds array of audience groups to a specified campaign.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/addaudiencegroups?view=bingads-13 AddAudienceGroups Response Object
      * 
      * @uses BatchError
@@ -13,13 +13,13 @@
     final class AddAudienceGroupsResponse
     {
         /**
-         * Reserved.
+         * Array of audience group ids to be added.
          * @var integer[]
          */
         public $AudienceGroupIds;
 
         /**
-         * Reserved.
+         * An array of BatchError objects that contain details for any request items that weren't successful.
          * @var BatchError[]
          */
         public $PartialErrors;

src/V13/CampaignManagement/AgeDimension.php

@@ -4,15 +4,15 @@
 
 {
     /**
-     * Reserved.
+     * Data object that specifies users by their age.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/agedimension?view=bingads-13 AgeDimension Data Object
      * 
      * @uses AgeRange
      */
     final class AgeDimension extends AudienceGroupDimension
     {
         /**
-         * Reserved.
+         * A list of age ranges.
          * @var AgeRange[]
          */
         public $AgeRanges;

src/V13/CampaignManagement/AppealStatus.php

@@ -7,6 +7,7 @@
      * Defines the values that you use to determine whether an editorial issue is appealable.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/appealstatus?view=bingads-13 AppealStatus Value Set
      * 
+     * @used-by AssetGroupEditorialReasonCollection
      * @used-by EditorialReasonCollection
      */
     final class AppealStatus

src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsRequest.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Applies an action to an asset group listing group.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/applyassetgrouplistinggroupactions?view=bingads-13 ApplyAssetGroupListingGroupActions Request Object
      * 
      * @uses AssetGroupListingGroupAction
@@ -13,7 +13,7 @@
     final class ApplyAssetGroupListingGroupActionsRequest
     {
         /**
-         * Reserved.
+         * 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
          * @var AssetGroupListingGroupAction[]
          */
         public $ListingGroupActions;

src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsResponse.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Applies an action to an asset group listing group.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/applyassetgrouplistinggroupactions?view=bingads-13 ApplyAssetGroupListingGroupActions Response Object
      * 
      * @uses BatchError
@@ -13,13 +13,13 @@
     final class ApplyAssetGroupListingGroupActionsResponse
     {
         /**
-         * Reserved.
+         * A list of IDs that for the listing groups that had the action applied.
          * @var integer[]
          */
         public $AssetGroupListingGroupIds;
 
         /**
-         * Reserved.
+         * An array of BatchError objects that contain details for any request items that weren't successful.
          * @var BatchError[]
          */
         public $PartialErrors;

src/V13/CampaignManagement/ApplyCustomerListItemsRequest.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Microsoft\BingAds\V13\CampaignManagement;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/campaign-management-service/applycustomerlistitems?view=bingads-13 ApplyCustomerListItems Request Object
+     * 
+     * @uses CustomerList
+     * @used-by BingAdsCampaignManagementService::ApplyCustomerListItems
+     */
+    final class ApplyCustomerListItemsRequest
+    {
+        /**
+         * Reserved.
+         * @var CustomerList
+         */
+        public $CustomerListAudience;
+    }
+}

src/V13/CampaignManagement/ApplyCustomerListItemsResponse.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Microsoft\BingAds\V13\CampaignManagement;
+
+{
+    /**
+     * Reserved.
+     * @link https:/learn.microsoft.com/advertising/campaign-management-service/applycustomerlistitems?view=bingads-13 ApplyCustomerListItems Response Object
+     * 
+     * @uses BatchError
+     * @used-by BingAdsCampaignManagementService::ApplyCustomerListItems
+     */
+    final class ApplyCustomerListItemsResponse
+    {
+        /**
+         * Reserved.
+         * @var BatchError[]
+         */
+        public $PartialErrors;
+    }
+}