Export (0) Print
Expand All

SubmitGenerateReport Service Operation

Submits a report request.

Request | Response

Error Codes

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

SubmitGenerateReportRequest Message

Request Body

The SubmitGenerateReportRequest object defines the elements of the request’s body. The elements must be in the same order as shown in the SOAP example.

Element

Description

Data Type

ReportRequest

The report request. The request must be an object that derives from ReportRequest. For a list of report request types, see Report Types.

ReportRequest-derived object

Request Header

For information about the values you set the DeveloperToken, Password, and UserName elements to, see Getting Started With the Bing Ads API.

Element

Description

Data Type

ApplicationToken

The application-access token. This header element is not used and should be null.

string

AuthenticationToken

The OAuth access token used to manage Bing Ads accounts linked to a Microsoft Account. For more information, see Managing User Authentication with OAuth.

string

CustomerAccountId

The identifier of the account that owns the entities in the request.

string

CustomerId

The identifier of the customer that owns the account.

string

DeveloperToken

The client application's developer access token.

string

Password

The Bing Ads user's sign-in password.

string

UserName

The Bing Ads user's sign-in user name. You may not set this element to a Microsoft account.

string

Request SOAP

The following example shows the complete request envelope.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Reporting/v9">
    <Action mustUnderstand="1">SubmitGenerateReport</Action>
    <ApplicationToken i:nil="false"></ApplicationToken>
    <AuthenticationToken i:nil="false"></AuthenticationToken>
    <CustomerAccountId i:nil="false"></CustomerAccountId>
    <CustomerId i:nil="false"></CustomerId>
    <DeveloperToken i:nil="false"></DeveloperToken>
    <Password i:nil="false"></Password>
    <UserName i:nil="false"></UserName>
  </s:Header>
  <s:Body>
    <SubmitGenerateReportRequest xmlns="https://bingads.microsoft.com/Reporting/v9">
      <ReportRequest i:nil="false" i:type="-- specify derived type here with the appropriate prefix --">
        <Format i:nil="false"></Format>
        <Language i:nil="false"></Language>
        <ReportName i:nil="false"></ReportName>
        <ReturnOnlyCompleteData i:nil="false"></ReturnOnlyCompleteData>
        <!--Keep these fields if you set the i:type attribute to AdGroupPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AdGroupPerformanceReportColumn></AdGroupPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
          <Status i:nil="false"></Status>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AdPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AdPerformanceReportColumn></AdPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <AdType i:nil="false"></AdType>
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to KeywordPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <KeywordPerformanceReportColumn></KeywordPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <AdType i:nil="false"></AdType>
          <BidMatchType i:nil="false"></BidMatchType>
          <DeliveredMatchType i:nil="false"></DeliveredMatchType>
          <DeviceType i:nil="false"></DeviceType>
          <KeywordRelevance i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:int></a1:int>
          </KeywordRelevance>
          <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </Keywords>
          <LandingPageRelevance i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:int></a1:int>
          </LandingPageRelevance>
          <LandingPageUserExperience i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:int></a1:int>
          </LandingPageUserExperience>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
          <QualityScore i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:int></a1:int>
          </QualityScore>
        </Filter>
        <MaxRows></MaxRows>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Sort i:nil="false">
          <KeywordPerformanceReportSort>
            <SortColumn></SortColumn>
            <SortOrder></SortOrder>
          </KeywordPerformanceReportSort>
        </Sort>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to DestinationUrlPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <DestinationUrlPerformanceReportColumn></DestinationUrlPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to BudgetSummaryReportRequest-->
        <Columns i:nil="false">
          <BudgetSummaryReportColumn></BudgetSummaryReportColumn>
        </Columns>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AgeGenderDemographicReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AgeGenderDemographicReportColumn></AgeGenderDemographicReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AdDynamicTextPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AdDynamicTextPerformanceReportColumn></AdDynamicTextPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <AdType i:nil="false"></AdType>
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to PublisherUsagePerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <PublisherUsagePerformanceReportColumn></PublisherUsagePerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
          <PricingModel i:nil="false"></PricingModel>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to SitePerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <SitePerformanceReportColumn></SitePerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <AdType i:nil="false"></AdType>
          <DeliveredMatchType i:nil="false"></DeliveredMatchType>
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
          <SiteIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </SiteIds>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to SearchQueryPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <SearchQueryPerformanceReportColumn></SearchQueryPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdStatus i:nil="false"></AdStatus>
          <AdType i:nil="false"></AdType>
          <CampaignStatus i:nil="false"></CampaignStatus>
          <DeliveredMatchType i:nil="false"></DeliveredMatchType>
          <ExcludeZeroClicks i:nil="false"></ExcludeZeroClicks>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
          <SearchQueries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </SearchQueries>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to ConversionPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <ConversionPerformanceReportColumn></ConversionPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <DeviceType i:nil="false"></DeviceType>
          <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </Keywords>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to GoalsAndFunnelsReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <GoalsAndFunnelsReportColumn></GoalsAndFunnelsReportColumn>
        </Columns>
        <Filter i:nil="false">
          <GoalIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </GoalIds>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to TrafficSourcesReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <TrafficSourcesReportColumn></TrafficSourcesReportColumn>
        </Columns>
        <Filter i:nil="false">
          <GoalIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </GoalIds>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to TacticChannelReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <TacticChannelReportColumn></TacticChannelReportColumn>
        </Columns>
        <Filter i:nil="false">
          <ChannelIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </ChannelIds>
          <TacticIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </TacticIds>
          <ThirdPartyAdGroupIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </ThirdPartyAdGroupIds>
          <ThirdPartyCampaignIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </ThirdPartyCampaignIds>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to NegativeKeywordConflictReportRequest-->
        <Columns i:nil="false">
          <NegativeKeywordConflictReportColumn></NegativeKeywordConflictReportColumn>
        </Columns>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <!--Keep these fields if you set the i:type attribute to SearchCampaignChangeHistoryReportRequest-->
        <Columns i:nil="false">
          <SearchCampaignChangeHistoryReportColumn></SearchCampaignChangeHistoryReportColumn>
        </Columns>
        <Filter i:nil="false">
          <HowChanged i:nil="false"></HowChanged>
          <ItemChanged i:nil="false"></ItemChanged>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AdExtensionByAdReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AdExtensionByAdReportColumn></AdExtensionByAdReportColumn>
        </Columns>
        <Filter i:nil="false">
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AdExtensionByKeywordReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AdExtensionByKeywordReportColumn></AdExtensionByKeywordReportColumn>
        </Columns>
        <Filter i:nil="false">
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to GeographicalLocationReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <GeographicalLocationReportColumn></GeographicalLocationReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <CountryCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </CountryCode>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to ShareOfVoiceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <ShareOfVoiceReportColumn></ShareOfVoiceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <BidMatchType i:nil="false"></BidMatchType>
          <DeliveredMatchType i:nil="false"></DeliveredMatchType>
          <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </Keywords>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to ProductTargetPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <ProductTargetPerformanceReportColumn></ProductTargetPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <DeviceType i:nil="false"></DeviceType>
          <LanguageCode i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:string></a1:string>
          </LanguageCode>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to CallDetailReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <CallDetailReportColumn></CallDetailReportColumn>
        </Columns>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <AdGroups i:nil="false">
            <AdGroupReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
              <AdGroupId></AdGroupId>
            </AdGroupReportScope>
          </AdGroups>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AccountPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <AccountPerformanceReportColumn></AccountPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to CampaignPerformanceReportRequest-->
        <Aggregation></Aggregation>
        <Columns i:nil="false">
          <CampaignPerformanceReportColumn></CampaignPerformanceReportColumn>
        </Columns>
        <Filter i:nil="false">
          <AdDistribution i:nil="false"></AdDistribution>
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
          <Status i:nil="false"></Status>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
          <Campaigns i:nil="false">
            <CampaignReportScope>
              <AccountId></AccountId>
              <CampaignId></CampaignId>
            </CampaignReportScope>
          </Campaigns>
        </Scope>
        <Time i:nil="false">
          <CustomDateRangeEnd i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeEnd>
          <CustomDateRangeStart i:nil="false">
            <Day></Day>
            <Month></Month>
            <Year></Year>
          </CustomDateRangeStart>
          <PredefinedTime i:nil="false"></PredefinedTime>
        </Time>
        <!--Keep these fields if you set the i:type attribute to AdExtensionDimensionReportRequest-->
        <Columns i:nil="false">
          <AdExtensionDimensionReportColumn></AdExtensionDimensionReportColumn>
        </Columns>
        <Filter i:nil="false">
          <DeviceOS i:nil="false"></DeviceOS>
          <DeviceType i:nil="false"></DeviceType>
        </Filter>
        <Scope i:nil="false">
          <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a1:long></a1:long>
          </AccountIds>
        </Scope>
      </ReportRequest>
    </SubmitGenerateReportRequest>
  </s:Body>
