Add API filters for print usage info

andrew-nowak commented 1 year ago

What does this change?

Adds some media API search filters to allow drilling down into images which have print usages which meet several criteria:

printUsageIssueDate
printUsageSectionCode
printUsagePageNumber
printUsageEdition
printUsageOrderedBy

printUsageIssueDate is required to query on print usages like this (there's no technical reason, but it doesn't really make sense to query without it)

These use filters rather than query syntax / chips because that I originally thought that gave us an extra level of control over the querying of nested fields (I thought that +usage@issueDate:2023-01-01 +usage@sectionCode:1jo would give us images where at least one usage was on the date, and at least one usage was in the section, but not necessarily the same usage. I'm less convinced of that now.). But I still think it's nicer for our purposes to use filters than chips (where grid UI helps phrase the chip correctly, but in API you're on your own). Lmk if you disagree and I'll double check viability of using chips instead.

How should a reviewer test this change?

Make some print usages, try to slice them with queries.

How can success be measured?