CustomerSyncService (v201809)

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/v201809/CustomerSyncService?wsdl

Namespace

https://adwords.google.com/api/adwords/ch/v201809

Operations

• get

Errors

• AuthenticationError
• AuthorizationError
• ClientTermsError
• CustomerSyncError
• DatabaseError
• DateError
• DistinctError
• IdError
• InternalApiError
• NotEmptyError
• OperationAccessDenied
• OperatorError
• QuotaCheckError
• RangeError
• RateExceededError
• ReadOnlyError
• RejectedError
• RequestError
• RequiredError
• SizeLimitError
• StringFormatError
• StringLengthError

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