Merge pull request #80 from BingAds/september-proxy-updates

proxy refresh

Author: eric-urban

src/V12/Bulk/DownloadEntity.php

@@ -272,6 +272,15 @@ final class DownloadEntity
 
         /** Include Ad Group Negative Product Audience Association records in the download that each represent the association relationship between an ad group and a product audience exclusion. */
         const AdGroupNegativeProductAudienceAssociations = 'AdGroupNegativeProductAudienceAssociations';
+
+        /** Include Similar Remarketing List records in the download data. */
+        const SimilarRemarketingLists = 'SimilarRemarketingLists';
+
+        /** Include Ad Group Similar Remarketing List Association records in the download that each represent the association relationship between an ad group and a similar remarketing list. */
+        const AdGroupSimilarRemarketingListAssociations = 'AdGroupSimilarRemarketingListAssociations';
+
+        /** Include Ad Group Negative Similar Remarketing List Association records in the download that each represent the association relationship between an ad group and a similar remarketing list exclusion. */
+        const AdGroupNegativeSimilarRemarketingListAssociations = 'AdGroupNegativeSimilarRemarketingListAssociations';
     }
 
 }

src/V12/CampaignManagement/AccountPropertyName.php

@@ -21,7 +21,7 @@ final class AccountPropertyName
         /** Used to get or set the property that determines whether MSCLKID auto-tagging is enabled for the account. */
         const MSCLKIDAutoTaggingEnabled = 'MSCLKIDAutoTaggingEnabled';
 
-        /** Reserved. */
+        /** Used to get or set the property that determines whether you want to send customers directly to your final URL while click measurement runs in the background. */
         const AdClickParallelTracking = 'AdClickParallelTracking';
     }
 

src/V12/CampaignManagement/Ad.php

@@ -22,7 +22,7 @@
     class Ad
     {
         /**
-         * The Ad Format Preference is used to indicate whether or not you prefer the ad copy to be shown to users as a search or native ad.
+         * The Ad Format Preference is used to indicate whether or not you prefer the ad copy to be shown to users as a search or audience ad.
          * @var string
          */
         public $AdFormatPreference;

src/V12/CampaignManagement/AdAdditionalField.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Microsoft\BingAds\V12\CampaignManagement;
+
+{
+    /**
+     * Defines a list of optional Ad properties that you can request when calling GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds.
+     * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/adadditionalfield?view=bingads-12 AdAdditionalField Value Set
+     * 
+     * @used-by GetAdsByAdGroupIdRequest
+     * @used-by GetAdsByEditorialStatusRequest
+     * @used-by GetAdsByIdsRequest
+     */
+    final class AdAdditionalField
+    {
+        /** Request that the TitlePart3 element be included within each returned ExpandedTextAd object. */
+        const TitlePart3 = 'TitlePart3';
+
+        /** Request that the TextPart2 element be included within each returned ExpandedTextAd object. */
+        const TextPart2 = 'TextPart2';
+    }
+
+}

src/V12/CampaignManagement/CampaignStatus.php

@@ -26,7 +26,7 @@ final class CampaignStatus
         /** The campaign is deleted. */
         const Deleted = 'Deleted';
 
-        /** Your campaign has been suspended and no ads are eligible for delivery because of potentially fraudulent activity. */
+        /** Your campaign has been suspended because of suspicious activity, and no ads are eligible for delivery. */
         const Suspended = 'Suspended';
     }
 

src/V12/CampaignManagement/ExpandedTextAd.php

@@ -33,6 +33,12 @@ final class ExpandedTextAd extends Ad
          */
         public $Text;
 
+        /**
+         * Reserved for future use.
+         * @var string
+         */
+        public $TextPart2;
+
         /**
          * The first part of the ad title.
          * @var string
@@ -44,6 +50,12 @@ final class ExpandedTextAd extends Ad
          * @var string
          */
         public $TitlePart2;
+
+        /**
+         * Reserved for future use.
+         * @var string
+         */
+        public $TitlePart3;
     }
 
 }

src/V12/CampaignManagement/GetAdsByAdGroupIdRequest.php

@@ -8,6 +8,7 @@
      * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/getadsbyadgroupid?view=bingads-12 GetAdsByAdGroupId Request Object
      * 
      * @uses AdType
+     * @uses AdAdditionalField
      * @used-by BingAdsCampaignManagementService::GetAdsByAdGroupId
      */
     final class GetAdsByAdGroupIdRequest
@@ -23,5 +24,11 @@ final class GetAdsByAdGroupIdRequest
          * @var AdType[]
          */
         public $AdTypes;
+
+        /**
+         * The list of additional properties that you want included within each returned Ad object.
+         * @var AdAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V12/CampaignManagement/GetAdsByEditorialStatusRequest.php

@@ -9,6 +9,7 @@
      * 
      * @uses AdEditorialStatus
      * @uses AdType
+     * @uses AdAdditionalField
      * @used-by BingAdsCampaignManagementService::GetAdsByEditorialStatus
      */
     final class GetAdsByEditorialStatusRequest
@@ -30,5 +31,11 @@ final class GetAdsByEditorialStatusRequest
          * @var AdType[]
          */
         public $AdTypes;
+
+        /**
+         * The list of additional properties that you want included within each returned Ad object.
+         * @var AdAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V12/CampaignManagement/GetAdsByIdsRequest.php

@@ -8,6 +8,7 @@
      * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/getadsbyids?view=bingads-12 GetAdsByIds Request Object
      * 
      * @uses AdType
+     * @uses AdAdditionalField
      * @used-by BingAdsCampaignManagementService::GetAdsByIds
      */
     final class GetAdsByIdsRequest
@@ -29,5 +30,11 @@ final class GetAdsByIdsRequest
          * @var AdType[]
          */
         public $AdTypes;
+
+        /**
+         * The list of additional properties that you want included within each returned Ad object.
+         * @var AdAdditionalField
+         */
+        public $ReturnAdditionalFields;
     }
 }

src/V12/CampaignManagement/PriceTableRow.php

@@ -50,13 +50,13 @@ final class PriceTableRow
         public $Price;
 
         /**
-         * The price qualifier.
+         * The price qualifier for a given product or service e.
          * @var PriceQualifier
          */
         public $PriceQualifier;
 
         /**
-         * The price unit.
+         * The price unit allows you to specify the cost in terms of hour, day, week, etc.
          * @var PriceUnit
          */
         public $PriceUnit;