From 5787319f2410a0ea6a9b5c9b5efc14fa9382592b Mon Sep 17 00:00:00 2001 From: Qingjun Tian Date: Fri, 18 Aug 2023 10:39:11 +0800 Subject: [PATCH] v13.0.17 --- src/Auth/ServiceClient.php | 2 +- .../AdInsight/GetKeywordLocationsRequest.php | 2 +- src/V13/AdInsight/KeywordLocation.php | 2 +- src/V13/Bulk/DownloadEntity.php | 22 +++++++--- .../CampaignManagement/AdAdditionalField.php | 3 ++ .../AdExtensionEditorialReason.php | 2 +- src/V13/CampaignManagement/AdGroup.php | 4 +- .../AdGroupAdditionalField.php | 4 +- .../AdGroupCriterionType.php | 3 ++ .../AddAssetGroupsRequest.php | 6 +-- .../AddAssetGroupsResponse.php | 6 +-- .../AddAudienceGroupsRequest.php | 4 +- .../AddAudienceGroupsResponse.php | 6 +-- src/V13/CampaignManagement/AgeDimension.php | 4 +- src/V13/CampaignManagement/AppealStatus.php | 1 + ...lyAssetGroupListingGroupActionsRequest.php | 4 +- ...yAssetGroupListingGroupActionsResponse.php | 6 +-- .../ApplyCustomerListItemsRequest.php | 21 ++++++++++ .../ApplyCustomerListItemsResponse.php | 21 ++++++++++ src/V13/CampaignManagement/AssetGroup.php | 36 ++++++++-------- .../AssetGroupEditorialReason.php | 39 ++++++++++++++++++ .../AssetGroupEditorialReasonCollection.php | 41 +++++++++++++++++++ .../AssetGroupEditorialStatus.php | 10 ++--- .../AssetGroupListingGroup.php | 14 +++---- .../AssetGroupListingGroupAction.php | 6 +-- .../AssetGroupListingType.php | 6 +-- .../CampaignManagement/AssetGroupStatus.php | 11 +++-- .../CampaignManagement/AudienceDimension.php | 4 +- src/V13/CampaignManagement/AudienceGroup.php | 12 +++--- .../AudienceGroupAssetGroupAssociation.php | 6 +-- .../AudienceGroupDimension.php | 4 +- .../AudienceGroupDimensionType.php | 8 ++-- src/V13/CampaignManagement/AudienceInfo.php | 6 +-- src/V13/CampaignManagement/BMCStore.php | 2 +- .../BMCStoreAdditionalField.php | 2 +- src/V13/CampaignManagement/BatchError.php | 2 + .../CallToActionSetting.php | 19 +++++++++ src/V13/CampaignManagement/Campaign.php | 2 +- .../CampaignAdditionalField.php | 11 ++++- src/V13/CampaignManagement/ConversionGoal.php | 2 +- .../ConversionGoalAdditionalField.php | 3 ++ .../CostPerSaleBiddingScheme.php | 4 +- src/V13/CampaignManagement/CustomerList.php | 15 +++++++ .../CustomerListActionType.php | 27 ++++++++++++ .../CampaignManagement/CustomerListItem.php | 28 +++++++++++++ .../CustomerListItemSubType.php | 21 ++++++++++ src/V13/CampaignManagement/DealCriterion.php | 19 +++++++++ .../DeleteAssetGroupsRequest.php | 6 +-- .../DeleteAssetGroupsResponse.php | 4 +- ...enceGroupAssetGroupAssociationsRequest.php | 4 +- ...nceGroupAssetGroupAssociationsResponse.php | 4 +- .../DeleteAudienceGroupsRequest.php | 4 +- .../DeleteAudienceGroupsResponse.php | 4 +- .../CampaignManagement/EditorialReason.php | 2 +- .../EntityIdToParentIdAssociation.php | 1 + src/V13/CampaignManagement/EntityType.php | 3 ++ .../FrequencyCapSettings.php | 6 +-- .../FrequencyCapTimeGranularity.php | 10 ++--- .../CampaignManagement/GenderDimension.php | 4 +- src/V13/CampaignManagement/GenreCriterion.php | 19 +++++++++ ...GetAssetGroupListingGroupsByIdsRequest.php | 6 +-- ...etAssetGroupListingGroupsByIdsResponse.php | 4 +- .../GetAssetGroupsByCampaignIdRequest.php | 4 +- .../GetAssetGroupsByCampaignIdResponse.php | 6 +-- .../GetAssetGroupsByIdsRequest.php | 6 +-- .../GetAssetGroupsByIdsResponse.php | 6 +-- .../GetAssetGroupsEditorialReasonsRequest.php | 27 ++++++++++++ ...GetAssetGroupsEditorialReasonsResponse.php | 28 +++++++++++++ ...roupAssociationsByAssetGroupIdsRequest.php | 4 +- ...oupAssociationsByAssetGroupIdsResponse.php | 6 +-- ...pAssociationsByAudienceGroupIdsRequest.php | 4 +- ...AssociationsByAudienceGroupIdsResponse.php | 6 +-- .../GetAudienceGroupsByIdsRequest.php | 4 +- .../GetAudienceGroupsByIdsResponse.php | 6 +-- src/V13/CampaignManagement/ImageAsset.php | 12 ++++++ .../ManualCpaBiddingScheme.php | 2 +- .../MaxConversionValueBiddingScheme.php | 2 +- .../MaxConversionsBiddingScheme.php | 2 +- .../CampaignManagement/OfflineConversion.php | 4 +- .../OfflineConversionAdjustment.php | 4 +- .../CampaignManagement/ProductCondition.php | 6 +++ src/V13/CampaignManagement/ResponsiveAd.php | 7 ++++ ...enceGroupAssetGroupAssociationsRequest.php | 4 +- ...nceGroupAssetGroupAssociationsResponse.php | 4 +- .../CampaignManagement/ShoppingSetting.php | 12 ++++++ .../UpdateAssetGroupsRequest.php | 6 +-- .../UpdateAssetGroupsResponse.php | 4 +- .../UpdateAudienceGroupsRequest.php | 4 +- .../UpdateAudienceGroupsResponse.php | 4 +- .../VerifiedTrackingSetting.php | 1 + ...eatureAdoptionCouponEligibilityRequest.php | 26 ++++++++++++ ...atureAdoptionCouponEligibilityResponse.php | 20 +++++++++ .../ClaimFeatureAdoptionCouponsRequest.php | 21 ++++++++++ .../ClaimFeatureAdoptionCouponsResponse.php | 34 +++++++++++++++ src/V13/CustomerBilling/Coupon.php | 7 ++++ src/V13/CustomerBilling/CouponClaimInfo.php | 33 +++++++++++++++ .../KeyValuePairOflongdateTime.php | 27 ++++++++++++ .../KeyValuePairOflongstring.php | 27 ++++++++++++ src/V13/CustomerBilling/OperationError.php | 1 + .../AccountLifeCycleStatus.php | 2 +- src/V13/CustomerManagement/LCID.php | 5 ++- .../AccountPerformanceReportColumn.php | 18 ++++++++ .../AdGroupPerformanceReportColumn.php | 18 ++++++++ .../AssetGroupStatusReportFilter.php | 30 ++++++++++++++ .../CampaignPerformanceReportColumn.php | 18 ++++++++ .../GeographicPerformanceReportColumn.php | 14 ++++++- .../GeographicPerformanceReportFilter.php | 7 ++++ .../HotelDimensionPerformanceReportColumn.php | 19 ++++++--- .../HotelGroupPerformanceReportColumn.php | 3 ++ ...roductDimensionPerformanceReportColumn.php | 32 ++++++++++++++- ...roductDimensionPerformanceReportFilter.php | 7 ++++ .../ProductMatchCountReportColumn.php | 9 ++++ ...uctNegativeKeywordConflictReportColumn.php | 12 ++++++ ...uctNegativeKeywordConflictReportFilter.php | 7 ++++ ...roductPartitionPerformanceReportColumn.php | 14 ++++++- ...roductPartitionPerformanceReportFilter.php | 7 ++++ ...ctPartitionUnitPerformanceReportColumn.php | 12 ++++++ ...ctPartitionUnitPerformanceReportFilter.php | 7 ++++ ...ductSearchQueryPerformanceReportColumn.php | 9 ++++ ...ductSearchQueryPerformanceReportFilter.php | 7 ++++ .../PublisherUsagePerformanceReportColumn.php | 12 ++++++ .../PublisherUsagePerformanceReportFilter.php | 7 ++++ .../UserLocationPerformanceReportColumn.php | 13 +++++- 123 files changed, 1049 insertions(+), 185 deletions(-) create mode 100644 src/V13/CampaignManagement/ApplyCustomerListItemsRequest.php create mode 100644 src/V13/CampaignManagement/ApplyCustomerListItemsResponse.php create mode 100644 src/V13/CampaignManagement/AssetGroupEditorialReason.php create mode 100644 src/V13/CampaignManagement/AssetGroupEditorialReasonCollection.php create mode 100644 src/V13/CampaignManagement/CallToActionSetting.php create mode 100644 src/V13/CampaignManagement/CustomerListActionType.php create mode 100644 src/V13/CampaignManagement/CustomerListItem.php create mode 100644 src/V13/CampaignManagement/CustomerListItemSubType.php create mode 100644 src/V13/CampaignManagement/DealCriterion.php create mode 100644 src/V13/CampaignManagement/GenreCriterion.php create mode 100644 src/V13/CampaignManagement/GetAssetGroupsEditorialReasonsRequest.php create mode 100644 src/V13/CampaignManagement/GetAssetGroupsEditorialReasonsResponse.php create mode 100644 src/V13/CustomerBilling/CheckFeatureAdoptionCouponEligibilityRequest.php create mode 100644 src/V13/CustomerBilling/CheckFeatureAdoptionCouponEligibilityResponse.php create mode 100644 src/V13/CustomerBilling/ClaimFeatureAdoptionCouponsRequest.php create mode 100644 src/V13/CustomerBilling/ClaimFeatureAdoptionCouponsResponse.php create mode 100644 src/V13/CustomerBilling/CouponClaimInfo.php create mode 100644 src/V13/CustomerBilling/KeyValuePairOflongdateTime.php create mode 100644 src/V13/CustomerBilling/KeyValuePairOflongstring.php create mode 100644 src/V13/Reporting/AssetGroupStatusReportFilter.php 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 @@ +