BadRequest

İstemci isteğindeki ihlalleri açıklar. Bu hata türü, isteğin söz dizimiyle ilgili yönlerine odaklanır.

JSON gösterimi
{
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}
Alanlar
fieldViolations[]

object (FieldViolation)

İstemci isteğindeki tüm ihlalleri açıklar.

FieldViolation

Tek bir hatalı istek alanını açıklamak için kullanılan mesaj türü.

JSON gösterimi
{
  "field": string,
  "description": string,
  "reason": string,
  "localizedMessage": {
    object (LocalizedMessage)
  }
}
Alanlar
field

string

İstek gövdesindeki bir alana giden yol. Değer, bir protokol arabelleği alanını tanımlayan, nokta ile ayrılmış tanımlayıcılar dizisi olur.

Aşağıdakileri göz önünde bulundurun:

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;
}

Bu örnekte, proto field aşağıdaki değerlerden birini alabilir:

  • fullName değerindeki bir ihlal için fullName
  • İlk email_addresses iletisinin email alanındaki bir ihlal için email_addresses[1].email
  • Üçüncü email_addresses mesajdaki ikinci type değerinde email_addresses[3].type[2] ihlali için.

JSON'da aynı değerler şu şekilde gösterilir:

  • fullName değerindeki bir ihlal için fullName
  • İlk emailAddresses iletisinin email alanındaki bir ihlal için emailAddresses[1].email
  • Üçüncü emailAddresses mesajdaki ikinci type değerinde emailAddresses[3].type[2] ihlali için.
description

string

İstek öğesinin neden kötü olduğuna dair açıklama.

reason

string

Alan düzeyindeki hatanın nedeni. Bu, alan düzeyindeki hatanın asıl nedenini tanımlayan sabit bir değerdir. google.rpc.ErrorInfo.domain kapsamındaki FieldViolation türünü benzersiz şekilde tanımlamalıdır. Bu değer en fazla 63 karakter olmalı ve UPPER_SNAKE_CASE'i temsil eden [A-Z][A-Z0-9_]+[A-Z0-9] normal ifadesiyle eşleşmelidir.

localizedMessage

object (LocalizedMessage)

Alan düzeyindeki hatalar için API tüketicisine döndürülmesi güvenli olan yerelleştirilmiş bir hata mesajı sağlar.

LocalizedMessage

TBG hatasına eklenebilecek, kullanıcıya döndürülmesi güvenli olan yerelleştirilmiş bir hata mesajı sağlar.

JSON gösterimi
{
  "locale": string,
  "message": string
}
Alanlar
locale

string

https://www.rfc-editor.org/rfc/bcp/bcp47.txt adresinde tanımlanan spesifikasyona göre kullanılan yerel ayar. Örnekler: "en-US", "fr-CH", "es-MX"

message

string

Yukarıdaki yerel ayarda yerelleştirilmiş hata mesajı.