SegmentPopulationService (v202505)

  • The Production WSDL and Namespace are provided for the SegmentPopulationService.

  • The service supports operations to get segment population results, perform segment population actions, and update segment memberships.

  • Multiple error types are defined for various issues including API version, authentication, collection size, common errors, and more.

  • The getSegmentPopulationResultsByIds operation retrieves results for given batch upload IDs.

  • The performSegmentPopulationAction operation allows performing actions on batches identified by IDs.

  • The updateSegmentMemberships operation facilitates updating identifiers in audience segments, returning a batch upload ID for subsequent actions.
Production WSDL
https://ads.google.com/apis/ads/publisher/v202505/SegmentPopulationService?wsdl
Namespace
https://www.google.com/apis/ads/publisher/v202505
Operations
Errors

getSegmentPopulationResultsByIds

Returns a list of SegmentPopulationResults for the given batchUploadIds.

Parameters

Field Type Description
batchUploadIds xsd:long[]

Response

Field Type Description
rval SegmentPopulationResults[]

performSegmentPopulationAction

Performs an action on the uploads denoted by batchUploadIds.

Parameters

Field Type Description
action
  1. SegmentPopulationAction
    1. ProcessAction
batchUploadIds xsd:long[]

Response

Field Type Description
rval UpdateResult

updateSegmentMemberships

Updates identifiers in an audience segment.

The returned SegmentPopulationRequest.batchUploadId can be used in subsequent requests to group them together as part of the same batch. The identifiers associated with a batch will not be processed until performSegmentPopulationAction is called with a ProcessAction. The batch will expire if ProcessAction is not called within the TTL of 5 days.

Parameters

Field Type Description
updateRequest SegmentPopulationRequest

Response

Field Type Description
rval SegmentPopulationResponse

Errors

Error Reasons
ApiVersionError
Enumerations
UPDATE_TO_NEWER_VERSION
UNKNOWN
AuthenticationError
Enumerations
AMBIGUOUS_SOAP_REQUEST_HEADER
INVALID_EMAIL
AUTHENTICATION_FAILED
INVALID_OAUTH_SIGNATURE
INVALID_SERVICE
MISSING_SOAP_REQUEST_HEADER
MISSING_AUTHENTICATION_HTTP_HEADER
MISSING_AUTHENTICATION
NETWORK_API_ACCESS_DISABLED
NO_NETWORKS_TO_ACCESS
NETWORK_NOT_FOUND
NETWORK_CODE_REQUIRED
CONNECTION_ERROR
GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
UNDER_INVESTIGATION
UNKNOWN
CollectionSizeError
Enumerations
TOO_LARGE
UNKNOWN
CommonError
Enumerations
NOT_FOUND
ALREADY_EXISTS
NOT_APPLICABLE
DUPLICATE_OBJECT
CANNOT_UPDATE
UNSUPPORTED_OPERATION
CONCURRENT_MODIFICATION
UNKNOWN
FeatureError
Enumerations
MISSING_FEATURE
UNKNOWN
InternalApiError
Enumerations
UNEXPECTED_INTERNAL_API_ERROR
TRANSIENT_ERROR
UNKNOWN
DOWNTIME
ERROR_GENERATING_RESPONSE
NotNullError
Enumerations
ARG1_NULL
ARG2_NULL
ARG3_NULL
NULL
UNKNOWN
ParseError
Enumerations
UNPARSABLE
UNKNOWN
PermissionError
Enumerations
PERMISSION_DENIED
UNKNOWN
PublisherQueryLanguageContextError
Enumerations
UNEXECUTABLE
UNKNOWN
PublisherQueryLanguageSyntaxError
Enumerations
UNPARSABLE
UNKNOWN
QuotaError
Enumerations
EXCEEDED_QUOTA
UNKNOWN
REPORT_JOB_LIMIT
SEGMENT_POPULATION_LIMIT
RequiredCollectionError
Enumerations
REQUIRED
TOO_LARGE
TOO_SMALL
UNKNOWN
RequiredError
Enumerations
REQUIRED
SegmentPopulationError
Enumerations
TOO_MANY_IDENTIFIERS
INVALID_SEGMENT
JOB_ALREADY_STARTED
NO_IDENTIFIERS
NO_CONSENT
UNKNOWN
ServerError
Enumerations
SERVER_ERROR
SERVER_BUSY
UNKNOWN
StringFormatError
Enumerations
UNKNOWN
ILLEGAL_CHARS
INVALID_FORMAT
StringLengthError
Enumerations
TOO_LONG
TOO_SHORT
UNKNOWN