AdWords API

AdWords API
Feedback on this document

type AlertQuery (v201306)

Service
AlertService
Dependencies
AlertSelector
▼
AlertQuery

Querying criteria for getting alerts.

Namespace
https://adwords.google.com/api/adwords/mcm/v201306
Fields
Field Type Description
clientSpec
Required
 ClientSpec Specifies what clients to get alerts for. This field is required and should not be null.
Enumerations
ALL
All clients recursively managed by the manager.
DIRECT
Clients managed just by the manager and not through any sub-managers.
ID_LIST
Client accounts as specified in the AlertQuery.clientCustomerIds.
UNKNOWN
filterSpec
Required
 FilterSpec Specifies whether/how to filter the result set based on whether the customer can manage. This field is required and should not be null.
Enumerations
ALL
Return alerts for all customers.
ONLY_SUBMANAGERS
Only return alerts from client managers.
ONLY_LEAF_CLIENTS
Only return alerts from non-manager AdWords accounts.
UNKNOWN
types
ContentsNotNull
 AlertType[] The specific types of Alerts to return. This field must not contain null elements.
Enumerations
ACCOUNT_ON_TARGET
The account budget has either been mostly or completely used.
DECLINED_PAYMENT
A payment was declined.
CREDIT_CARD_EXPIRING
The credit card on file is expiring.
ACCOUNT_BUDGET_ENDING
The end date on the account budget is approaching or has occurred.
CAMPAIGN_ENDING
A campaign's end date is approaching.
PAYMENT_NOT_ENTERED
The account does not yet have a payment method set up.
MISSING_BANK_REFERENCE_NUMBER
The account's payment method lacks a bank reference number.
CAMPAIGN_ENDED
A campaign's end date is approaching.
ACCOUNT_BUDGET_BURN_RATE
The account's prepay bank transfer balance is low.
USER_INVITE_PENDING
Confirmation of a user invitation is pending.
USER_INVITE_ACCEPTED
A user invitation has been accepted.
MANAGER_LINK_PENDING
A client manager invitation is pending.
ZERO_DAILY_SPENDING_LIMIT
This account has stopped serving due to a miscellaneous error.
TV_ACCOUNT_ON_TARGET
The TV account budget has either been mostly or completely used.
TV_ACCOUNT_BUDGET_ENDING
The end date on the TV account budget is approaching or has occurred.
TV_ZERO_DAILY_SPENDING_LIMIT
This TV account has stopped serving due to a miscellaneous error.
UNKNOWN
severities
ContentsNotNull
 AlertSeverity[] This field must not contain null elements.
Enumerations
GREEN
Green alerts are purely informational. The serving of ads isn't affected.
YELLOW
Yellow alerts include problems that cause some ads from being served, or may eventually cause all ads of an account not to be served.
RED
Red alerts indicate ads have stopped being served for an entire account.
UNKNOWN
triggerTimeSpec
Required
 TriggerTimeSpec Specifies what time interval for which to get alerts. This field is required and should not be null.
Enumerations
ALL_TIME
Get alerts triggered at any time.
CUSTOM_TIME
Get alerts triggered since AlertQuery.triggerTime.
LAST_24_HOURS
Get alerts triggered within the last 24 hours.
LAST_7_DAYS
Get alerts triggered within the last 7 days.
triggerTime xsd:string If TriggerTimeSpec.CUSTOM_TIME is specified, only alerts generated after this time will be returned. String Format: yyyymmdd hhmmss zzz (e.g. 20100609 150223 UTC).
clientCustomerIds
ContentsDistinct
 xsd:long[] If ClientSpec.ID_LIST is specified, only alerts for the client accounts specified here will be returned. This field must contain distinct elements.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.