BadRequest

Descrive le violazioni in una richiesta del client. Questo tipo di errore si concentra sugli aspetti sintattici della richiesta.

Rappresentazione JSON 
{
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}
Campi
fieldViolations[]

object (FieldViolation)

Descrive tutte le violazioni in una richiesta del client.

FieldViolation

Un tipo di messaggio utilizzato per descrivere un singolo campo di richiesta errata.

Rappresentazione JSON 
{
  "field": string,
  "description": string,
  "reason": string,
  "localizedMessage": {
    object (LocalizedMessage)
  }
}
Campi
field

string

Un percorso che porta a un campo nel corpo della richiesta. Il valore sarà una sequenza di identificatori separati da punti che identificano un campo del buffer del protocollo.

Considera quanto segue:

message CreateContactRequest {
  message EmailAddress {
    enum Type {
      TYPE_UNSPECIFIED = 0;
      HOME = 1;
      WORK = 2;
    }

    optional string email = 1;
    repeated EmailType type = 2;
  }

  string fullName = 1;
  repeated EmailAddress email_addresses = 2;
}

In questo esempio, in proto field potrebbe assumere uno dei seguenti valori:

  • fullName per una violazione nel valore fullName
  • email_addresses[1].email per una violazione nel campo email del primo messaggio email_addresses
  • email_addresses[3].type[2] per una violazione nel secondo valore type nel terzo messaggio email_addresses.

In JSON, gli stessi valori sono rappresentati come segue:

  • fullName per una violazione nel valore fullName
  • emailAddresses[1].email per una violazione nel campo email del primo messaggio emailAddresses
  • emailAddresses[3].type[2] per una violazione nel secondo valore type nel terzo messaggio emailAddresses.
description

string

Una descrizione del motivo per cui l'elemento della richiesta è errato.
reason

string

Il motivo dell'errore a livello di campo. Si tratta di un valore costante che identifica la causa prossima dell'errore a livello di campo. Deve identificare in modo univoco il tipo di FieldViolation nell'ambito di google.rpc.ErrorInfo.domain. Deve contenere al massimo 63 caratteri e corrispondere a un'espressione regolare di [A-Z][A-Z0-9_]+[A-Z0-9], che rappresenta UPPER_SNAKE_CASE.
localizedMessage

object (LocalizedMessage)

Fornisce un messaggio di errore localizzato per gli errori a livello di campo che è sicuro restituire al consumer dell'API.

LocalizedMessage

Fornisce un messaggio di errore localizzato che può essere restituito all'utente e che può essere allegato a un errore RPC.

Rappresentazione JSON 
{
  "locale": string,
  "message": string
}
Campi
locale

string

Le impostazioni internazionali utilizzate seguono la specifica definita all'indirizzo https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Esempi: "en-US", "fr-CH", "es-MX"
message

string

Il messaggio di errore localizzato nella lingua indicata sopra.