AdWords API

AdWords API
Feedback on this document

ReportDefinitionService (v201302)

Note: As of v201109 this service is read-only. New report definitions are no longer allowed.

A report definition describes the report type, date range, and fields to include in the report. Additionally, you can specify predicates to filter which rows are returned in a generated report. Please note that sorting and paging are not supported for report downloads.

To find out which report fields are available based on report type, see the Report Types appendix or call getReportFields.

For more information about retrieving reports, see Reporting Basics.

Production WSDL
https://adwords.google.com/api/adwords/cm/v201302/ReportDefinitionService?wsdl
Namespace
https://adwords.google.com/api/adwords/cm/v201302
Operations
Errors

getReportFields

Returns the available report fields for a given report type.

Parameters

Field Type Description
reportType ReportDefinition.ReportType The type of report.
Enumerations
KEYWORDS_PERFORMANCE_REPORT
Reports performance data for your keywords.
AD_PERFORMANCE_REPORT
Reports performance data for your ads.
URL_PERFORMANCE_REPORT
Reports performance data for URLs which triggered your ad and received clicks.
ADGROUP_PERFORMANCE_REPORT
Reports ad group performance data for one or more of your campaigns.
CAMPAIGN_PERFORMANCE_REPORT
Reports performance data for your campaigns.
ACCOUNT_PERFORMANCE_REPORT
Reports performance data for your entire account.
GEO_PERFORMANCE_REPORT
Reports performance data by geographic origin.
SEARCH_QUERY_PERFORMANCE_REPORT
Reports performance data for search queries which triggered your ad and received clicks.
AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT
Reports performance data for automatic placements on the content network.
CAMPAIGN_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT
Reports performance data for negative keywords at the campaign level.
CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT
Reports performance data for the negative placements at the campaign level.
AD_EXTENSIONS_PERFORMANCE_REPORT
Report performance data for ad extensions.
DESTINATION_URL_REPORT
Reports performance data for destination urls.
SHARED_SET_REPORT
Reports data for shared sets. This is a beta feature.
CAMPAIGN_SHARED_SET_REPORT
Reports data for campaign shared sets. This is a beta feature.
SHARED_SET_CRITERIA_REPORT
Provides a downloadable snapshot of shared set criteria. This is a beta feature.
CREATIVE_CONVERSION_REPORT
Reports performance data for creative conversions (e.g. free clicks).
CALL_METRICS_CALL_DETAILS_REPORT
Reports per-phone-call details for calls tracked using call metrics. This is a beta feature.
KEYWORDLESS_QUERY_REPORT
Reports performance data for keywordless ads. This is a beta feature.
KEYWORDLESS_CATEGORY_REPORT
Reports performance data for keywordless ads. This is a beta feature.
ACCOUNT_REACH_FREQUENCY_REPORT
Account reach and frequency performance report.
CAMPAIGN_REACH_FREQUENCY_REPORT
Campaign reach and frequency performance report.
ADGROUP_REACH_FREQUENCY_REPORT
AdGroup reach and frequency performance report.
CRITERIA_PERFORMANCE_REPORT
Reports performance data for all published criteria types including keywords, placements, topics, user-lists in a single report.
CLICK_PERFORMANCE_REPORT
Reports performance data for clicks.
BUDGET_PERFORMANCE_REPORT
Reports performance data for budgets.
DISPLAY_KEYWORD_PERFORMANCE_REPORT
Reports performance data for your display keywords.
PLACEHOLDER_FEED_ITEM_REPORT
Reports performance data for your placeholder feed items
PLACEMENT_PERFORMANCE_REPORT
Reports performance data for your placements.
CAMPAIGN_NEGATIVE_LOCATIONS_REPORT
Reports performance data for negative location targets at campaign level.
AUDIENCE_PERFORMANCE_REPORT
Reports performance data for your audience criteria.
DISPLAY_TOPICS_PERFORMANCE_REPORT
Reports performance data for your topic criteria.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.

Response

