Declare a policy rule for a project
Creates a policy rule, exactly like Settings > Policy rules. Rules encode your team's monitoring criteria; a match is a lead for review, not proof of a policy violation. From the next saved check on, each ad that breaks it opens or updates a case (one per rule and advertiser, plus the affiliate ID for affiliate rules). Earlier checks are not evaluated automatically: preview with preview_policy_rule first. Types and params: forbidden_terms {terms, fields: headline|description|display_url, applies_to, authorized_domains}; brand_term {extra_terms, authorized_domains}; direct_linking {authorized_domains}; promo_code {codes, any_explicit_code, allowed_codes, applies_to, authorized_domains}; position_limit {top_positions 1-10, applies_to, authorized_domains}; affiliate_id {authorized_ids}. applies_to is unauthorized (default for position limits) or all_non_owned (default for terms and codes). Your own domains never match, except for affiliate_id; advertisers classified as authorized retailers and authorized_domains count as authorized. A match is a lead to review: an observation shows an ad was displayed for a search at a moment, not proof of a violation, spend or a purchased keyword. Requires the write scope and an idempotency key; a retry with the same key returns the same rule.
Request
- Base URL: https://adslighthouse.com/api/v1
- URL: https://adslighthouse.com/api/v1/projects/{project_id}/policy-rules
- Auth: HTTP bearer
Path parameters
The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.
Headers
A unique value you choose for this request, such as a UUID. Repeating the same key returns the first result instead of starting paid work again.
Request body
Response
Declare a policy rule for a project
Changes
No recorded changes to this operation across all 1 revision of this API.