Opisuje, które warunki wstępne nie zostały spełnione.
Jeśli na przykład wywołanie RPC nie powiodło się, ponieważ wymagało potwierdzenia Warunków korzystania z usługi, w wiadomości PreconditionFailure może zostać wymienione naruszenie tych warunków.
| Zapis JSON |
|---|
{
"violations": [
{
object ( |
| Pola | |
|---|---|
violations[] |
Opisuje wszystkie naruszenia warunków wstępnych. |
Naruszenie
Typ wiadomości używany do opisywania pojedynczego błędu warunku wstępnego.
| Zapis JSON |
|---|
{ "type": string, "subject": string, "description": string } |
| Pola | |
|---|---|
type |
Typ błędu PreconditionFailure. Zalecamy użycie typu wyliczeniowego specyficznego dla usługi, aby zdefiniować obsługiwane podmioty naruszenia warunku wstępnego. Na przykład „TOS” w przypadku „naruszenia Warunków usługi”. |
subject |
Obiekt, którego dotyczy błąd, w odniesieniu do typu. Na przykład „google.com/cloud” w odniesieniu do typu „Warunki korzystania z usługi” wskazuje, do których warunków korzystania z usługi odnosi się informacja. |
description |
Opis tego, dlaczego warunek wstępny nie został spełniony. Deweloperzy mogą użyć tego opisu, aby dowiedzieć się, jak naprawić błąd. Na przykład: „Nie zaakceptowano warunków usługi”. |