</s:Envelope>

SubmitGenerateReportResponse Message

Response Body

Element

Description

Data Type

ReportRequestId

The identifier of the report request. Use this identifier when calling the PollGenerateReport operation to determine the status of the report request. Once returned, the identifier is valid for two days.

string

Response Header

Element

Description

Data Type

TrackingId

The identifier of the log entry that contains the details of the API call.

string

Response SOAP

The following example shows the complete response envelope.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Reporting/v9">
    <TrackingId p4:nil="false" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance"></TrackingId>
  </s:Header>
  <s:Body>
    <SubmitGenerateReportResponse xmlns="https://bingads.microsoft.com/Reporting/v9">
      <ReportRequestId p4:nil="false" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance"></ReportRequestId>
    </SubmitGenerateReportResponse>
  </s:Body>
</s:Envelope>

Error Codes

If the service operation fails, it throws a FaultException exception, which contains one or more of the Bing Ads API error data objects. For information about the fault detail objects, see Reporting Error Data Objects and Handling Service Errors and Exceptions.

The following are example error codes that the error objects can include when using this service operation. For all documented error codes, please see Bing Ads Operation Error Codes.

Error Code

ReportingServiceNullReportRequest

ReportingServiceUnknownReportType

ReportingServiceAccountNotAuthorized

