Skip to content

Commit 7fdbb9d

Browse files
author
Eric Urban
authored
Merge pull request #136 from BingAds/v13-0-5-dev
proxy updates
2 parents a79b036 + 5d4d1e7 commit 7fdbb9d

File tree

59 files changed

+350
-86
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

59 files changed

+350
-86
lines changed

‎samples/V13/CampaignManagementExampleHelper.php‎

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@
2828
use Microsoft\BingAds\V13\CampaignManagement\AddSharedEntityRequest;
2929
use Microsoft\BingAds\V13\CampaignManagement\AddUetTagsRequest;
3030
use Microsoft\BingAds\V13\CampaignManagement\AppealEditorialRejectionsRequest;
31+
use Microsoft\BingAds\V13\CampaignManagement\ApplyOfflineConversionAdjustmentsRequest;
3132
use Microsoft\BingAds\V13\CampaignManagement\ApplyOfflineConversionsRequest;
3233
use Microsoft\BingAds\V13\CampaignManagement\ApplyProductPartitionActionsRequest;
3334
use Microsoft\BingAds\V13\CampaignManagement\DeleteAdExtensionsRequest;
@@ -379,6 +380,18 @@ static function AppealEditorialRejections(
379380

380381
return $GLOBALS['CampaignManagementProxy']->GetService()->AppealEditorialRejections($request);
381382
}
383+
static function ApplyOfflineConversionAdjustments(
384+
$offlineConversionAdjustments)
385+
{
386+
$GLOBALS['CampaignManagementProxy']->SetAuthorizationData($GLOBALS['AuthorizationData']);
387+
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
388+
389+
$request = new ApplyOfflineConversionAdjustmentsRequest();
390+
391+
$request->OfflineConversionAdjustments = $offlineConversionAdjustments;
392+
393+
return $GLOBALS['CampaignManagementProxy']->GetService()->ApplyOfflineConversionAdjustments($request);
394+
}
382395
static function ApplyOfflineConversions(
383396
$offlineConversions)
384397
{
@@ -1065,7 +1078,8 @@ static function GetImportJobsByIds(
10651078
}
10661079
static function GetImportResults(
10671080
$importType,
1068-
$pageInfo)
1081+
$pageInfo,
1082+
$importJobIds)
10691083
{
10701084
$GLOBALS['CampaignManagementProxy']->SetAuthorizationData($GLOBALS['AuthorizationData']);
10711085
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
@@ -1074,6 +1088,7 @@ static function GetImportResults(
10741088

10751089
$request->ImportType = $importType;
10761090
$request->PageInfo = $pageInfo;
1091+
$request->ImportJobIds = $importJobIds;
10771092

10781093
return $GLOBALS['CampaignManagementProxy']->GetService()->GetImportResults($request);
10791094
}
@@ -4016,6 +4031,7 @@ static function OutputGoogleImportOption($dataObject)
40164031
self::OutputStatusMessage(sprintf("NewPausedCampaignsAndChildEntities: %s", $dataObject->NewPausedCampaignsAndChildEntities));
40174032
self::OutputStatusMessage(sprintf("NewPriceAdExtensions: %s", $dataObject->NewPriceAdExtensions));
40184033
self::OutputStatusMessage(sprintf("NewProductFilters: %s", $dataObject->NewProductFilters));
4034+
self::OutputStatusMessage(sprintf("NewPromotionAdExtensions: %s", $dataObject->NewPromotionAdExtensions));
40194035
self::OutputStatusMessage(sprintf("NewReviewAdExtensions: %s", $dataObject->NewReviewAdExtensions));
40204036
self::OutputStatusMessage(sprintf("NewSitelinkAdExtensions: %s", $dataObject->NewSitelinkAdExtensions));
40214037
self::OutputStatusMessage(sprintf("NewStructuredSnippetAdExtensions: %s", $dataObject->NewStructuredSnippetAdExtensions));
@@ -4059,6 +4075,7 @@ static function OutputGoogleImportOption($dataObject)
40594075
self::OutputStatusMessage(sprintf("UpdatePageFeeds: %s", $dataObject->UpdatePageFeeds));
40604076
self::OutputStatusMessage(sprintf("UpdatePriceAdExtensions: %s", $dataObject->UpdatePriceAdExtensions));
40614077
self::OutputStatusMessage(sprintf("UpdateProductFilters: %s", $dataObject->UpdateProductFilters));
4078+
self::OutputStatusMessage(sprintf("UpdatePromotionAdExtensions: %s", $dataObject->UpdatePromotionAdExtensions));
40624079
self::OutputStatusMessage(sprintf("UpdateReviewAdExtensions: %s", $dataObject->UpdateReviewAdExtensions));
40634080
self::OutputStatusMessage(sprintf("UpdateSitelinkAdExtensions: %s", $dataObject->UpdateSitelinkAdExtensions));
40644081
self::OutputStatusMessage(sprintf("UpdateStatusForAdGroups: %s", $dataObject->UpdateStatusForAdGroups));
@@ -4919,6 +4936,8 @@ static function OutputOfflineConversion($dataObject)
49194936
self::OutputStatusMessage(sprintf("ConversionName: %s", $dataObject->ConversionName));
49204937
self::OutputStatusMessage(sprintf("ConversionTime: %s", $dataObject->ConversionTime));
49214938
self::OutputStatusMessage(sprintf("ConversionValue: %s", $dataObject->ConversionValue));
4939+
self::OutputStatusMessage(sprintf("ExternalAttributionCredit: %s", $dataObject->ExternalAttributionCredit));
4940+
self::OutputStatusMessage(sprintf("ExternalAttributionModel: %s", $dataObject->ExternalAttributionModel));
49224941
self::OutputStatusMessage(sprintf("MicrosoftClickId: %s", $dataObject->MicrosoftClickId));
49234942
self::OutputStatusMessage("* * * End OutputOfflineConversion * * *");
49244943
}
@@ -4934,11 +4953,38 @@ static function OutputArrayOfOfflineConversion($dataObjects)
49344953
self::OutputOfflineConversion($dataObject);
49354954
}
49364955
}
4956+
static function OutputOfflineConversionAdjustment($dataObject)
4957+
{
4958+
if (!empty($dataObject))
4959+
{
4960+
self::OutputStatusMessage("* * * Begin OutputOfflineConversionAdjustment * * *");
4961+
self::OutputStatusMessage(sprintf("AdjustmentCurrencyCode: %s", $dataObject->AdjustmentCurrencyCode));
4962+
self::OutputStatusMessage(sprintf("AdjustmentTime: %s", $dataObject->AdjustmentTime));
4963+
self::OutputStatusMessage(sprintf("AdjustmentType: %s", $dataObject->AdjustmentType));
4964+
self::OutputStatusMessage(sprintf("AdjustmentValue: %s", $dataObject->AdjustmentValue));
4965+
self::OutputStatusMessage(sprintf("ConversionName: %s", $dataObject->ConversionName));
4966+
self::OutputStatusMessage(sprintf("ConversionTime: %s", $dataObject->ConversionTime));
4967+
self::OutputStatusMessage(sprintf("MicrosoftClickId: %s", $dataObject->MicrosoftClickId));
4968+
self::OutputStatusMessage("* * * End OutputOfflineConversionAdjustment * * *");
4969+
}
4970+
}
4971+
static function OutputArrayOfOfflineConversionAdjustment($dataObjects)
4972+
{
4973+
if(count((array)$dataObjects) == 0 || !isset($dataObjects->OfflineConversionAdjustment))
4974+
{
4975+
return;
4976+
}
4977+
foreach ($dataObjects->OfflineConversionAdjustment as $dataObject)
4978+
{
4979+
self::OutputOfflineConversionAdjustment($dataObject);
4980+
}
4981+
}
49374982
static function OutputOfflineConversionGoal($dataObject)
49384983
{
49394984
if (!empty($dataObject))
49404985
{
49414986
self::OutputStatusMessage("* * * Begin OutputOfflineConversionGoal * * *");
4987+
self::OutputStatusMessage(sprintf("IsExternallyAttributed: %s", $dataObject->IsExternallyAttributed));
49424988
self::OutputStatusMessage("* * * End OutputOfflineConversionGoal * * *");
49434989
}
49444990
}

