/experimental/retail-media/retailers/{retailer-id}/change-history-entries
Returns a paginated collection of changes to Retail Media objects under the
requested retailer. Use event-types and entity-types to narrow the results.
Requests for inaccessible or unknown retailers return 403. Changes outside
the caller’s access are omitted. Offsite campaign-level changes are not
returned; offsite line-item changes are included. Actor information is limited
to role labels; user identifiers are not returned.
Results are returned in descending order by occurredAt. The relative
order of entries with identical occurredAt values is unspecified.
Additional eventType, entity type, and change field values may be
returned. Clients must tolerate values they do not recognize.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
- Authorization URL
- https://api.criteo.com/oauth2
- Token URL
- https://api.criteo.com/oauth2/token
- Token URL
- https://api.criteo.com/oauth2/token
Path Parameters
External opaque identifier of the retailer whose change history is requested.
Query Parameters
When provided, only changes for these external opaque campaign identifiers are returned. Entries for campaigns outside the caller's retailer access are excluded without revealing whether the campaign exists. Omission is equivalent to an empty array.
Inclusive upper bound on change time, in UTC (ISO-8601 date-time). Defaults to the request time when omitted.
Restrict results to changes on the given entity types (see the entity
type field). Unknown values are not errors; they simply match no entries.
Omission is equivalent to an empty array.
Restrict results to specific change-event types (see eventType). When
omitted, all supported event types may be returned. Unknown values are not
errors; they simply match no entries. Omission is equivalent to an empty
array.
Maximum number of change-history entries to return in a single page.
1 <= x <= 100When provided, only changes for these external opaque line-item identifiers are returned. Entries for line items outside the caller's retailer access are excluded without revealing whether the line item exists. Omission is equivalent to an empty array.
Zero-based index of the first change-history entry to return.
x >= 0Inclusive lower bound on change time, in UTC (ISO-8601 date-time). Defaults to 7 days before the request time when omitted.
Response
Change history entries retrieved.