Graph API Version

Ad Adlabels

Reading

You can't perform this operation on this endpoint.

Creating

You can't perform this operation on this endpoint.

Updating

You can update an AdLabel by making a POST request to /{ad_id}/adlabels.

Parameters

ParameterDescription
adlabels
list<Object>

Specification of adlabels to be associated with the ad

Required
execution_options
list<enum{validate_only}>
Default value: Set

An execution setting
validate_only: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field.
If the call passes validation or review, response will be {"success": true}. If the call does not pass, an error will be returned with more details. These options can be used to improve any UI to display errors to the user much sooner, e.g. as soon as a new value is typed into any field corresponding to this ad object, rather than at the upload/save stage, or after review.

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.
Struct {
success: bool,
}

Validation Rules

ErrorDescription
100Invalid parameter
200Permissions error

Deleting

You can dissociate an AdLabel from an Ad by making a DELETE request to /{ad_id}/adlabels.

Parameters

ParameterDescription
adlabels
list<Object>

Specification of ad labels to be disassociated from the ad

Required
execution_options
list<enum{validate_only}>
Default value: Set

An execution setting
validate_only: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field.
If the call passes validation or review, response will be {"success": true}. If the call does not pass, an error will be returned with more details. These options can be used to improve any UI to display errors to the user much sooner, e.g. as soon as a new value is typed into any field corresponding to this ad object, rather than at the upload/save stage, or after review.

Return Type

Struct {
success: bool,
}

Validation Rules

ErrorDescription
100Invalid parameter