Zapis w dokumencie.
Zapis JSON |
---|
{ "updateMask": { object ( |
Pola | |
---|---|
updateMask |
Pola do zaktualizowania w tym zapisie. To pole można ustawić tylko wtedy, gdy operacja to |
updateTransforms[] |
Przekształcenia, które mają zostać wykonane po aktualizacji. To pole można ustawić tylko wtedy, gdy operacja to |
currentDocument |
Opcjonalny warunek wstępny dotyczący dokumentu. Jeśli ta wartość jest ustawiona, a dokument docelowy nie spełnia tego warunku, zapis się nie uda. |
Pole sumy operation . Operacja do wykonania. operation może mieć tylko jedną z tych wartości: |
|
update |
Dokument do pisania. |
delete |
Nazwa dokumentu do usunięcia. W formacie: |
transform |
Stosuje przekształcenie do dokumentu. |
DocumentTransform
Przekształcenie dokumentu.
Zapis JSON |
---|
{
"document": string,
"fieldTransforms": [
{
object ( |
Pola | |
---|---|
document |
Nazwa dokumentu do przekształcenia. |
fieldTransforms[] |
Lista przekształceń, które mają zostać zastosowane do pól dokumentu w określonej kolejności. To pole nie może być puste. |
Przekształcenie pola
Przekształcenie pola dokumentu.
Zapis JSON |
---|
{ "fieldPath": string, // Union field |
Pola | |
---|---|
fieldPath |
Ścieżka pola. Informacje o składni ścieżek pól znajdziesz na |
Pole sumy transform_type . Przekształcenie, które zostanie zastosowane w polu. transform_type może mieć tylko jedną z tych wartości: |
|
setToServerValue |
Ustawia w polu podaną wartość serwera. |
increment |
Dodaje podaną wartość do bieżącej wartości pola. Musi to być liczba całkowita lub podwójna. Jeśli pole nie jest liczbą całkowitą ani zmiennoprzecinkową albo jeśli pole jeszcze nie istnieje, przekształcenie ustawi w polu podaną wartość. Jeśli jedna z podanych wartości lub obecna wartość pola to wartości zmiennoprzecinkowe, obie te wartości zostaną zinterpretowane jako liczby zmiennoprzecinkowe. Podwójna arytmetyka i reprezentacja wartości podwójnej precyzji są zgodne ze standardem IEEE 754. Jeśli występuje dodatnie/ujemne przekroczenie liczby całkowitej, pole jest przekształcane na największą dodatnią/ujemną liczbę całkowitą. |
maximum |
Ustawia maksymalną wartość pola na jego bieżącą i podaną wartość. Musi to być liczba całkowita lub podwójna. Jeśli pole nie jest liczbą całkowitą ani zmiennoprzecinkową albo jeśli pole jeszcze nie istnieje, przekształcenie ustawi w polu podaną wartość. W przypadku zastosowania maksymalnej operacji, w której pole i wartość wejściowa są różnych typów (tzn. jedna jest liczbą całkowitą, a druga to podwójna), pole przyjmuje typ większego operandu. Jeśli operandy są równoważne (np. 3 i 3.0), pole nie zmienia się. 0, 0,0 i -0,0 to zero. Maksymalna wartość środków przedpłaconych i 0 wartości wejściowej to zawsze wartość przedpłacona. Maksymalna wartość liczbowa x i NaN to NaN. |
minimum |
Ustawia w polu minimalną wartość bieżącej i podaną wartość. Musi to być liczba całkowita lub podwójna. Jeśli pole nie jest liczbą całkowitą ani zmiennoprzecinkową albo jeśli pole jeszcze nie istnieje, przekształcenie ustawi w polu wartość wejściową. Jeśli stosowana jest operacja minimalna, w której pole i wartość wejściowa są różnych typów (tzn. jedna jest liczbą całkowitą, a drugą jest liczbą podwójną), pole przyjmuje typ mniejszego operandu. Jeśli operandy są równoważne (np. 3 i 3.0), pole nie zmienia się. 0, 0,0 i -0,0 to zero. Najniższa wartość przedpłaconej i 0 wejściowa to zawsze wartość przedpłacona. Minimalną wartością każdej wartości liczbowej x i NaN jest NaN. |
appendMissingElements |
Dołącz podane elementy w kolejności, jeśli nie występują jeszcze w bieżącej wartości pola. Jeśli pole nie jest tablicą lub jeśli pole jeszcze nie istnieje, najpierw ustawiane jest puste pole. Liczby równoważne różnych typów (np. 3L i 3,0) są uznawane za równe podczas sprawdzania, czy brakuje wartości. NaN jest równa NaN, a Null jest równa null. Jeśli dane wejściowe zawierają kilka równoważnych wartości, brana jest pod uwagę tylko pierwsza z nich. Powiązany wynik przekształcenia będzie miał wartość null. |
removeAllFromArray |
Usuń z tablicy w polu wszystkie podane elementy. Jeśli pole nie jest tablicą lub jeśli pole jeszcze nie istnieje, jest ustawione na pustą tablica. Przy podejmowaniu decyzji o usunięciu elementu uznaje się, że liczby równoważne różnych typów (np. 3L i 3.0). NaN jest równa NaN, a Null jest równa null. Spowoduje to usunięcie wszystkich równoważnych wartości, jeśli istnieją duplikaty. Powiązany wynik przekształcenia będzie miał wartość null. |
Wartość serwera
Wartość obliczana przez serwer.
Wartości w polu enum | |
---|---|
SERVER_VALUE_UNSPECIFIED |
Nie określono. Tej wartości nie można używać. |
REQUEST_TIME |
Godzina, w której serwer przetworzył żądanie, z dokładnością do milisekund. Jeśli użyjesz go w wielu polach (tych samych lub różnych dokumentach) w transakcji, wszystkie pola będą miały tę samą sygnaturę czasową serwera. |