Skip to main content

GetCallerAdoption

GET 
/v1/usage/caller-adoption

GetCallerAdoption counts the distinct people and the distinct applications that called in a time range, read from the usage rollups.

An identity is the user a request is recorded under: the directory user who owns a person's API key, or the principal of an application or of a person who signs in with an identity-provider token. A user with several API keys counts once, and an application whose key was rotated counts once. A principal belongs to one project, so a person who signs in with a token through several projects counts once in each project. An identity whose caller kind an admin changed during the range counts under each kind it had. Usage recorded before the caller kind was recorded counts under unknown.

Authorization is the same as GetUsageStats: metrics_reader and usage.read. A request that names customer_id counts only that organization's callers, so a user who calls two organizations counts in each. A request that names no organization counts every organization and needs a platform usage.read grant. It counts a user once in each organization the user called. The count of each kind equals the sum of the per-organization counts, plus one for each user with usage recorded by a key that has since been deleted, because that usage counts as a group of its own.

Request​

Responses​

Success