ReportingServiceNoCompleteDataAvaliable

ReportingServiceInvalidDataAvailabilityAndTimePeriodCombination

ReportingServiceInvalidReportName

ReportingServiceInvalidReportAggregation

ReportingServiceInvalidReportTimeSelection

ReportingServiceInvalidCustomDateRangeStart

ReportingServiceInvalidCustomDateRangeEnd

ReportingServiceEndDateBeforeStartDate

ReportingServiceEmptyCustomDates

ReportingServiceCustomDatesOverlimit

ReportingServiceNullColumns

ReportingServiceRequiredColumnsNotSelected

ReportingServiceDuplicateColumns

ReportingServiceNoMeasureSelected

ReportingServiceInvalidAccountIdInCampaignReportScope

ReportingServiceInvalidCampaignIdInCampaignReportScope

ReportingServiceInvalidAccountIdInAdGroupReportScope

ReportingServiceInvalidCampaignIdInAdGroupReportScope

ReportingServiceInvalidAdGroupIdInAdGroupReportScope

ReportingServiceInvalidAccountIdInAccountReportScope

ReportingServiceNullCampaignReportScope

ReportingServiceNullAdGroupReportScope

ReportingServiceInvalidAccountReportScope

ReportingServiceInvalidAccountThruCampaignReportScope

ReportingServiceInvalidAccountThruAdGroupReportScope

ReportingServiceAccountsOverLimit

ReportingServiceMaximumCampaignsLimitReached

ReportingServiceAdGroupsOverLimit

ReportingServiceCrossSiteScriptNotAllowed

ReportingServiceInvalidKeywordFilterValue

ReportingServiceInvalidTimePeriodColumnForSummaryReport

ReportingServiceInvalidAccountIds

ReportingServiceSiteIdMaxArraySizeReached

ReportingServiceInvalidSiteIdValue

ReportingServiceInvalidCustomDateRange

ReportingServiceInvalidFutureStartDate

ReportingServiceInvalidSearchQueryFilterValue

ReportingServiceSearchQueryFilterValueLengthExceeded

ReportingServiceSearchQueryOverLimit

ReportingServiceKeywordFilterValueLengthExceeded

ReportingServiceKeywordOverLimit

ReportingServiceGoalIdMaxArraySizeReached

ReportingServiceTacticIdMaxArraySizeReached

ReportingServiceChannelIdMaxArraySizeReached

ReportingServiceThirdPartyCampaignIdMaxArraySizeReached

ReportingServiceThirdPartyAdGroupIdMaxArraySizeReached

ReportingServiceInvalidGrainForQualityScoreColumns

ReportingServiceInvalidGrainForImpressionShareColumns

ReportingServiceInvalidGrainForHistoricQualityScoreColumns

ReportingServiceFilterValueBatchSizeOverLimit

ReportingServiceFilterValueOverLimit

UnsuportedTimeGrain

InvalidFilterOrScopeValue

Community Additions

ADD
Show:
© 2014 Microsoft