diff --git a/src/Auth/ServiceClient.php b/src/Auth/ServiceClient.php index 9ab6d9b9..e1e789db 100644 --- a/src/Auth/ServiceClient.php +++ b/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', /** diff --git a/src/V13/AdInsight/GetKeywordLocationsRequest.php b/src/V13/AdInsight/GetKeywordLocationsRequest.php index 2cda9b46..6bb46bc5 100644 --- a/src/V13/AdInsight/GetKeywordLocationsRequest.php +++ b/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; diff --git a/src/V13/AdInsight/KeywordLocation.php b/src/V13/AdInsight/KeywordLocation.php index 8c705817..d18ff991 100644 --- a/src/V13/AdInsight/KeywordLocation.php +++ b/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; diff --git a/src/V13/Bulk/DownloadEntity.php b/src/V13/Bulk/DownloadEntity.php index fa10d0e7..18c6d5c3 100644 --- a/src/V13/Bulk/DownloadEntity.php +++ b/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'; } } diff --git a/src/V13/CampaignManagement/AdAdditionalField.php b/src/V13/CampaignManagement/AdAdditionalField.php index 19c7fe44..71e946e8 100644 --- a/src/V13/CampaignManagement/AdAdditionalField.php +++ b/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'; } } diff --git a/src/V13/CampaignManagement/AdExtensionEditorialReason.php b/src/V13/CampaignManagement/AdExtensionEditorialReason.php index c539bbb7..a8dd8d08 100644 --- a/src/V13/CampaignManagement/AdExtensionEditorialReason.php +++ b/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; diff --git a/src/V13/CampaignManagement/AdGroup.php b/src/V13/CampaignManagement/AdGroup.php index 6ff6e581..3c9dd00f 100644 --- a/src/V13/CampaignManagement/AdGroup.php +++ b/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; diff --git a/src/V13/CampaignManagement/AdGroupAdditionalField.php b/src/V13/CampaignManagement/AdGroupAdditionalField.php index 2ddfdc5b..45b824e6 100644 --- a/src/V13/CampaignManagement/AdGroupAdditionalField.php +++ b/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'; } diff --git a/src/V13/CampaignManagement/AdGroupCriterionType.php b/src/V13/CampaignManagement/AdGroupCriterionType.php index 11310093..4ca08cca 100644 --- a/src/V13/CampaignManagement/AdGroupCriterionType.php +++ b/src/V13/CampaignManagement/AdGroupCriterionType.php @@ -91,6 +91,9 @@ final class AdGroupCriterionType /** Reserved. */ const HotelCheckInDate = 'HotelCheckInDate'; + + /** Reserved. */ + const Genre = 'Genre'; } } diff --git a/src/V13/CampaignManagement/AddAssetGroupsRequest.php b/src/V13/CampaignManagement/AddAssetGroupsRequest.php index d394409b..e1fbe06e 100644 --- a/src/V13/CampaignManagement/AddAssetGroupsRequest.php +++ b/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; diff --git a/src/V13/CampaignManagement/AddAssetGroupsResponse.php b/src/V13/CampaignManagement/AddAssetGroupsResponse.php index 1dba4cdd..4dc3a629 100644 --- a/src/V13/CampaignManagement/AddAssetGroupsResponse.php +++ b/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; diff --git a/src/V13/CampaignManagement/AddAudienceGroupsRequest.php b/src/V13/CampaignManagement/AddAudienceGroupsRequest.php index 789489be..70f6ca7a 100644 --- a/src/V13/CampaignManagement/AddAudienceGroupsRequest.php +++ b/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; diff --git a/src/V13/CampaignManagement/AddAudienceGroupsResponse.php b/src/V13/CampaignManagement/AddAudienceGroupsResponse.php index 14607b1e..0f502ecd 100644 --- a/src/V13/CampaignManagement/AddAudienceGroupsResponse.php +++ b/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; diff --git a/src/V13/CampaignManagement/AgeDimension.php b/src/V13/CampaignManagement/AgeDimension.php index d0db042b..5e472022 100644 --- a/src/V13/CampaignManagement/AgeDimension.php +++ b/src/V13/CampaignManagement/AgeDimension.php @@ -4,7 +4,7 @@ { /** - * 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 @@ -12,7 +12,7 @@ final class AgeDimension extends AudienceGroupDimension { /** - * Reserved. + * A list of age ranges. * @var AgeRange[] */ public $AgeRanges; diff --git a/src/V13/CampaignManagement/AppealStatus.php b/src/V13/CampaignManagement/AppealStatus.php index 0ec7c200..7bb877aa 100644 --- a/src/V13/CampaignManagement/AppealStatus.php +++ b/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 diff --git a/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsRequest.php b/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsRequest.php index cf2b6e3c..15d7660c 100644 --- a/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsRequest.php +++ b/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; diff --git a/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsResponse.php b/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsResponse.php index 96866e29..56dec04f 100644 --- a/src/V13/CampaignManagement/ApplyAssetGroupListingGroupActionsResponse.php +++ b/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; diff --git a/src/V13/CampaignManagement/ApplyCustomerListItemsRequest.php b/src/V13/CampaignManagement/ApplyCustomerListItemsRequest.php new file mode 100644 index 00000000..ed1ad0a5 --- /dev/null +++ b/src/V13/CampaignManagement/ApplyCustomerListItemsRequest.php @@ -0,0 +1,21 @@ +