CustomerSyncService (v201806)

Use this service to retrieve the changed entities for a customer account or campaign based on the given date range.

Note: There will be some delay in changes becoming visible to this service; thus, use lastChangeTimestamp from the response to determine the validity period for the data.

Note: CustomerSyncService only supports queries for dates within the last 90 days.


Production WSDL
https://adwords.google.com/api/adwords/ch/v201806/CustomerSyncService?wsdl
Namespace
https://adwords.google.com/api/adwords/ch/v201806
Operations
Errors

get

Returns information about changed entities inside a customer's account.

Parameters

Field Type Description
selector CustomerSyncSelector Specifies the filter for selecting changehistory events for a customer.

Response

Field Type Description
rval CustomerChangeData A Customer->Campaign->AdGroup hierarchy containing information about the objects changed at each level. All Campaigns that are requested in the selector will be returned, regardless of whether or not they have changed, but unchanged AdGroups will be ignored.

Errors

Error Reasons
AuthenticationError
Enumerations
AUTHENTICATION_FAILED
CLIENT_CUSTOMER_ID_IS_REQUIRED
CLIENT_EMAIL_REQUIRED
CLIENT_CUSTOMER_ID_INVALID
CLIENT_EMAIL_INVALID
CLIENT_EMAIL_FAILED_TO_AUTHENTICATE
CUSTOMER_NOT_FOUND
GOOGLE_ACCOUNT_DELETED
GOOGLE_ACCOUNT_COOKIE_INVALID
FAILED_TO_AUTHENTICATE_GOOGLE_ACCOUNT
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH
LOGIN_COOKIE_REQUIRED
NOT_ADS_USER
OAUTH_TOKEN_INVALID
OAUTH_TOKEN_EXPIRED
OAUTH_TOKEN_DISABLED
OAUTH_TOKEN_REVOKED
OAUTH_TOKEN_HEADER_INVALID
LOGIN_COOKIE_INVALID
FAILED_TO_RETRIEVE_LOGIN_COOKIE
USER_ID_INVALID
AuthorizationError
Enumerations
UNABLE_TO_AUTHORIZE
NO_ADWORDS_ACCOUNT_FOR_CUSTOMER
USER_PERMISSION_DENIED
EFFECTIVE_USER_PERMISSION_DENIED
CUSTOMER_NOT_ACTIVE
USER_HAS_READONLY_PERMISSION
NO_CUSTOMER_FOUND
SERVICE_ACCESS_DENIED
TWO_STEP_VERIFICATION_NOT_ENROLLED
ADVANCED_PROTECTION_NOT_ENROLLED
ClientTermsError
Enumerations
INCOMPLETE_SIGNUP_CURRENT_ADWORDS_TNC_NOT_AGREED
CustomerSyncError Represents CustomerSyncService specific errors
Enumerations
INVALID_CAMPAIGN_ID
The request attempted to access a campaign that either does not exist or belongs to a different account.
INVALID_FEED_ID
The request attempted to access a feed that either does not exist or belongs to a different account.
INVALID_DATE_RANGE
The request asked for an invalid date range
TOO_MANY_CHANGES
There have been too many changes to sync the campaign over the requested date/time range. To avoid this error, try specifying a smaller date/time range. If this does not work, you should assume that everything has changed and retrieve the objects using their respective services.
DatabaseError
Enumerations
CONCURRENT_MODIFICATION
PERMISSION_DENIED
ACCESS_PROHIBITED
CAMPAIGN_PRODUCT_NOT_SUPPORTED
DUPLICATE_KEY
DATABASE_ERROR
UNKNOWN
DateError
Enumerations
INVALID_FIELD_VALUES_IN_DATE
INVALID_FIELD_VALUES_IN_DATE_TIME
INVALID_STRING_DATE
INVALID_STRING_DATE_RANGE
INVALID_STRING_DATE_TIME
EARLIER_THAN_MINIMUM_DATE
LATER_THAN_MAXIMUM_DATE
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL
DistinctError
Enumerations
DUPLICATE_ELEMENT
DUPLICATE_TYPE
IdError
Enumerations
NOT_FOUND
InternalApiError
Enumerations
UNEXPECTED_INTERNAL_API_ERROR
TRANSIENT_ERROR
UNKNOWN
DOWNTIME
ERROR_GENERATING_RESPONSE
NotEmptyError
Enumerations
EMPTY_LIST
OperationAccessDenied
Enumerations
ACTION_NOT_PERMITTED
ADD_OPERATION_NOT_PERMITTED
REMOVE_OPERATION_NOT_PERMITTED
SET_OPERATION_NOT_PERMITTED
MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
ADD_AS_REMOVED_NOT_PERMITTED
OPERATION_NOT_PERMITTED_FOR_REMOVED_ENTITY
OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
UNKNOWN
OperatorError
Enumerations
OPERATOR_NOT_SUPPORTED
QuotaCheckError
Enumerations
INVALID_TOKEN_HEADER
ACCOUNT_DELINQUENT
ACCOUNT_INACCESSIBLE
ACCOUNT_INACTIVE
INCOMPLETE_SIGNUP
DEVELOPER_TOKEN_NOT_APPROVED
TERMS_AND_CONDITIONS_NOT_SIGNED
MONTHLY_BUDGET_REACHED
QUOTA_EXCEEDED
RangeError
Enumerations
TOO_LOW
TOO_HIGH
RateExceededError
Enumerations
RATE_EXCEEDED
ReadOnlyError
Enumerations
READ_ONLY
RejectedError
Enumerations
UNKNOWN_VALUE
RequestError
Enumerations
UNKNOWN
INVALID_INPUT
UNSUPPORTED_VERSION
RequiredError
Enumerations
REQUIRED
SizeLimitError
Enumerations
REQUEST_SIZE_LIMIT_EXCEEDED
RESPONSE_SIZE_LIMIT_EXCEEDED
INTERNAL_STORAGE_ERROR
UNKNOWN
StringFormatError
Enumerations
UNKNOWN
ILLEGAL_CHARS
INVALID_FORMAT
StringLengthError
Enumerations
TOO_SHORT
TOO_LONG

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.