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

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`