Export (0) Print
Expand All

GetAdsByEditorialStatus REST Template

Gets ads with the specified review status from the specified ad group.




The identifier of the ad group that contains the ads to retrieve.

Query Parameters


The editorialstatus value is a constant string that indicates that the body of the request includes the editorial status of the ads that you want to get.

Request Components

The following specifies the HTTP method, supported content types, and base URI to use in your request.

  • HTTP method: Get

  • Supported content types: XML and JSON

    To use JSON, the following apply:.

    • Your request URL must include the “format=json” query string.

    • For enumeration types, you must use numeric values instead of the value name defined in the value set. For example, to specify the Disapproved value defined in the AdEditorialStatus value set, set the EditorialStatus element of the request to 1 instead of to Disapproved.

    • All enumerations are zero-based, and increment by 1.

    • The response will also contain numeric values for enumeration types.

    • The key names that you use for the JSON members are the same as the elements of the XML objects shown in the examples below.

  • Production base URI: https://adcenterapi.microsoft.com/Api/Advertiser/v8/CampaignManagement/CampaignManagementServiceREST.svc

  • Sandbox base URI: Not available.

Request Headers

The following are the headers to include in your request.




The application access token. This header is not used.


The account identifier. For more information, see Account and Customer Identifiers.


The customer identifier. For more information, see Account and Customer Identifiers.


The developer access token.


The user’s logon password.


The user’s logon user name.

Request Body

The following XML fragment shows the elements to use to get ads with the specified review status from an ad group. For a description of each element and the header elements that your request must include, see GetAdsByEditorialStatusRequest Message Object.

<GetAdsByEditorialStatusRequest xmlns="http://schemas.datacontract.org/2004/07/HostedService.CampaignManagementService.Rest" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> 

Response Body

The following XML fragment shows the elements that are included in the response. For a description of each element and the TrackingId header element that the response includes, see GetAdsByEditorialStatusResponse Message Object.

<GetAdsByEditorialStatusResponse xmlns="http://schemas.datacontract.org/2004/07/Microsoft.AdCenter.Advertiser.CampaignManagement.Api.DataContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ads xmlns:d2p1="https://adcenter.microsoft.com/v8">
    <d2p1:Ad i:type="TextAd">


If an error occurs, the service returns one of the following HTTP error codes.




Bad request, which indicates that the request data contains an error. The response will contain either an ApiFaultDetail or AdApiFaultDetail object that identifies the error. For a list of possible error codes, see Campaign Management Error Codes and Common Error Codes.


Not authorized.


Not found.


Method not allowed, which indicates that the URI template is not correct.


Server error.

Community Additions

© 2014 Microsoft