Field Type Description
rval ReportDefinitionField[] The list of available report fields. Each ReportDefinitionField encapsulates the field name, the field data type, and the enum values (if the field's type is enum).

Errors

Error Reasons
AuthenticationError Errors returned when Authentication failed.
Enumerations
AUTHENTICATION_FAILED
Authentication of the request failed.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Client Customer Id is required if CustomerIdMode is set to CLIENT_EXTERNAL_CUSTOMER_ID.
CLIENT_EMAIL_REQUIRED
Client Email is required if CustomerIdMode is set to CLIENT_EXTERNAL_EMAIL_FIELD.
CLIENT_CUSTOMER_ID_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_INVALID
Client customer Id is not a number.
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
Client email is not a valid customer email.
CUSTOMER_NOT_FOUND
No customer found for the customer id provided in the header.
GOOGLE_ACCOUNT_DELETED
Client's Google Account is deleted.
GOOGLE_ACCOUNT_COOKIE_INVALID
Google account login token in the cookie is invalid.
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
problem occurred during Google account authentication.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH
The user in the google account login token does not match the UserId in the cookie.
LOGIN_COOKIE_REQUIRED
Login cookie is required for authentication.
NOT_ADS_USER
User in the cookie is not a valid Ads user.
OAUTH_TOKEN_INVALID
Oauth token in the header is not valid.
OAUTH_TOKEN_EXPIRED
Oauth token in the header has expired.
OAUTH_TOKEN_DISABLED
Oauth token in the header has been disabled.
OAUTH_TOKEN_REVOKED
Oauth token in the header has been revoked.
OAUTH_TOKEN_HEADER_INVALID
Oauth token HTTP header is malformed.
LOGIN_COOKIE_INVALID
Login cookie is not valid.
FAILED_TO_RETRIEVE_LOGIN_COOKIE
Failed to decrypt the login cookie.
USER_ID_INVALID
User Id in the header is not a valid id.
AuthorizationError Errors encountered when trying to authorize a user.
Enumerations
UNABLE_TO_AUTHORIZE
Could not complete authorization due to an internal problem.
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
Customer has no AdWords account.
USER_PERMISSION_DENIED
User doesn't have permission to access customer.
EFFECTIVE_USER_PERMISSION_DENIED
Effective user doesn't have permission to access this customer.
USER_HAS_READONLY_PERMISSION
User has read-only permission cannot mutate.
NO_CUSTOMER_FOUND
No customer found.
SERVICE_ACCESS_DENIED
Developer doesn't have permission to access service.
BetaError Errors that are thrown when a Beta feature is accessed incorrectly.
Enumerations
BETA_FEATURE
Attempt to use beta feature by non-beta account.
ClientTermsError Error due to user not accepting the AdWords terms of service.
Enumerations
INCOMPLETE_SIGNUP_CURRENT_ADWORDS_TNC_NOT_AGREED
Customer has not agreed to the latest AdWords Terms & Conditions
CollectionSizeError Errors associated with the size of the given collection being out of bounds.
Enumerations
TOO_FEW
TOO_MANY
DatabaseError Errors that are thrown due to a database access problem.
Enumerations
CONCURRENT_MODIFICATION
A concurrency problem occurred as two threads were attempting to modify same object.
PERMISSION_DENIED
The permission was denied to access an object.
CAMPAIGN_PRODUCT_NOT_SUPPORTED
Requested campaign belongs to a product that is not supported by the api.
DUPLICATE_KEY
a duplicate key was detected upon insertion
DATABASE_ERROR
a database error has occurred
UNKNOWN
an unknown error has occurred
DateError Errors associated with invalid dates and date ranges.
Enumerations
INVALID_FIELD_VALUES_IN_DATE
Given field values do not correspond to a valid date.
INVALID_FIELD_VALUES_IN_DATE_TIME
Given field values do not correspond to a valid date time.
INVALID_STRING_DATE
The string date's format should be yyyymmdd.
INVALID_STRING_DATE_RANGE
The string date range's format should be yyyymmdd yyyymmdd.
INVALID_STRING_DATE_TIME
The string date time's format should be yyyymmdd hhmmss [tz].
EARLIER_THAN_MINIMUM_DATE
Date is before allowed minimum.
LATER_THAN_MAXIMUM_DATE
Date is after allowed maximum.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE
Date range bounds are not in order.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL
Both dates in range are null.
DistinctError Errors related to distinct ids or content.
Enumerations
DUPLICATE_ELEMENT
DUPLICATE_TYPE
IdError Errors associated with the ids.
Enumerations
NOT_FOUND
Id not found
InternalApiError Indicates that a server-side error has occured. InternalApiErrors are generally not the result of an invalid request or message sent by the client.
Enumerations
UNEXPECTED_INTERNAL_API_ERROR
API encountered an unexpected internal error.
UNKNOWN
The cause of the error is not known or only defined in newer versions.
DOWNTIME
The API is currently unavailable for a planned downtime.
NotEmptyError Errors corresponding with violation of a NOT EMPTY check.
Enumerations
EMPTY_LIST
NotWhitelistedError Indicates that the customer is not whitelisted for accessing the API.
Enumerations
CUSTOMER_NOT_WHITELISTED_FOR_API
Customer is not whitelisted for accessing the API.
NullError Errors associated with violation of a NOT NULL check.
Enumerations
NULL_CONTENT
Specified list/container must not contain any null elements
OperatorError Errors due to the use of unsupported operations.
Enumerations
OPERATOR_NOT_SUPPORTED
QuotaCheckError Encapsulates the errors thrown during developer quota checks.
Enumerations
INVALID_TOKEN_HEADER
Customer passed in an invalid token in the header.
ACCOUNT_DELINQUENT
Customer is marked delinquent.
ACCOUNT_INACCESSIBLE
Customer is a fraudulent.
ACCOUNT_INACTIVE
Inactive Account.
INCOMPLETE_SIGNUP
Signup not complete
INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
Latest AdWords API T&C not agreed.
INCOMPLETE_SIGNUP_NO_BILLING_INFO
No Billing Info.
INCOMPLETE_SIGNUP_USER_INFO_MISSING
User Info missing.
INCOMPLETE_SIGNUP_USER_INFO_PENDING
User Info pending.
INCOMPLETE_SIGNUP_USER_INFO_REJECTED
User Info rejected.
MONTHLY_BUDGET_REACHED
Monthly budget quota reached.
QUOTA_EXCEEDED
Monthly budget quota exceeded.
RangeError A list of all errors associated with the Range constraint.
Enumerations
TOO_LOW
TOO_HIGH
RateExceededError Signals that a call failed because a measured rate exceeded.
Enumerations
RATE_EXCEEDED
Rate exceeded.
ReadOnlyError Errors from attempting to write to read-only fields.
Enumerations
READ_ONLY
RejectedError Indicates that a field was rejected due to compatibility issues.
Enumerations
UNKNOWN_VALUE
Unknown value encountered
ReportDefinitionError Encapsulates the errors that can be thrown during ReportDefinition mutate operation.
Enumerations
INVALID_DATE_RANGE_FOR_REPORT
Customer passed in invalid date range for a report type.
INVALID_FIELD_NAME_FOR_REPORT
Customer passed in invalid field name for a report type
UNABLE_TO_FIND_MAPPING_FOR_THIS_REPORT
Unable to locate a field mapping for this report type.
INVALID_COLUMN_NAME_FOR_REPORT
Customer passed in invalid column name for a report type
INVALID_REPORT_DEFINITION_ID
Customer passed in invalid report definition id.
REPORT_SELECTOR_CANNOT_BE_NULL
Report selector cannot be null.
NO_ENUMS_FOR_THIS_COLUMN_NAME
No Enums exist for this column name.
INVALID_VIEW
Invalid view name.
SORTING_NOT_SUPPORTED
Sorting is not supported for reports.
PAGING_NOT_SUPPORTED
Paging is not supported for reports.
CUSTOMER_SERVING_TYPE_REPORT_MISMATCH
Customer can not create report of a selected type.
CLIENT_SELECTOR_NO_CUSTOMER_IDENTIFIER
Cross client report has an client selector without any valid identifier for a customer.
CLIENT_SELECTOR_INVALID_CUSTOMER_ID
Cross client report has an invalid external customer ID in the client selector.
REPORT_DEFINITION_ERROR
RequestError Encapsulates the generic errors thrown when there's an error with user request.
Enumerations
UNKNOWN
Error reason is unknown.
INVALID_INPUT
Invalid input.
RequiredError Errors due to missing required field.
Enumerations
REQUIRED
Missing required field.
SizeLimitError Indicates that the number of entries in the request or response exceeds the system limit.
Enumerations
REQUEST_SIZE_LIMIT_EXCEEDED
The number of entries in the request exceeds the system limit.
RESPONSE_SIZE_LIMIT_EXCEEDED
The number of entries in the response exceeds the system limit.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.
StringLengthError Errors associated with the length of the given string being out of bounds.
Enumerations
TOO_SHORT
TOO_LONG

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.