ReportTime Data Object - Reporting

Defines the date range values of a report request.

Syntax

<xs:complexType name="ReportTime" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomDateRangeEnd" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="CustomDateRangeStart" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="PredefinedTime" nillable="true" type="tns:ReportTimePeriod" />
    <xs:element minOccurs="0" name="ReportTimeZone" nillable="true" type="tns:ReportTimeZone" />
  </xs:sequence>
</xs:complexType>

Elements

The ReportTime object has the following elements: CustomDateRangeEnd, CustomDateRangeStart, PredefinedTime, ReportTimeZone.

Element Description Data Type
CustomDateRangeEnd The end date of the custom date range. The end date cannot be later than today's date. Date
CustomDateRangeStart The start date of the custom date range. The start date must be earlier than or the same as the end date. Date
PredefinedTime A predefined date range value. Each report request type specifies the predefined time periods that you can specify for each aggregation type. ReportTimePeriod
ReportTimeZone Determines the time zone that is used to establish today's date.

When you submit the report request today's date can vary around the world depending on the time zone. The report time period that you choose e.g., 'Yesterday' is then relative to today's date.

If you do not choose a time zone, the Reporting service uses PacificTimeUSCanadaTijuana by default. For example, a report requested without a time zone specified at 2 AM EasternTimeUSCanada on 2/2/2019 for 'Yesterday' will be interpreted as a request for 1/31/2019. A report requested at the same time for 'Yesterday' with time zone set as EasternTimeUSCanada will be interpreted as a request for 2/1/2019.
ReportTimeZone

Requirements

Service: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

Used By

AccountPerformanceReportRequest
AdDynamicTextPerformanceReportRequest
AdExtensionByAdReportRequest
AdExtensionByKeywordReportRequest
AdExtensionDetailReportRequest
AdGroupPerformanceReportRequest
AdPerformanceReportRequest
AgeGenderAudienceReportRequest
AssetGroupPerformanceReportRequest
AssetPerformanceReportRequest
AudiencePerformanceReportRequest
BudgetSummaryReportRequest
CallDetailReportRequest
CampaignPerformanceReportRequest
CategoryClickCoverageReportRequest
CategoryInsightsReportRequest
ConversionPerformanceReportRequest
DestinationUrlPerformanceReportRequest
DSAAutoTargetPerformanceReportRequest
DSACategoryPerformanceReportRequest
DSASearchQueryPerformanceReportRequest
GeographicPerformanceReportRequest
GoalsAndFunnelsReportRequest
HotelDimensionPerformanceReportRequest
HotelGroupPerformanceReportRequest
KeywordPerformanceReportRequest
ProductDimensionPerformanceReportRequest
ProductMatchCountReportRequest
ProductPartitionPerformanceReportRequest
ProductPartitionUnitPerformanceReportRequest
ProductSearchQueryPerformanceReportRequest
ProfessionalDemographicsAudienceReportRequest
PublisherUsagePerformanceReportRequest
SearchCampaignChangeHistoryReportRequest
SearchInsightPerformanceReportRequest
SearchQueryPerformanceReportRequest
ShareOfVoiceReportRequest
UserLocationPerformanceReportRequest