AI-generated Key Takeaways
-
The Segment Population Service in version v202411 has a specific WSDL and namespace.
-
The service provides operations to get segment population results by IDs, perform actions on segment populations, and update segment memberships.
-
Various errors can occur when using this service, including issues with API version, authentication, collection size, and permissions.
-
The
updateSegmentMembershipsoperation allows updating identifiers in an audience segment and returns a batch upload ID for grouping requests, which must be processed within 5 days usingperformSegmentPopulationAction. -
The
getSegmentPopulationResultsByIdsoperation retrieves the results for specific batch upload IDs.
- Production WSDL
-
https://ads.google.com/apis/ads/publisher/v202411/SegmentPopulationService?wsdl - Namespace
-
https://www.google.com/apis/ads/publisher/v202411 - Operations
- Errors
-
- ApiVersionError
- AuthenticationError
- CollectionSizeError
- CommonError
- FeatureError
- InternalApiError
- NotNullError
- ParseError
- PermissionError
- PublisherQueryLanguageContextError
- PublisherQueryLanguageSyntaxError
- QuotaError
- RequiredCollectionError
- RequiredError
- SegmentPopulationError
- ServerError
- StringFormatError
- StringLengthError
getSegmentPopulationResultsByIds
Returns a list of SegmentPopulationResults
for the given batchUploadIds
.
Parameters
| Field | Type | Description |
|---|---|---|
batchUploadIds
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
performSegmentPopulationAction
Performs an action on the uploads denoted by batchUploadIds
.
Parameters
batchUploadIds
xsd:
long[]
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
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
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
Errors
Enumerations
-
UPDATE_TO_NEWER_VERSION -
UNKNOWN
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
Enumerations
-
TOO_LARGE -
UNKNOWN
Enumerations
-
NOT_FOUND -
ALREADY_EXISTS -
NOT_APPLICABLE -
DUPLICATE_OBJECT -
CANNOT_UPDATE -
UNSUPPORTED_OPERATION -
CONCURRENT_MODIFICATION -
UNKNOWN
Enumerations
-
MISSING_FEATURE -
UNKNOWN
Enumerations
-
UNEXPECTED_INTERNAL_API_ERROR -
TRANSIENT_ERROR -
UNKNOWN -
DOWNTIME -
ERROR_GENERATING_RESPONSE
Enumerations
-
ARG1_NULL -
ARG2_NULL -
ARG3_NULL -
NULL -
UNKNOWN
Enumerations
-
UNPARSABLE -
UNKNOWN
Enumerations
-
PERMISSION_DENIED -
UNKNOWN
Enumerations
-
UNEXECUTABLE -
UNKNOWN
Enumerations
-
UNPARSABLE -
UNKNOWN
Enumerations
-
EXCEEDED_QUOTA -
UNKNOWN -
REPORT_JOB_LIMIT -
SEGMENT_POPULATION_LIMIT
Enumerations
-
REQUIRED -
TOO_LARGE -
TOO_SMALL -
UNKNOWN
Enumerations
-
REQUIRED
Enumerations
-
TOO_MANY_IDENTIFIERS -
INVALID_SEGMENT -
JOB_ALREADY_STARTED -
NO_IDENTIFIERS -
NO_CONSENT -
UNKNOWN
Enumerations
-
SERVER_ERROR -
SERVER_BUSY -
UNKNOWN
Enumerations
-
UNKNOWN -
ILLEGAL_CHARS -
INVALID_FORMAT
Enumerations
-
TOO_LONG -
TOO_SHORT -
UNKNOWN
