Errors

{
	"error": {
		"code": 400,
		"message": "The request has invalid values: email.",
		"status": "INVALID_ARGUMENT",
		"details": [
			{
				"@type": "type.googleapis.com/google.rpc.ErrorInfo",
				"reason": "INVALID_ARGUMENT",
				"domain": "api.plazza.ca"
			},
			{
				"@type": "type.googleapis.com/google.rpc.LocalizedMessage",
				"locale": "fr",
				"message": "La demande contient des valeurs non valides. Vérifiez-les, puis réessayez."
			},
			{
				"@type": "type.googleapis.com/google.rpc.BadRequest",
				"fieldViolations": [{ "field": "email", "description": "Invalid email address" }]
			}
		]
	}
}

Details

• ErrorInfo is always there. Its reason names the cause in upper snake case, such as NOT_A_SESSION, and is stable: branch on status and reason. metadata, when present, holds the values the cause depends on.
• LocalizedMessage is always there too: a message to show to a person, in the language the request asked for with Accept-Language, French (fr) or English (en). English is the default.
• BadRequest comes with a 400 for a body or query that fails its schema. Each fieldViolation names a field by its path, such as address.street or items[0].name, and describes the problem in English.
• RetryInfo comes with a 429: its retryDelay, such as "42s", says how long to wait before retrying. See Rate limits.

Statuses