Export (0) Print
Expand All

GetTargetsByAdGroupIds REST Template

Gets the target groups that the specified ad groups reference.

/customer/target?$field=adgroupids

Query Parameters

field

The adgroupids value is a constant string that indicates that the POST method is getting target groups from the specified ad groups. The body of the request includes the list of identifiers of the ad groups that reference a target group.

Request Components

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

  • HTTP method: POST

  • Supported content types: XML and JSON

    • To use JSON, your request URL must include the “format=json” query string.

    • For enumeration types, the value in the response is set to a numeric value instead of to the value name defined in the value set. For example, if the age range of the age target is TwentyFiveToThirtyFive, the Age value is set to 1 instead of to TwentyFiveToThirtyFive.

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

    • 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.

Header

Description

ApplicationToken

The application access token. This header is not used.

CustomerAccountId

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

CustomerId

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

DeveloperToken

The developer access token.

Password

The user’s logon password.

UserName

The user’s logon user name.

Request Body

The following XML fragment shows the elements to use to get target groups from the target library that the specified ad groups reference. For a description of each element and the header elements that your request must include, see GetTargetsByAdGroupIdsRequest Message Object.

<GetTargetsByAdGroupIdsRequest xmlns="http://schemas.datacontract.org/2004/07/HostedService.CampaignManagementService.Rest" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AdGroupIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d4p1:long></d4p1:long>
  </AdGroupIds>
</GetTargetsByAdGroupIdsRequest>

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 GetTargetsByAdGroupIdsResponse Message Object.

<GetTargetsByAdGroupIdsResponse xmlns="http://schemas.datacontract.org/2004/07/Microsoft.AdCenter.Advertiser.CampaignManagement.Api.DataContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> 
  <Targets xmlns:d2p1="https://adcenter.microsoft.com/v8">
    <d2p1:Target>
      <d2p1:Age>
        <d2p1:Bid>
          <d2p1:Age></d2p1:Age>
          <d2p1:IncrementalBid></d2p1:IncrementalBid>
        </d2p1:Bid>
      </d2p1:Age>
      <d2p1:Day>
        <d2p1:Bid>
          <d2p1:Day></d2p1:Day>
          <d2p1:IncrementalBid></d2p1:IncrementalBid>
        </d2p1:Bid>
        <d2p1:TargetAllDays></d2p1:TargetAllDays>
      </d2p1:Day>
      <d2p1:Gender>
        <d2p1:Bid>
          <d2p1:Gender></d2p1:Gender>
          <d2p1:IncrementalBid></d2p1:IncrementalBid>
        </d2p1:Bid>
      </d2p1:Gender>
      <d2p1:Hour>
        <d2p1:Bid>
          <d2p1:Hour></d2p1:Hour>
          <d2p1:IncrementalBid></d2p1:IncrementalBid>
        </d2p1:Bid>
        <d2p1:TargetAllHours></d2p1:TargetAllHours>
      <d2p1:Id></d2p1:Id>
      <d2p1:IsLibraryTarget></d2p1:IsLibraryTarget>
      <d2p1:Location>
        <d2p1:BusinessTarget>
          <d2p1:Bids>
            <d2p1:BusinessId></d2p1:BusinessId>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
            <d2p1:Radius></d2p1:Radius>
          </d2p1:Bids>
        </d2p1:BusinessTarget>
        <d2p1:CityTarget>
          <d2p1:Bids>
            <d2p1:City></d2p1:City>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
          </d2p1:Bids>
        </d2p1:CityTarget>
        <d2p1:CountryTarget>
          <d2p1:Bids>
            <d2p1:CountryAndRegion></d2p1:CountryAndRegion>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
          </d2p1:Bids>
        </d2p1:CountryTarget>
        <d2p1:HasPhysicalIntent></d2p1:HasPhysicalIntent>
        <d2p1:MetroAreaTarget>
          <d2p1:Bids>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
            <d2p1:MetroArea></d2p1:MetroArea>
          </d2p1:Bids>
        </d2p1:MetroAreaTarget>
        <d2p1:RadiusTarget>
          <d2p1:Bids>
            <d2p1:Id></d2p1:Id>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
            <d2p1:LatitudeDegrees></d2p1:LatitudeDegrees>
            <d2p1:LongitudeDegrees></d2p1:LongitudeDegrees>
            <d2p1:Name></d2p1:Name>
            <d2p1:Radius></d2p1:Radius>
          </d2p1:Bids>
        </d2p1:RadiusTarget>
        <d2p1:StateTarget>
          <d2p1:Bids>
            <d2p1:IncrementalBid></d2p1:IncrementalBid>
            <d2p1:State></d2p1:State>
          </d2p1:Bids>
        </d2p1:StateTarget>
        <d2p1:TargetAllLocations></d2p1:TargetAllLocations>
      </d2p1:Location>
      <d2p1:Name></d2p1:Name>
    </d2p1:Target>
  </Targets>
</GetTargetsByAdGroupIdsResponse>

Faults

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

Code

Description

400

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.

401

Not authorized.

404

Not found.

405

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

500

Server error.

Community Additions

Show:
© 2014 Microsoft