CampaignRemainingBudgetResponse

idintegerrequired

The campaign id.

nameAny Of

The campaign name.

Variant 1string

statusAny Of

The campaign status.

Variant 1string

campaignTypeAny Of

The campaign type.

Variant 1string

startDateAny Of

The campaign start date.

Variant 1string

endDateAny Of

The campaign end date.

Variant 1string

budgetAmountAny Of

The campaign budget amount.

Variant 1number

budgetTypeAny Of

The campaign budget type.

Variant 1string

pacingTypeAny Of

The campaign pacing type.

Variant 1string

accountIdintegerrequired

The account id.

advertiserIdsarray[integer]required

The advertiser ids.

billingInsertionOrderAny Of

The billing insertion order.

Variant 1string

billingPurchaseOrderAny Of

The billing purchase order.

Variant 1string

billingAdditionalDetailsAny Of

The billing additional details.

Default:

Variant 1string

billingContactIdAny Of

The billing contact id.

Variant 1integer

billingAddressIdAny Of

The billing address id.

Variant 1integer

adGroupsAny Of

The ad groups.

AdGrouparray[object]

Show Child Parameters

isArchivedAny Of

The campaign is archived.

Variant 1boolean

goalsarray[object]

Goals data associated with the campaign.

Show Child Parameters

Example

namestringrequired

The campaign name.

statusAny Of

The status of the campaign. Can not be changed at the same time as endDate. To cancel a scheduled campaign, set the status to PAUSE and set the end date to match the start date.

CampaignStatusstring

Allowed values:DRAFTSCHEDULEDACTIVEENDEDPAUSED

startDateAny Of

The start date of the campaign. Can only be changed when status is DRAFT. Can not be changed at the same time as status. Format: YYYY-MM-DD

Variant 1string

Match pattern:\d{4}-\d{2}-\d{2}

endDateAny Of

The end date of the campaign. Must be after start date. A live campaign can be stopped by setting end date to today’s date. If null the campaign is considered “always-on”. Cannot be null if budget type is LIFETIME

Default:

Variant 1string

Match pattern:\d{4}-\d{2}-\d{2}

budgetAmountnumberrequired

The total budget of the campaign. The sum of all the budgets from the ad group(s) may not exceed this number.

>= 1

budgetTypeAny Of

The type of budget. Can only be changed when status is DRAFT.

BudgetTypestring

Allowed values:DAILYWEEKLYMONTHLYLIFETIME

pacingTypestringrequired

Allowed values:EVENASAPAHEAD

billingInsertionOrderAny Of

Insertion order number for this campaign. Can only be changed when status is DRAFT.

Variant 1string

billingPurchaseOrderAny Of

Purchase order number for this campaign. Can only be changed when status is DRAFT.

Variant 1string

billingAdditionalDetailsAny Of

Notes that the advertiser wants to notify the billing department.

Variant 1string

goalsarray[object]

Goals to be updated.

Show Child Parameters

Example

remainingBudgetAmountstringrequired

The budget amount remaining for the campaign.

Match pattern:^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$

Example

namestringrequired

The campaign name.

statusstringrequired

Allowed values:DRAFTSCHEDULEDACTIVEENDEDPAUSED

startDatestringrequired

The start date of the campaign. Format: YYYY-MM-DD

Match pattern:\d{4}-\d{2}-\d{2}

endDateAny Of

The end date of the campaign. Must be after start date. If null the campaign is considered “always-on”. Cannot be null if budget type is LIFETIME

Default:

Variant 1string

Match pattern:\d{4}-\d{2}-\d{2}

budgetAmountnumberrequired

The total budget of the campaign. The sum of all the budgets from the ad group(s) may not exceed this number.

>= 1

budgetTypestringrequired

Allowed values:DAILYWEEKLYMONTHLYLIFETIME

pacingTypestringrequired

Allowed values:EVENASAPAHEAD

accountIdintegerrequired

Id from the Account entity.

advertiserIdsarray[integer]required

Ids from the Advertiser entities associated with the account.

billingInsertionOrderAny Of

Insertion order number for this campaign.

Variant 1string

billingPurchaseOrderAny Of

Purchase order number for this campaign.

Variant 1string

billingAdditionalDetailsAny Of

Notes that the advertiser wants to notify the billing department.

Variant 1string

billingContactIdintegerrequired

Id from the Contact entity associated with the account.

billingAddressIdintegerrequired

Id from the Address entity associated with the account.

campaignTypeAny Of

Type for this campaign.

Default:PLA

CampaignTypestring

Allowed values:PLATOACAROUSEL

goalsarray[object]

Goals data associated with the campaign.

Show Child Parameters

Example

Allowed values:DRAFTSCHEDULEDACTIVEENDEDPAUSED

Campaign

CampaignPutRequest

CampaignRequest

CampaignStatus