Difference between revisions of "Qubot Google Sheets Setup/ru"
Mkuznetsov (talk | contribs) |
|||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<span id="qubot-google-sheets-setup"></span> | <span id="qubot-google-sheets-setup"></span> | ||
{{TOCright}} | {{TOCright}} | ||
| − | == | + | == Подключение Google таблиц к боту == |
Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например, | Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например, | ||
| Line 61: | Line 61: | ||
Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно | Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно | ||
найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре. | найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре. | ||
| + | |||
== Настройка работы с данными Google таблиц в боте == | == Настройка работы с данными Google таблиц в боте == | ||
| Line 141: | Line 142: | ||
[[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]] | [[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]] | ||
<br> | <br> | ||
| + | '''''Убедитесь, что вы дали доступ на редактирование своей таблицы''''' | ||
| + | |||
| + | == Работа с фильтрами == | ||
| + | |||
| + | В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры.<br> | ||
| + | Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... }<br> | ||
| + | В одном фильтре можно указывать несколько столбцов.<br> | ||
| + | Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные. | ||
| + | |||
| + | '''Выборочная загрузка данных с таблицы''' | ||
| + | |||
| + | 1. Настройте вашего бота на загрузку данных согласно инструкции выше.<br> | ||
| + | 2. Укажите в поле Data filter фильтр в виде словаря.<br> | ||
| + | [[File:GoogleSheets16.png|350px]]<br> | ||
| + | 3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым.<br> | ||
| + | |||
| + | |||
| + | '''Изменение данных в таблице''' | ||
| + | |||
| + | 1. Настройте вашего бота на сохранение данных согласно инструкции выше.<br> | ||
| + | 2. Укажите в поле Data filter фильтр в виде словаря.<br> | ||
| + | [[File:GoogleSheets17.png|350px]]<br> | ||
| + | 3. Данные из таблицы, которые соответствуют фильтру будут изменены.<br> | ||
| + | ''Если фильтр не сработал, то данные записаны не будут''.<br> | ||
| + | |||
| + | |||
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы''''' | '''''Убедитесь, что вы дали доступ на редактирование своей таблицы''''' | ||
[[Category:Qubot]] | [[Category:Qubot]] | ||
Latest revision as of 13:54, 9 August 2022
Подключение Google таблиц к боту
Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например, ваш бот сможет загружать данные прямо из вашей электронной таблицы Google, а также загружать новые данные в режиме реального времени. Использование Google таблиц значительно облегчит вашу работу, поскольку вы будете иметь прямой доступ к чтению и редактированию сохраненных данных в любое время, не вмешиваясь в код бота.
Для подключения таблиц следуйте шагам описанным ниже:
Шаг 1
Войдите или же создайте аккаунт на https://accounts.google.com
Шаг 2
Откройте свои Google таблицы здесь https://docs.google.com/spreadsheets
Вы также можете получить доступ к своим таблицам Google с главной страницы Google, нажав кнопку приложений Google.
Шаг 3
Поделитесь Google таблицей с ботом:
В Google таблицах откройте электронную таблицу и нажмите кнопку Share(Поделиться).
Предоставьте доступ любым из возможных способов.
Первый способ. Поделиться с определенной учетной записью: скопируйте следующую учетную запись в поле ввода окна обмена и отправьте приглашение.
qudata-bot-service@qudata-services.iam.gserviceaccount.com
Второй способ. Ссылка для общего доступа: в разделе Get link(Получить ссылку) измените статус Restricted(ограниченный доступ) на Anyone with the link(все, у кого есть ссылка), и нажать Готово.
Обратите внимание, что вы можете контролировать доступ: если бот будет считывать данные только из таблицы Google,
то достаточно роли Viewer, а если бот еще и сохраняет данные в таблицу Google, то требуется роль Editor.
Вы можете изменить роль в любое время в настройках общего доступа.
Шаг 4
Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре.
Настройка работы с данными Google таблиц в боте
Выберите нужного вам бота. Зайдите в Editor(Редактор) бота.
Загрузка данных с таблицы
1. Выберите нужный шаг в вашем боте где нужно загрузить данные с google таблицы(К примеру Main).
2. Выберите/создайте элемент, действием которого должна быть загрузка данных с таблицы. Это может быть Buttons(кнопка), элемент Actions(действие), просто ввод любого текста пользователем(click to show actions when) и другие элементы.
3. В поле Item properties у вас появится возможность добавить свойство:
4. Выберите свойство load:
5. В свойстве load выберите из списка Google Sheets
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
Используйте эту переменную для работы с вашими данными.
Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы
Запись данных в таблицу
Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.
4. Выберите свойство save:
5. В свойстве save выберите из списка Google Sheets
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
Убедитесь, что вы дали доступ на редактирование своей таблицы
Работа с фильтрами
В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры.
Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... }
В одном фильтре можно указывать несколько столбцов.
Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные.
Выборочная загрузка данных с таблицы
1. Настройте вашего бота на загрузку данных согласно инструкции выше.
2. Укажите в поле Data filter фильтр в виде словаря.
3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым.
Изменение данных в таблице
1. Настройте вашего бота на сохранение данных согласно инструкции выше.
2. Укажите в поле Data filter фильтр в виде словаря.
3. Данные из таблицы, которые соответствуют фильтру будут изменены.
Если фильтр не сработал, то данные записаны не будут.
Убедитесь, что вы дали доступ на редактирование своей таблицы
