Analytics scopes

Distinguish between analytics read-only and analytics read/write scopes, adding the latter.

Also, provide better documentation for selecting api scope.