From 4f6d6779f185ab7e6cfbfb571ebc406887392107 Mon Sep 17 00:00:00 2001 From: Eric Urban Date: Wed, 9 Jan 2019 11:37:04 -0800 Subject: [PATCH 1/2] update proxies and inline comments --- .../V12/CampaignManagementExampleHelper.php | 18 ++++---- src/V12/AdInsight/AuctionInsightResult.php | 2 +- src/V12/AdInsight/DomainCategory.php | 2 +- src/V12/AdInsight/GetKeywordIdeasRequest.php | 2 +- .../GetKeywordTrafficEstimatesRequest.php | 2 +- .../GetKeywordTrafficEstimatesResponse.php | 2 +- src/V12/AdInsight/KeywordAndConfidence.php | 2 +- src/V12/AdInsight/KeywordCategory.php | 2 +- src/V12/Bulk/DataScope.php | 6 +-- src/V12/Bulk/DownloadEntity.php | 42 +++++++++++++++++-- src/V12/CampaignManagement/AdGroup.php | 4 +- .../AdGroupPrivacyStatus.php | 2 +- src/V12/CampaignManagement/AdRotationType.php | 4 +- src/V12/CampaignManagement/ImageAsset.php | 12 +++--- .../InheritFromParentBiddingScheme.php | 2 +- src/V12/CampaignManagement/PriceQualifier.php | 6 +-- src/V12/CampaignManagement/PriceTableRow.php | 2 +- src/V12/CampaignManagement/PriceUnit.php | 12 +++--- src/V12/CampaignManagement/ProductScope.php | 2 +- src/V12/CampaignManagement/ResponsiveAd.php | 10 ++--- .../SearchClientLinksRequest.php | 2 +- .../SearchClientLinksResponse.php | 2 +- .../DSAAutoTargetPerformanceReportColumn.php | 2 +- .../DSASearchQueryPerformanceReportFilter.php | 2 +- src/V12/Reporting/ReportFormat.php | 6 +-- ...earchCampaignChangeHistoryReportColumn.php | 2 +- 26 files changed, 94 insertions(+), 58 deletions(-) diff --git a/samples/V12/CampaignManagementExampleHelper.php b/samples/V12/CampaignManagementExampleHelper.php index 08ee3ee2..15715261 100644 --- a/samples/V12/CampaignManagementExampleHelper.php +++ b/samples/V12/CampaignManagementExampleHelper.php @@ -1604,19 +1604,19 @@ static function OutputAd($dataObject) self::OutputStatusMessage(sprintf("TrackingUrlTemplate: %s", $dataObject->TrackingUrlTemplate)); self::OutputStatusMessage(sprintf("Type: %s", $dataObject->Type)); self::OutputCustomParameters($dataObject->UrlCustomParameters); - if($dataObject->Type === "AppInstallAd") + if($dataObject->Type === "AppInstall") { self::OutputAppInstallAd($dataObject); } - if($dataObject->Type === "DynamicSearchAd") + if($dataObject->Type === "DynamicSearch") { self::OutputDynamicSearchAd($dataObject); } - if($dataObject->Type === "ExpandedTextAd") + if($dataObject->Type === "ExpandedText") { self::OutputExpandedTextAd($dataObject); } - if($dataObject->Type === "ProductAd") + if($dataObject->Type === "Product") { self::OutputProductAd($dataObject); } @@ -1624,11 +1624,11 @@ static function OutputAd($dataObject) { self::OutputResponsiveAd($dataObject); } - if($dataObject->Type === "ResponsiveSearchAd") + if($dataObject->Type === "ResponsiveSearch") { self::OutputResponsiveSearchAd($dataObject); } - if($dataObject->Type === "TextAd") + if($dataObject->Type === "Text") { self::OutputTextAd($dataObject); } @@ -2331,15 +2331,15 @@ static function OutputAudience($dataObject) self::OutputStatusMessage(sprintf("SearchSize: %s", $dataObject->SearchSize)); self::OutputArrayOfString($dataObject->SupportedCampaignTypes); self::OutputStatusMessage(sprintf("Type: %s", $dataObject->Type)); - if($dataObject->Type === "CustomAudience") + if($dataObject->Type === "Custom") { self::OutputCustomAudience($dataObject); } - if($dataObject->Type === "InMarketAudience") + if($dataObject->Type === "InMarket") { self::OutputInMarketAudience($dataObject); } - if($dataObject->Type === "ProductAudience") + if($dataObject->Type === "Product") { self::OutputProductAudience($dataObject); } diff --git a/src/V12/AdInsight/AuctionInsightResult.php b/src/V12/AdInsight/AuctionInsightResult.php index 588d6523..926e9124 100644 --- a/src/V12/AdInsight/AuctionInsightResult.php +++ b/src/V12/AdInsight/AuctionInsightResult.php @@ -20,7 +20,7 @@ final class AuctionInsightResult public $Segments; /** - * One or more auction insight entries i. + * One or more auction insight entries i.e., one result per domain that you competed with in the auction. * @var AuctionInsightEntry[] */ public $Entries; diff --git a/src/V12/AdInsight/DomainCategory.php b/src/V12/AdInsight/DomainCategory.php index f8fd0d7b..9ab18b6b 100644 --- a/src/V12/AdInsight/DomainCategory.php +++ b/src/V12/AdInsight/DomainCategory.php @@ -24,7 +24,7 @@ final class DomainCategory public $CategoryName; /** - * A score from 0. + * A score from 0.0 to 1.0 that indicates the percentage of pages in the requested language that belong to a particular domain out of all the pages that Bing has indexed for the same language your website's domain. * @var double */ public $Coverage; diff --git a/src/V12/AdInsight/GetKeywordIdeasRequest.php b/src/V12/AdInsight/GetKeywordIdeasRequest.php index 96c82a2f..51e390bc 100644 --- a/src/V12/AdInsight/GetKeywordIdeasRequest.php +++ b/src/V12/AdInsight/GetKeywordIdeasRequest.php @@ -20,7 +20,7 @@ final class GetKeywordIdeasRequest public $ExpandIdeas; /** - * The keyword idea attributes that you want included in the response e. + * The keyword idea attributes that you want included in the response e.g., Keyword, Competition, MonthlySearchCounts, and SuggestedBid. * @var KeywordIdeaAttribute[] */ public $IdeaAttributes; diff --git a/src/V12/AdInsight/GetKeywordTrafficEstimatesRequest.php b/src/V12/AdInsight/GetKeywordTrafficEstimatesRequest.php index ca02bfe7..47a3f320 100644 --- a/src/V12/AdInsight/GetKeywordTrafficEstimatesRequest.php +++ b/src/V12/AdInsight/GetKeywordTrafficEstimatesRequest.php @@ -4,7 +4,7 @@ { /** - * Provides traffic estimates for keywords e. + * Provides traffic estimates for keywords e.g., average CPC, average position, clicks, CTR, impressions, and total cost. * @link https://docs.microsoft.com/en-us/bingads/ad-insight-service/getkeywordtrafficestimates?view=bingads-12 GetKeywordTrafficEstimates Request Object * * @uses CampaignEstimator diff --git a/src/V12/AdInsight/GetKeywordTrafficEstimatesResponse.php b/src/V12/AdInsight/GetKeywordTrafficEstimatesResponse.php index 0dbdd265..ef66b31c 100644 --- a/src/V12/AdInsight/GetKeywordTrafficEstimatesResponse.php +++ b/src/V12/AdInsight/GetKeywordTrafficEstimatesResponse.php @@ -4,7 +4,7 @@ { /** - * Provides traffic estimates for keywords e. + * Provides traffic estimates for keywords e.g., average CPC, average position, clicks, CTR, impressions, and total cost. * @link https://docs.microsoft.com/en-us/bingads/ad-insight-service/getkeywordtrafficestimates?view=bingads-12 GetKeywordTrafficEstimates Response Object * * @uses CampaignEstimate diff --git a/src/V12/AdInsight/KeywordAndConfidence.php b/src/V12/AdInsight/KeywordAndConfidence.php index 74be1816..80c96a0c 100644 --- a/src/V12/AdInsight/KeywordAndConfidence.php +++ b/src/V12/AdInsight/KeywordAndConfidence.php @@ -19,7 +19,7 @@ final class KeywordAndConfidence public $SuggestedKeyword; /** - * A score from 0. + * A score from 0.0 to 1.0 that indicates the probability that the keyword would match a user's search query. * @var double */ public $ConfidenceScore; diff --git a/src/V12/AdInsight/KeywordCategory.php b/src/V12/AdInsight/KeywordCategory.php index 52a43884..d5dafc84 100644 --- a/src/V12/AdInsight/KeywordCategory.php +++ b/src/V12/AdInsight/KeywordCategory.php @@ -18,7 +18,7 @@ final class KeywordCategory public $Category; /** - * A score from 0. + * A score from 0.0 to 1.0 that indicates the likelihood that the keyword belongs to the category. * @var double */ public $ConfidenceScore; diff --git a/src/V12/Bulk/DataScope.php b/src/V12/Bulk/DataScope.php index 89a66e66..4e49d10f 100644 --- a/src/V12/Bulk/DataScope.php +++ b/src/V12/Bulk/DataScope.php @@ -12,16 +12,16 @@ */ final class DataScope { - /** Download the entity attributes records. */ + /** Download entity records e.g., campaigns and ad groups. */ const EntityData = 'EntityData'; /** This value is not supported in Bing Ads API Version 12, and will be removed in a future version. */ const EntityPerformanceData = 'EntityPerformanceData'; - /** Download the quality score fields for the corresponding entity records. */ + /** Download the quality score fields i.e., Quality Score, Keyword Relevance, Landing Page Relevance, and Landing Page User Experience in the Ad Group, Campaign, and Keyword records. */ const QualityScoreData = 'QualityScoreData'; - /** Download the bid suggestions records. */ + /** Download the keyword bid suggestion records. */ const BidSuggestionsData = 'BidSuggestionsData'; } diff --git a/src/V12/Bulk/DownloadEntity.php b/src/V12/Bulk/DownloadEntity.php index f1076147..c1b1e82d 100644 --- a/src/V12/Bulk/DownloadEntity.php +++ b/src/V12/Bulk/DownloadEntity.php @@ -210,13 +210,13 @@ final class DownloadEntity /** Include Ad Group Negative In Market Audience Association records in the download that each represent the association relationship between an ad group and an in-market audience exclusion. */ const AdGroupNegativeInMarketAudienceAssociations = 'AdGroupNegativeInMarketAudienceAssociations'; - /** Include Custom Audience, In Market Audience, Product Audience, and Remarketing List records in the download data. */ + /** Include Custom Audience, In Market Audience, Product Audience, Remarketing List, and Similar Remarketing List records in the download data. */ const Audiences = 'Audiences'; - /** Include Ad Group Custom Audience Association, Ad Group In Market Audience Association, Ad Group Product Audience Association, and Ad Group Remarketing List Association records in the download data. */ + /** Include Ad Group Custom Audience Association, Ad Group In Market Audience Association, Ad Group Product Audience Association, Ad Group Remarketing List Association, and Ad Group Similar Remarketing List Association records in the download data. */ const AdGroupAudienceAssociations = 'AdGroupAudienceAssociations'; - /** Include Ad Group Negative Custom Audience Association, Ad Group Negative In Market Audience Association, Ad Group Negative Product Audience Association, and Ad Group Negative Remarketing List Association records in the download data. */ + /** Include Ad Group Negative Custom Audience Association, Ad Group Negative In Market Audience Association, Ad Group Negative Product Audience Association, Ad Group Negative Remarketing List Association, and Ad Group Negative Similar Remarketing List Association records in the download data. */ const AdGroupNegativeAudienceAssociations = 'AdGroupNegativeAudienceAssociations'; /** Include Product Ad Label records in the download that each represent a label applied to a product ad. */ @@ -302,6 +302,42 @@ final class DownloadEntity /** Include Responsive Search Ad Label records in the download that each represent a label applied to a responsive search ad. */ const ResponsiveSearchAdLabels = 'ResponsiveSearchAdLabels'; + + /** Include Campaign Custom Audience Association, Campaign In Market Audience Association, Campaign Product Audience Association, Campaign Remarketing List Association, and Campaign Similar Remarketing List Association records in the download data. */ + const CampaignAudienceAssociations = 'CampaignAudienceAssociations'; + + /** Include Campaign Negative Custom Audience Association, Campaign Negative In Market Audience Association, Campaign Negative Product Audience Association, Campaign Negative Remarketing List Association, and Campaign Negative Similar Remarketing List Association records in the download data. */ + const CampaignNegativeAudienceAssociations = 'CampaignNegativeAudienceAssociations'; + + /** Include Campaign Custom Audience Association records in the download that each represent the association relationship between a campaign and a custom audience. */ + const CampaignCustomAudienceAssociations = 'CampaignCustomAudienceAssociations'; + + /** Include Campaign Negative Custom Audience Association records in the download that each represent the association relationship between a campaign and a custom audience exclusion. */ + const CampaignNegativeCustomAudienceAssociations = 'CampaignNegativeCustomAudienceAssociations'; + + /** Include Campaign In Market Audience Association records in the download that each represent the association relationship between a campaign and an in-market audience. */ + const CampaignInMarketAudienceAssociations = 'CampaignInMarketAudienceAssociations'; + + /** Include Campaign Negative In Market Audience Association records in the download that each represent the association relationship between a campaign and an in-market audience exclusion. */ + const CampaignNegativeInMarketAudienceAssociations = 'CampaignNegativeInMarketAudienceAssociations'; + + /** Include Campaign Product Audience Association records in the download that each represent the association relationship between a campaign and a product audience. */ + const CampaignProductAudienceAssociations = 'CampaignProductAudienceAssociations'; + + /** Include Campaign Negative Product Audience Association records in the download that each represent the association relationship between a campaign and a product audience exclusion. */ + const CampaignNegativeProductAudienceAssociations = 'CampaignNegativeProductAudienceAssociations'; + + /** Include Campaign Remarketing List Association records in the download that each represent the association relationship between a campaign and a remarketing list. */ + const CampaignRemarketingListAssociations = 'CampaignRemarketingListAssociations'; + + /** Include Campaign Negative Remarketing List Association records in the download that each represent the association relationship between a campaign and a remarketing list exclusion. */ + const CampaignNegativeRemarketingListAssociations = 'CampaignNegativeRemarketingListAssociations'; + + /** Include Campaign Similar Remarketing List Association records in the download that each represent the association relationship between a campaign and a similar remarketing list. */ + const CampaignSimilarRemarketingListAssociations = 'CampaignSimilarRemarketingListAssociations'; + + /** Include Campaign Negative Similar Remarketing List Association records in the download that each represent the association relationship between a campaign and a similar remarketing list exclusion. */ + const CampaignNegativeSimilarRemarketingListAssociations = 'CampaignNegativeSimilarRemarketingListAssociations'; } } diff --git a/src/V12/CampaignManagement/AdGroup.php b/src/V12/CampaignManagement/AdGroup.php index fab3e5ad..46a70483 100644 --- a/src/V12/CampaignManagement/AdGroup.php +++ b/src/V12/CampaignManagement/AdGroup.php @@ -25,7 +25,7 @@ final class AdGroup { /** - * Determines how often you'd like the ads in your ad group to show in relation to one another. + * Ad rotation sets how often Bing Ads selects which ads to serve, if you have multiple ads within an ad group. * @var AdRotation */ public $AdRotation; @@ -85,7 +85,7 @@ final class AdGroup public $Network; /** - * Indicates whether or not your ad group target criteria e. + * Indicates whether or not your ad group target criteria e.g., ProfileCriterion are too narrow for ad groups in Audience campaigns. * @var AdGroupPrivacyStatus */ public $PrivacyStatus; diff --git a/src/V12/CampaignManagement/AdGroupPrivacyStatus.php b/src/V12/CampaignManagement/AdGroupPrivacyStatus.php index 9c55fc83..ab380145 100644 --- a/src/V12/CampaignManagement/AdGroupPrivacyStatus.php +++ b/src/V12/CampaignManagement/AdGroupPrivacyStatus.php @@ -17,7 +17,7 @@ final class AdGroupPrivacyStatus /** The ad group is eligible to serve. */ const Active = 'Active'; - /** The ad group is not eligible to serve because your ad group target criteria e. */ + /** The ad group is not eligible to serve because your ad group target criteria e.g., ProfileCriterion are too narrowly defined. */ const TargetingTooNarrow = 'TargetingTooNarrow'; /** The privacy evaluation is still in progress, and the ad group is not yet eligible to serve. */ diff --git a/src/V12/CampaignManagement/AdRotationType.php b/src/V12/CampaignManagement/AdRotationType.php index f3933c70..f9c532c9 100644 --- a/src/V12/CampaignManagement/AdRotationType.php +++ b/src/V12/CampaignManagement/AdRotationType.php @@ -11,10 +11,10 @@ */ final class AdRotationType { - /** Favor the best performing ads. */ + /** Bing Ads prioritizes the ad from the ad group that appears to have the best chance of performing well, based on auction characteristics or factors, such as keyword, search term, device or location. */ const OptimizeForClicks = 'OptimizeForClicks'; - /** Rotate ads evenly into the auction. */ + /** Bing Ads provides more balance in rotation between your ads. */ const RotateAdsEvenly = 'RotateAdsEvenly'; } diff --git a/src/V12/CampaignManagement/ImageAsset.php b/src/V12/CampaignManagement/ImageAsset.php index 88b1b151..bc90d54d 100644 --- a/src/V12/CampaignManagement/ImageAsset.php +++ b/src/V12/CampaignManagement/ImageAsset.php @@ -4,37 +4,37 @@ { /** - * Reserved. + * Applies crop settings to stored image media for a specific aspect ratio. * @link https://docs.microsoft.com/en-us/bingads/campaign-management-service/imageasset?view=bingads-12 ImageAsset Data Object */ final class ImageAsset extends Asset { /** - * Reserved. + * The number of pixels to use from the image asset source, starting from the CropY position and moving upwards. * @var integer */ public $CropHeight; /** - * Reserved. + * The number of pixels to use from the image asset source, starting from the CropX position and moving to the right. * @var integer */ public $CropWidth; /** - * Reserved. + * Starting from the lower left corner of image asset source, this is the number of pixels to skip to the right on the x-axis before applying the CropWidth. * @var integer */ public $CropX; /** - * Reserved. + * Starting from the lower left corner of image asset source, this is the number of pixels to skip upwards on the y-axis before applying the CropHeight. * @var integer */ public $CropY; /** - * Reserved. + * Represents the aspect ratio for this image asset. * @var string */ public $SubType; diff --git a/src/V12/CampaignManagement/InheritFromParentBiddingScheme.php b/src/V12/CampaignManagement/InheritFromParentBiddingScheme.php index 87d2dba7..0cd018a9 100644 --- a/src/V12/CampaignManagement/InheritFromParentBiddingScheme.php +++ b/src/V12/CampaignManagement/InheritFromParentBiddingScheme.php @@ -10,7 +10,7 @@ final class InheritFromParentBiddingScheme extends BiddingScheme { /** - * The type of bidding scheme (a. + * The type of bidding scheme (a.k.a. * @var string */ public $InheritedBidStrategyType; diff --git a/src/V12/CampaignManagement/PriceQualifier.php b/src/V12/CampaignManagement/PriceQualifier.php index 1eb50ac9..67438d93 100644 --- a/src/V12/CampaignManagement/PriceQualifier.php +++ b/src/V12/CampaignManagement/PriceQualifier.php @@ -14,16 +14,16 @@ final class PriceQualifier /** Reserved for forward compatibility. */ const Unknown = 'Unknown'; - /** The price of the PriceAdExtension is prefixed with price qualifier text From, for example From $9. */ + /** The price of the PriceAdExtension is prefixed with price qualifier text From, for example From $9.99. */ const From = 'From'; - /** The price of the PriceAdExtension is prefixed with the price qualifier text Up to, for example Up to $9. */ + /** The price of the PriceAdExtension is prefixed with the price qualifier text Up to, for example Up to $9.99. */ const UpTo = 'UpTo'; /** The price of the PriceAdExtension is not prefixed with price qualifier text. */ const None = 'None'; - /** The price of the PriceAdExtension is prefixed with price qualifier text Average, for example Average $9. */ + /** The price of the PriceAdExtension is prefixed with price qualifier text Average, for example Average $9.99. */ const Average = 'Average'; } diff --git a/src/V12/CampaignManagement/PriceTableRow.php b/src/V12/CampaignManagement/PriceTableRow.php index 75ff42ba..44f297e5 100644 --- a/src/V12/CampaignManagement/PriceTableRow.php +++ b/src/V12/CampaignManagement/PriceTableRow.php @@ -50,7 +50,7 @@ final class PriceTableRow public $Price; /** - * The price qualifier for a given product or service e. + * The price qualifier for a given product or service e.g., starting from a specific price and up to a maximum price. * @var PriceQualifier */ public $PriceQualifier; diff --git a/src/V12/CampaignManagement/PriceUnit.php b/src/V12/CampaignManagement/PriceUnit.php index eca596cb..4c6bd210 100644 --- a/src/V12/CampaignManagement/PriceUnit.php +++ b/src/V12/CampaignManagement/PriceUnit.php @@ -14,25 +14,25 @@ final class PriceUnit /** Reserved for forward compatibility. */ const Unknown = 'Unknown'; - /** The Per Hour price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Hour price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Hour. */ const PerHour = 'PerHour'; - /** The Per Day price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Day price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Day. */ const PerDay = 'PerDay'; - /** The Per Week price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Week price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Week. */ const PerWeek = 'PerWeek'; - /** The Per Month price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Month price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Month. */ const PerMonth = 'PerMonth'; - /** The Per Year price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Year price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Year. */ const PerYear = 'PerYear'; /** The price of the PriceAdExtension will not be appended with price unit text. */ const None = 'None'; - /** The Per Night price unit text will be appended to the price of the PriceAdExtension, for example $9. */ + /** The Per Night price unit text will be appended to the price of the PriceAdExtension, for example $9.99 Per Night. */ const PerNight = 'PerNight'; } diff --git a/src/V12/CampaignManagement/ProductScope.php b/src/V12/CampaignManagement/ProductScope.php index 976a2e35..62cf8ab3 100644 --- a/src/V12/CampaignManagement/ProductScope.php +++ b/src/V12/CampaignManagement/ProductScope.php @@ -12,7 +12,7 @@ final class ProductScope extends Criterion { /** - * A list of up to product conditions that helps determine whether a product from the Bing Merchant Center store gets served as an ad. + * A list of up to 7 product conditions that helps determine whether a product from the Bing Merchant Center store gets served as an ad. * @var ProductCondition[] */ public $Conditions; diff --git a/src/V12/CampaignManagement/ResponsiveAd.php b/src/V12/CampaignManagement/ResponsiveAd.php index a4c73e44..72e34017 100644 --- a/src/V12/CampaignManagement/ResponsiveAd.php +++ b/src/V12/CampaignManagement/ResponsiveAd.php @@ -31,19 +31,19 @@ final class ResponsiveAd extends Ad public $Headline; /** - * Reserved. + * Because audience ads are responsive, you can create multiple image assets with different sizes and aspect ratios so they can flexibly display across a variety of publishers and placements. * @var AssetLink[] */ public $Images; /** - * This is the identifier of the media corresponding to one of two possible aspect ratios for images that could appear in your audience ads. + * The identifier of the image asset used for landscape images with 1.91:1 aspect ratio that could appear in your audience ads. * @var integer */ public $LandscapeImageMediaId; /** - * This is the identifier of the media corresponding to one of two possible aspect ratios for logos that could appear in your audience ads. + * This element is reserved for internal use, and will be removed from a future version of the Bing Ads API. * @var integer */ public $LandscapeLogoMediaId; @@ -55,13 +55,13 @@ final class ResponsiveAd extends Ad public $LongHeadline; /** - * This is one of two possible aspect ratios for images that could appear in your audience ads. + * The identifier of the image asset used for square images with 1:1 aspect ratio that could appear in your audience ads. * @var integer */ public $SquareImageMediaId; /** - * This is one of two possible aspect ratios for logos that could appear in your audience ads. + * This element is reserved for internal use, and will be removed from a future version of the Bing Ads API. * @var integer */ public $SquareLogoMediaId; diff --git a/src/V12/CustomerManagement/SearchClientLinksRequest.php b/src/V12/CustomerManagement/SearchClientLinksRequest.php index 960816e5..5f98a4fd 100644 --- a/src/V12/CustomerManagement/SearchClientLinksRequest.php +++ b/src/V12/CustomerManagement/SearchClientLinksRequest.php @@ -4,7 +4,7 @@ { /** - * This feature is not supported in sandbox. + * This feature is not supported in sandbox.Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. * @link https://docs.microsoft.com/en-us/bingads/customer-management-service/searchclientlinks?view=bingads-12 SearchClientLinks Request Object * * @uses Predicate diff --git a/src/V12/CustomerManagement/SearchClientLinksResponse.php b/src/V12/CustomerManagement/SearchClientLinksResponse.php index 422a1c35..35fe67e4 100644 --- a/src/V12/CustomerManagement/SearchClientLinksResponse.php +++ b/src/V12/CustomerManagement/SearchClientLinksResponse.php @@ -4,7 +4,7 @@ { /** - * This feature is not supported in sandbox. + * This feature is not supported in sandbox.Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. * @link https://docs.microsoft.com/en-us/bingads/customer-management-service/searchclientlinks?view=bingads-12 SearchClientLinks Response Object * * @uses ClientLink diff --git a/src/V12/Reporting/DSAAutoTargetPerformanceReportColumn.php b/src/V12/Reporting/DSAAutoTargetPerformanceReportColumn.php index d194ad7a..e52b5dd8 100644 --- a/src/V12/Reporting/DSAAutoTargetPerformanceReportColumn.php +++ b/src/V12/Reporting/DSAAutoTargetPerformanceReportColumn.php @@ -80,7 +80,7 @@ final class DSAAutoTargetPerformanceReportColumn /** The current status of the dynamic ad target. */ const DynamicAdTargetStatus = 'DynamicAdTargetStatus'; - /** A score from 0. */ + /** A score from 0.0 to 1.0 that indicates the percentage of pages in the requested language that belong to a particular domain out of all the pages that Bing has indexed for the same language your website's domain. */ const WebsiteCoverage = 'WebsiteCoverage'; /** The number of times an ad has been displayed on search results pages. */ diff --git a/src/V12/Reporting/DSASearchQueryPerformanceReportFilter.php b/src/V12/Reporting/DSASearchQueryPerformanceReportFilter.php index 61cdb852..1de275a6 100644 --- a/src/V12/Reporting/DSASearchQueryPerformanceReportFilter.php +++ b/src/V12/Reporting/DSASearchQueryPerformanceReportFilter.php @@ -46,7 +46,7 @@ final class DSASearchQueryPerformanceReportFilter public $ExcludeZeroClicks; /** - * Reserved. + * The feed URL will appear either as "True" or "False". * @var boolean */ public $FeedUrl; diff --git a/src/V12/Reporting/ReportFormat.php b/src/V12/Reporting/ReportFormat.php index 9ca55210..d4c2c8e2 100644 --- a/src/V12/Reporting/ReportFormat.php +++ b/src/V12/Reporting/ReportFormat.php @@ -11,13 +11,13 @@ */ final class ReportFormat { - /** The report format will be comma-separated values (. */ + /** The report format will be comma-separated values (.csv). */ const Csv = 'Csv'; - /** The report format will be tab-separated values (. */ + /** The report format will be tab-separated values (.tsv). */ const Tsv = 'Tsv'; - /** The report format will be XML (. */ + /** The report format will be XML (.xml). */ const Xml = 'Xml'; } diff --git a/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php b/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php index 71e05b5b..0bafdc25 100644 --- a/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php +++ b/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php @@ -38,7 +38,7 @@ final class SearchCampaignChangeHistoryReportColumn /** The Bing Ads assigned identifier of an ad group. */ const AdGroupId = 'AdGroupId'; - /** The ad title parts. */ + /** The ad title parts.This column will be empty if ItemChanged is not Ad. */ const AdTitle = 'AdTitle'; /** The first ad description that appears below the path in your ad. */ From 2fe8bf44af4c8ac9ee04156652ff7c553922a8f8 Mon Sep 17 00:00:00 2001 From: Eric Urban Date: Wed, 9 Jan 2019 11:45:00 -0800 Subject: [PATCH 2/2] update proxies and inline comments --- src/V12/CustomerManagement/SearchClientLinksRequest.php | 2 +- src/V12/CustomerManagement/SearchClientLinksResponse.php | 2 +- src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/V12/CustomerManagement/SearchClientLinksRequest.php b/src/V12/CustomerManagement/SearchClientLinksRequest.php index 5f98a4fd..6dc8d7d4 100644 --- a/src/V12/CustomerManagement/SearchClientLinksRequest.php +++ b/src/V12/CustomerManagement/SearchClientLinksRequest.php @@ -4,7 +4,7 @@ { /** - * This feature is not supported in sandbox.Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. + * Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. * @link https://docs.microsoft.com/en-us/bingads/customer-management-service/searchclientlinks?view=bingads-12 SearchClientLinks Request Object * * @uses Predicate diff --git a/src/V12/CustomerManagement/SearchClientLinksResponse.php b/src/V12/CustomerManagement/SearchClientLinksResponse.php index 35fe67e4..5c65515b 100644 --- a/src/V12/CustomerManagement/SearchClientLinksResponse.php +++ b/src/V12/CustomerManagement/SearchClientLinksResponse.php @@ -4,7 +4,7 @@ { /** - * This feature is not supported in sandbox.Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. + * Searches for the client links for the customer of the current authenticated user, filtered by the search criteria. * @link https://docs.microsoft.com/en-us/bingads/customer-management-service/searchclientlinks?view=bingads-12 SearchClientLinks Response Object * * @uses ClientLink diff --git a/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php b/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php index 0bafdc25..71e05b5b 100644 --- a/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php +++ b/src/V12/Reporting/SearchCampaignChangeHistoryReportColumn.php @@ -38,7 +38,7 @@ final class SearchCampaignChangeHistoryReportColumn /** The Bing Ads assigned identifier of an ad group. */ const AdGroupId = 'AdGroupId'; - /** The ad title parts.This column will be empty if ItemChanged is not Ad. */ + /** The ad title parts. */ const AdTitle = 'AdTitle'; /** The first ad description that appears below the path in your ad. */