Home

CityGrid Advertising APIs

Skip to end of metadata
Go to start of metadata

Introduction

The CityGrid Campaign/Adgroup Status API is part of the Advertising API suite and generates a list of reasons why a campaign and/or adgroup is not active. Report information is available in both JSON or XML.

Contents

Endpoint

The operation is invoked via HTTPS GET to:

Request Parameters

Parameter

Description

Required

Type

Default

Example

campaignId

Comma-separated list of campaign IDs. If specified, externalCampaignId must be left empty.

No

Long

 

4352,8473,242

externalCampaignId

Comma-separated list of external IDs of the campaign. If specified, campaignId must be left empty.

No

Long

 

1,2,3,4

Request Header Values

Header

Description

Required

Valid Values

Accept

Requested format for the response

Yes

application/json
application/xml

authToken

Authentication Token from the Authentication API

Yes

Valid token

developerToken

The token received during registration

Yes

Valid token

Request Examples

Example 1: Get the pending campaign and/or adgroup explanation(s) for all campaign owned by the authToken.
Example 2: Get the pending campaign/adgroup explanation for two campaigns

Response Properties

Property

Type

Description

response

Response Metadata

(See complete response descriptions)

totalNumEntries

Integer

Total number of campaigns in the response.

campaignId

String

The campaign ID.

externalCampaignId

String

External ID of the campaign.

campaignName

String

Arbitrary campaign name, not shown in the ads.

status

{ACTIVE, CANCELLED, PENDING}

Status of the campaign in the system:

Active: Campaign is serving ads

Cancelled: User cancelled the campaign

Pending: Campaign is not serving ads. See reasons for an explanation on why its not serving.

adGroupId

String

ID of the ad group.

reasons

String

The reason a campaign or adgroup is not active.

Response Examples

Success Response

The following shows success responses in JSON and XML format.

JSON
XML

Error Response

The following shows error responses (in JSON and XML format) when campaignId are not comma separated numbers.

JSON
XML
  • No labels