Feature request: stronger typing for query results

[joshtemple]

Hi Looker API team! I'm reposting a question I asked in Looker Community a couple weeks ago.

I’m one of the maintainers of Spectacles, an open-source tool for testing LookML for SQL, content, and data test errors. We’re major users of the Looker API and have been using it for a long time with hundreds of Looker customers.

We'd love to see stronger response typing when it comes to running queries and receiving results (and errors!). Specifically, we're interested in GET /query_tasks/multi_results, which in the Python SDK, returns an untyped MutableMapping (basically JSON).

In practice, this lack of clarity on response format has caused issues for our library because we have to handle a variety of different response and error formats that we’ve encountered over the years. It’s also difficult to develop without testing this endpoint live, because we can never remember which fields are returned.

Would it be possible to type this response more explicitly?