‎samples/V13/CustomerManagementExampleHelper.php‎

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,8 @@ static function SendUserInvitation(
328328
static function SignupCustomer(
329329
$customer,
330330
$account,
331-
$parentCustomerId)
331+
$parentCustomerId,
332+
$userInvitation)
332333
{
333334
$GLOBALS['CustomerManagementProxy']->SetAuthorizationData($GLOBALS['AuthorizationData']);
334335
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
@@ -338,6 +339,7 @@ static function SignupCustomer(
338339
$request->Customer = $customer;
339340
$request->Account = $account;
340341
$request->ParentCustomerId = $parentCustomerId;
342+
$request->UserInvitation = $userInvitation;
341343

342344
return $GLOBALS['CustomerManagementProxy']->GetService()->SignupCustomer($request);
343345
}
@@ -1303,51 +1305,51 @@ static function OutputArrayOfCustomerLifeCycleStatus($valueSets)
13031305
}
13041306
self::OutputStatusMessage("* * * End OutputArrayOfCustomerLifeCycleStatus * * *");
13051307
}
1306-
static function OutputEmailFormat($valueSet)
1308+
static function OutputLCID($valueSet)
13071309
{
1308-
self::OutputStatusMessage("* * * Begin OutputEmailFormat * * *");
1310+
self::OutputStatusMessage("* * * Begin OutputLCID * * *");
13091311
self::OutputStatusMessage(sprintf("Values in %s", $valueSet->type));
13101312
foreach ($valueSet->string as $value)
13111313
{
13121314
self::OutputStatusMessage($value);
13131315
}
1314-
self::OutputStatusMessage("* * * End OutputEmailFormat * * *");
1316+
self::OutputStatusMessage("* * * End OutputLCID * * *");
13151317
}
1316-
static function OutputArrayOfEmailFormat($valueSets)
1318+
static function OutputArrayOfLCID($valueSets)
13171319
{
13181320
if(count((array)$valueSets) == 0)
13191321
{
13201322
return;
13211323
}
1322-
self::OutputStatusMessage("* * * Begin OutputArrayOfEmailFormat * * *");
1323-
foreach ($valueSets->EmailFormat as $valueSet)
1324+
self::OutputStatusMessage("* * * Begin OutputArrayOfLCID * * *");
1325+
foreach ($valueSets->LCID as $valueSet)
13241326
{
1325-
self::OutputEmailFormat($valueSet);
1327+
self::OutputLCID($valueSet);
13261328
}
1327-
self::OutputStatusMessage("* * * End OutputArrayOfEmailFormat * * *");
1329+
self::OutputStatusMessage("* * * End OutputArrayOfLCID * * *");
13281330
}
1329-
static function OutputLCID($valueSet)
1331+
static function OutputEmailFormat($valueSet)
13301332
{
1331-
self::OutputStatusMessage("* * * Begin OutputLCID * * *");
1333+
self::OutputStatusMessage("* * * Begin OutputEmailFormat * * *");
13321334
self::OutputStatusMessage(sprintf("Values in %s", $valueSet->type));
13331335
foreach ($valueSet->string as $value)
13341336
{
13351337
self::OutputStatusMessage($value);
13361338
}
1337-
self::OutputStatusMessage("* * * End OutputLCID * * *");
1339+
self::OutputStatusMessage("* * * End OutputEmailFormat * * *");
13381340
}
1339-
static function OutputArrayOfLCID($valueSets)
1341+
static function OutputArrayOfEmailFormat($valueSets)
13401342
{
13411343
if(count((array)$valueSets) == 0)
13421344
{
13431345
return;
13441346
}
1345-
self::OutputStatusMessage("* * * Begin OutputArrayOfLCID * * *");
1346-
foreach ($valueSets->LCID as $valueSet)
1347+
self::OutputStatusMessage("* * * Begin OutputArrayOfEmailFormat * * *");
1348+
foreach ($valueSets->EmailFormat as $valueSet)
13471349
{
1348-
self::OutputLCID($valueSet);
1350+
self::OutputEmailFormat($valueSet);
13491351
}
1350-
self::OutputStatusMessage("* * * End OutputArrayOfLCID * * *");
1352+
self::OutputStatusMessage("* * * End OutputArrayOfEmailFormat * * *");
13511353
}
13521354
static function OutputSecretQuestion($valueSet)
13531355
{

‎samples/V13/ReportingExampleHelper.php‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1847,6 +1847,7 @@ static function OutputReportRequest($dataObject)
18471847
self::OutputStatusMessage(sprintf("ExcludeReportFooter: %s", $dataObject->ExcludeReportFooter));
18481848
self::OutputStatusMessage(sprintf("ExcludeReportHeader: %s", $dataObject->ExcludeReportHeader));
18491849
self::OutputStatusMessage(sprintf("Format: %s", $dataObject->Format));
1850+
self::OutputStatusMessage(sprintf("FormatVersion: %s", $dataObject->FormatVersion));
18501851
self::OutputStatusMessage(sprintf("ReportName: %s", $dataObject->ReportName));
18511852
self::OutputStatusMessage(sprintf("ReturnOnlyCompleteData: %s", $dataObject->ReturnOnlyCompleteData));
18521853
if($dataObject->Type === "AccountPerformanceReportRequest")

‎src/V13/Bulk/DownloadEntity.php‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -333,7 +333,7 @@ final class DownloadEntity
333333
/** Include Feed Item records in the download data. */
334334
const FeedItems = 'FeedItems';
335335

336-
/** Reserved. */
336+
/** Include Campaign Negative Store Criterion records in the download data. */
337337
const CampaignNegativeStoreCriterions = 'CampaignNegativeStoreCriterions';
338338

339339
/** Include Promotion Ad Extension records in the download data. */
@@ -363,7 +363,7 @@ final class DownloadEntity
363363
/** Include Campaign Negative Combined List Association records in the download that each represent the association relationship between a campaign and a combined list exclusion. */
364364
const CampaignNegativeCombinedListAssociations = 'CampaignNegativeCombinedListAssociations';
365365

366-
/** Reserved. */
366+
/** Include Image records in the download data. */
367367
const Images = 'Images';
368368

369369
/** Include Customer List records in the download data. */

‎src/V13/CampaignManagement/AdExtensionHeaderType.php‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,21 @@ final class AdExtensionHeaderType
2020
/** Reserved. */
2121
const Brands = 'Brands';
2222

23+
/** Reserved. */
24+
const Classes = 'Classes';
25+
2326
/** Reserved. */
2427
const Courses = 'Courses';
2528

29+
/** Reserved. */
30+
const DailyRates = 'DailyRates';
31+
2632
/** Reserved. */
2733
const DegreePrograms = 'DegreePrograms';
2834

35+
/** Reserved. */
36+
const Departments = 'Departments';
37+
2938
/** Reserved. */
3039
const Destinations = 'Destinations';
3140

@@ -35,18 +44,42 @@ final class AdExtensionHeaderType
3544
/** Reserved. */
3645
const Goods = 'Goods';
3746

47+
/** Reserved. */
48+
const Grades = 'Grades';
49+
50+
/** Reserved. */
51+
const Highlights = 'Highlights';
52+
3853
/** Reserved. */
3954
const InsuranceCoverage = 'InsuranceCoverage';
4055

4156
/** Reserved. */
4257
const Items = 'Items';
4358

59+
/** Reserved. */
60+
const Languages = 'Languages';
61+
62+
/** Reserved. */
63+
const Locations = 'Locations';
64+
4465
/** Reserved. */
4566
const Models = 'Models';
4667

4768
/** Reserved. */
4869
const Neighborhoods = 'Neighborhoods';
4970

71+
/** Reserved. */
72+
const Prices = 'Prices';
73+
74+
/** Reserved. */
75+
const Rates = 'Rates';
76+
77+
/** Reserved. */
78+
const Ratings = 'Ratings';
79+
80+
/** Reserved. */
81+
const SchoolDistricts = 'SchoolDistricts';
82+
5083
/** Reserved. */
5184
const Services = 'Services';
5285

@@ -56,11 +89,35 @@ final class AdExtensionHeaderType
5689
/** Reserved. */
5790
const Shows = 'Shows';
5891

92+
/** Reserved. */
93+
const Sizes = 'Sizes';
94+
5995
/** Reserved. */
6096
const Styles = 'Styles';
6197

98+
/** Reserved. */
99+
const Tools = 'Tools';
100+
101+
/** Reserved. */
102+
const Topics = 'Topics';
103+
62104
/** Reserved. */
63105
const Types = 'Types';
106+
107+
/** Reserved. */
108+
const Vacations = 'Vacations';
109+
110+
/** Reserved. */
111+
const Vehicles = 'Vehicles';
112+
113+
/** Reserved. */
114+
const What = 'What';
115+
116+
/** Reserved. */
117+
const Who = 'Who';
118+
119+
/** Reserved. */
120+
const Why = 'Why';
64121
}
65122

