Policy

Check saved ads against the enabled rules and record cases

Evaluates every enabled policy rule of the project against the saved checks in a date range (last 30 days by default, at most 92 days), like "Evaluate saved ads" in the app. New matches are recorded as findings and open or update cases; a resolved case reopens only for an ad observed after it was resolved. Review matches with list_policy_cases and list_policy_case_evidence before deciding what they mean. Repeating the call records nothing twice. New captures are evaluated automatically; use this after adding or changing a rule to review older checks. 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.

post/projects/{project_id}/policy-rule-evaluation

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/policy-rule-evaluation
  • Auth: HTTP bearer

Path parameters

project_idstring required

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.

Request body

range'7d' | '14d' | '30d' | '12m' | 'custom'

Window ending today: 7d, 14d, 30d (default) or 12m. Use custom with from and to for fixed dates.

fromstring

First local day, YYYY-MM-DD (custom range).

tostring

Last local day, YYYY-MM-DD, included in full (custom range).

time_zonestring

IANA time zone for day boundaries, such as America/New_York. Defaults to the time zone of the person the credential acts for.

Response

Check saved ads against the enabled rules and record cases

findingsinteger required

New findings recorded by this call.

openedinteger required

Cases opened by this call.

reopenedinteger required

Resolved cases reopened by a newer match.

truncatedboolean required

True when a rule read only the first 20,000 saved ads of the range.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.