Service for creating, editing, and deleting labels that can be applied to managed customers.
Labels created by a manager are not accessible to any customers managed by this manager. Only manager customers may create these labels.
Note that label access works a little differently in the API than it does in the AdWords UI. In the UI, a manager will never see a submanager's labels, and will always be using his own labels regardless of which managed account he is viewing. In this API, like other API services, if you specify a submanager as the effective account for the API request, then the request will operate on the submanager's labels.
To apply a label to a managed customer, see ManagedCustomerService.mutateLabel.
- Production WSDL
-
https://adwords.google.com/api/adwords/mcm/v201809/AccountLabelService?wsdl
- Namespace
-
https://adwords.google.com/api/adwords/mcm/v201809
- Operations
- Errors
-
- AuthenticationError
- AuthorizationError
- ClientTermsError
- CollectionSizeError
- CurrencyCodeError
- DatabaseError
- DateError
- DistinctError
- IdError
- InternalApiError
- LabelServiceError
- NotEmptyError
- NullError
- OperationAccessDenied
- OperatorError
- QuotaCheckError
- RangeError
- RateExceededError
- ReadOnlyError
- RegionCodeError
- RejectedError
- RequestError
- RequiredError
- SelectorError
- SizeLimitError
- StringFormatError
- StringLengthError
get
Returns a list of labels specified by the selector for the authenticated user.
Parameters
Field | Type | Description |
---|---|---|
selector
|
|
filters the list of labels to return |
Response
Field | Type | Description |
---|---|---|
rval
|
|
response containing lists of labels that meet all the criteria of the selector |
mutate
Possible actions:
- Create a new label - create a new Label and call mutate with ADD operator
- Edit the label name - set the appropriate fields in your Label and call mutate with the SET operator. Null fields will be interpreted to mean "no change"
- Delete the label - call mutate with REMOVE operator
Parameters
Field | Type | Description |
---|---|---|
operations
|
|
list of unique operations to be executed in a single transaction, in the order specified. |
Response
Field | Type | Description |
---|---|---|
rval
|
|
the mutated labels, in the same order that they were in as the parameter |
Errors
Error | Reasons |
---|---|
AuthenticationError
|
Errors returned when Authentication failed.
Enumerations
|
AuthorizationError
|
Errors encountered when trying to authorize a user.
Enumerations
|
ClientTermsError
|
Error due to user not accepting the AdWords terms of service.
Enumerations
|
CollectionSizeError
|
Errors associated with the size of the given collection being
out of bounds.
Enumerations
|
CurrencyCodeError
|
Errors for currency codes.
Enumerations
|
DatabaseError
|
Errors that are thrown due to a database access problem.
Enumerations
|
DateError
|
Errors associated with invalid dates and date ranges.
Enumerations
|
DistinctError
|
Errors related to distinct ids or content.
Enumerations
|
IdError
|
Errors associated with the ids.
Enumerations
|
InternalApiError
|
Indicates that a server-side error has occured. InternalApiError s
are generally not the result of an invalid request or message sent by the
client.
Enumerations
|
LabelServiceError
|
Errors for LabelService.
Enumerations
|
NotEmptyError
|
Errors corresponding with violation of a NOT EMPTY check.
Enumerations
|
NullError
|
Errors associated with violation of a NOT NULL check.
Enumerations
|
OperationAccessDenied
|
Operation not permitted due to the invoked service's access policy.
Enumerations
|
OperatorError
|
Errors due to the use of unsupported operations.
Enumerations
|
QuotaCheckError
|
Encapsulates the errors thrown during developer quota checks.
Enumerations
|
RangeError
|
A list of all errors associated with the Range constraint.
Enumerations
|
RateExceededError
|
Signals that a call failed because a measured rate exceeded.
Enumerations
|
ReadOnlyError
|
Errors from attempting to write to read-only fields.
Enumerations
|
RegionCodeError
|
A list of all errors associated with the @RegionCode constraints.
Enumerations
|
RejectedError
|
Indicates that a field was rejected due to compatibility issues.
Enumerations
|
RequestError
|
Encapsulates the generic errors thrown when there's an error with user
request.
Enumerations
|
RequiredError
|
Errors due to missing required field.
Enumerations
|
SelectorError
|
Represents possible error codes for Selector.
Enumerations
|
SizeLimitError
|
Indicates that the number of entries in the request or response exceeds the system limit.
Enumerations
|
StringFormatError
|
A list of error code for reporting invalid content of input strings.
Enumerations
|
StringLengthError
|
Errors associated with the length of the given string being
out of bounds.
Enumerations
|