Обновить ячейки

Изменяет значения ячеек динамической таблицы.

Общие заголовки и способы аутентификации описаны в разделе Доступ к API. Примеры сценариев приведены в разделе Примеры использования API.

Request

POST

https://api.wiki.yandex.net/v1/grids/{idx}/cells

Path parameters

Name

Description

idx

Type: string<uuid4>

UUID динамической таблицы. Значение idx совпадает со значением поля id в ответе POST /v1/grids или поля results[].id в ответе GET /v1/pages/{idx}/grids. В /v1/pages/{idx}/grids параметр idx — числовой ID страницы.

Example: ``

Body

application/json

{
  "revision": "example",
  "cells": [
    {
      "row_id": 0,
      "column_slug": "example",
      "value": 0
    }
  ]
}

Name

Description

cells

Type: UpdateCellSchema[]

Ячейки, значения которых нужно изменить. Список должен содержать хотя бы одну ячейку.

Example

[
  {
    "row_id": 0,
    "column_slug": "example",
    "value": 0
  }
]

revision

Type: string

Версия таблицы, на которой основано изменение. При параллельном изменении той же ячейки возможен конфликт; изменения других ячеек могут быть объединены.

Example: example

UserIdentityExtended

Расширенный идентификатор пользователя с дополнительными полями

Name	Description
cloud_uid	Type: string Идентификатор пользователя в Яндекс Облаке Example: `example`
uid	Type: string Идентификатор пользователя в Яндексе Example: `example`
username	Type: string Логин пользователя Example: `example`

Example

{
  "uid": "example",
  "cloud_uid": "example",
  "username": "example"
}

UpdateCellSchema

Новое значение ячейки динамической таблицы.

Name	Description
column_slug	Type: string Слаг столбца. Example: `example`
row_id	Type: integer Идентификатор строки.
value	Any of 6 types Type: integer Type: number Type: boolean Type: string Example: `example` Type: string[] Example `[ "example" ]` Type: UserIdentityExtended[] Example `[ { "uid": "example", "cloud_uid": "example", "username": "example" } ]` Значение ячейки в формате, соответствующем типу столбца. Example: `0`

Example

{
  "row_id": 0,
  "column_slug": "example",
  "value": 0
}

Responses

200 OK

Body

application/json

{
  "revision": "example",
  "cells": [
    {
      "row_id": "example",
      "column_slug": "example",
      "value": 0
    }
  ]
}

Name

Description

cells

Type: CellSchema[]

Измененные ячейки с их значениями после обработки сервисом.

Example

[
  {
    "row_id": "example",
    "column_slug": "example",
    "value": 0
  }
]

revision

Type: string

Версия таблицы после выполнения операции.

Example: example

TicketSchema

Схема задачи из Яндекс Трекера

Name

Description

key

Type: string

Ключ задачи (например, WIKI-123)

Example: example

resolved

Type: boolean

Задача решена (закрыта).

Example

{
  "key": "example",
  "resolved": true
}

UserIdentity

Идентификатор пользователя

Name

Description

cloud_uid

Type: string

Идентификатор пользователя в облаке

Example: example

uid

Type: string

Идентификатор пользователя в Яндексе

Example: example

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

UserSchema

Информация о пользователе

Name	Description
affiliation	Type: string Принадлежность пользователя Example: `example`
display_name	Type: string Отображаемое имя пользователя Example: `example`
id	Type: integer Внутренний идентификатор пользователя
is_dismissed	Type: boolean Пользователь уволен
username	Type: string Логин пользователя Example: `example`
identity	All of 1 type UserIdentity Type: UserIdentity Идентификатор пользователя Example `{ "uid": "example", "cloud_uid": "example" }` Идентификатор пользователя в системе Example `{ "uid": "example", "cloud_uid": "example" }`

Example

{
  "id": 0,
  "identity": {
    "uid": "example",
    "cloud_uid": "example"
  },
  "username": "example",
  "display_name": "example",
  "is_dismissed": true,
  "affiliation": "example"
}

UnresolvedUserSchema

Схема пользователя, который не был найден в системе

Name

Description

identity

All of 1 type

UserIdentity

Type: UserIdentity

Идентификатор пользователя
Example
```
{
  "uid": "example",
  "cloud_uid": "example"
}
```

Идентификатор пользователя

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

username

Type: string

Логин пользователя

Example: example

Example

{
  "username": "example",
  "identity": {
    "uid": "example",
    "cloud_uid": "example"
  }
}

TrackerEnumField

Поле перечисления из Яндекс Трекера

Name

Description

display

Type: string

Отображаемое значение поля

Example: example

key

Type: string

Ключ значения поля

Example: example

Example

{
  "display": "example",
  "key": "example"
}

CellSchema

Ячейка динамической таблицы.

Name	Description
column_slug	Type: string Слаг столбца. Example: `example`
row_id	Type: string Идентификатор строки. Example: `example`
value	Any of 10 types Type: integer Type: number Type: boolean Type: string Example: `example` TicketSchema Type: TicketSchema Схема задачи из Яндекс Трекера Example `{ "key": "example", "resolved": true }` Type: string[] Example `[ "example" ]` Type: array Any of 2 types UserSchema Type: UserSchema Информация о пользователе Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }` UnresolvedUserSchema Type: UnresolvedUserSchema Схема пользователя, который не был найден в системе Example `{ "username": "example", "identity": { "uid": "example", "cloud_uid": "example" } }` Example `[ { "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" } ]` UserSchema Type: UserSchema Информация о пользователе Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }` UnresolvedUserSchema Type: UnresolvedUserSchema Схема пользователя, который не был найден в системе Example `{ "username": "example", "identity": { "uid": "example", "cloud_uid": "example" } }` TrackerEnumField Type: TrackerEnumField Поле перечисления из Яндекс Трекера Example `{ "display": "example", "key": "example" }` Значение ячейки в формате, соответствующем типу столбца. Example: `0`

Example

{
  "row_id": "example",
  "column_slug": "example",
  "value": 0
}

Была ли статья полезна?

Удалить столбцы

Переместить строки