66123
}

‎src/V13/CampaignManagement/AdGroup.php‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ final class AdGroup
6767
public $ForwardCompatibilityMap;
6868

6969
/**
70-
* The system generated identifier of the ad group.
70+
* The system-generated identifier of the ad group.
7171
* @var integer
7272
*/
7373
public $Id;

‎src/V13/CampaignManagement/ApplyOfflineConversionAdjustmentsRequest.php‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<?php
2+
3+
namespace Microsoft\BingAds\V13\CampaignManagement;
4+
5+
{
6+
/**
7+
* Applies offline conversion adjustments.
8+
* @link https://docs.microsoft.com/en-us/advertising/campaign-management-service/applyofflineconversionadjustments?view=bingads-13 ApplyOfflineConversionAdjustments Request Object
9+
*
10+
* @uses OfflineConversionAdjustment
11+
* @used-by BingAdsCampaignManagementService::ApplyOfflineConversionAdjustments
12+
*/
13+
final class ApplyOfflineConversionAdjustmentsRequest
14+
{
15+
/**
16+
* The offline conversion adjustments to apply.
17+
* @var OfflineConversionAdjustment[]
18+
*/
19+
public $OfflineConversionAdjustments;
20+
}
21+
}

‎src/V13/CampaignManagement/ApplyOfflineConversionAdjustmentsResponse.php‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<?php
2+
3+
namespace Microsoft\BingAds\V13\CampaignManagement;
4+
5+
{
6+
/**
7+
* Applies offline conversion adjustments.
8+
* @link https://docs.microsoft.com/en-us/advertising/campaign-management-service/applyofflineconversionadjustments?view=bingads-13 ApplyOfflineConversionAdjustments Response Object
9+
*
10+
* @uses BatchError
11+
* @used-by BingAdsCampaignManagementService::ApplyOfflineConversionAdjustments
12+
*/
13+
final class ApplyOfflineConversionAdjustmentsResponse
14+
{
15+
/**
16+
* An array of BatchError objects that contain details for any request items that were not successful.
17+
* @var BatchError[]
18+
*/
19+
public $PartialErrors;
20+
}
21+
}

‎src/V13/CampaignManagement/BMCStoreSubType.php‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
*/
1212
final class BMCStoreSubType
1313
{
14-
/** The Microsoft Merchant Center store supports Cooperative campaigns. */
14+
/** The Microsoft Merchant Center store supports Shopping Campaigns for Brands. */
1515
const CoOp = 'CoOp';
1616
}
1717

‎src/V13/CampaignManagement/BatchError.php‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@
2525
* @used-by AddSharedEntityResponse
2626
* @used-by AddUetTagsResponse
2727
* @used-by AppealEditorialRejectionsResponse
28+
* @used-by ApplyOfflineConversionAdjustmentsResponse
2829
* @used-by ApplyOfflineConversionsResponse
2930
* @used-by ApplyProductPartitionActionsResponse
3031
* @used-by DeleteAdExtensionsResponse

0 commit comments

Comments
 (0)