[apis] How do we return results?

[Clam-]

For example in the googleapis.py module, I've been returning results as tuples just containing the fields I've been needing to use in the actual modules that use those apis.
Should we actually be returning the JSON dictionaries in full? (probably. I've done it with youtube helper method.)

[gkistler]

Something I've been partial to lately when dealing with situations like this is to perform the preprocessing in the api method (like what we're doing in google_image ) then return something like (formatted_results_tuple, json_response). That way it's convenient for the basic use case and the full json data is available if you want it.

Alternatively we could split the actual json snagging to its own _json methods and provide those if someone wants full response?

[Clam-]

That's a good idea. Either one is good I think I've seen the former one in some other APIs.