Difference between revisions of "Qubot Google Sheets Setup"

From QuData
Jump to navigation Jump to search
Line 55: Line 55:
  
 
Set up data loading to a spreadsheet in the bot editor. Additional information about this can be found in the bot editor templates (e.g. Trivia, Order Food templates) or in our help center.
 
Set up data loading to a spreadsheet in the bot editor. Additional information about this can be found in the bot editor templates (e.g. Trivia, Order Food templates) or in our help center.
== Setting up work with Google Spreadsheet data in a bot ==
 
  
Choose the bot you need. Go to the bot's Editor.
+
== How to set up Google Spreadsheet data in a bot ==
  
'''Loading data from a table'''
+
Choose the required bot and go to the Editor.
  
1. Select the desired step in your bot where you want to load data from the google spreadsheet (For example, Main)
+
'''Loading data from a spreadsheet'''
 +
 
 +
1. Select a step in your bot to download data from the Google Sheets (for example, Main).
 
<br>
 
<br>
 
<br>
 
<br>
Line 67: Line 68:
 
<br>
 
<br>
 
<br>
 
<br>
2. Select/create an element whose action should be to load data from the table. It can be Buttons, Actions element, just user input (click to show actions when) and other elements.
+
2. Select/create an element to have its action load data from the spreadsheet. It can be buttons, actions or just entering any text by the user (click to show actions when) and other elements.
 
<br>
 
<br>
 
<br>
 
<br>
 
[[File:EditorGoogleSheet2.png|250px]]  [[File:EditorGoogleSheet3.png|250px]]
 
[[File:EditorGoogleSheet2.png|250px]]  [[File:EditorGoogleSheet3.png|250px]]
 
<br>
 
<br>
3. In the Item properties field you will be able to add a property:
+
3. In the Item properties field you can add a property:
 
<br>
 
<br>
 
<br>
 
<br>
Line 83: Line 84:
 
<br>
 
<br>
 
<br>
 
<br>
5. В свойстве load выберите из списка Google Sheets
+
5. In the load property  select Google Sheets from the list
 
<br>
 
<br>
 
<br>
 
<br>
Line 89: Line 90:
 
<br>
 
<br>
 
<br>
 
<br>
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
+
6. In the Google Sheets table url field enter the url (link) of your Google Sheet
 
<br>
 
<br>
 
<br>
 
<br>
Line 97: Line 98:
 
[[File:EditorGoogleSheet9.png|400px]]
 
[[File:EditorGoogleSheet9.png|400px]]
 
<br>
 
<br>
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
+
7. In the Slot name field enter the name of the variable that will store data from your spreadsheet as an array of objects:
 
<br>
 
<br>
 
<br>
 
<br>
Line 103: Line 104:
 
<br>
 
<br>
 
<br>
 
<br>
Используйте эту переменную для работы с вашими данными.
+
Use this variable to work with your data.
  
'''''Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы'''''
+
'''''Make sure you give access to view or edit your spreadsheet'''''
  
'''Запись данных в таблицу'''
+
'''Sending data to a spreadsheet'''
  
Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.
+
Go through steps 1-3 described above in "Loading data from a spreadsheet" and choose a step where to send data to the spreadsheet.
  
4. Выберите свойство save:
+
4. Select the save property:
 
<br>
 
<br>
 
<br>
 
<br>
Line 117: Line 118:
 
<br>
 
<br>
 
<br>
 
<br>
5. В свойстве save выберите из списка Google Sheets
+
5. In the save property select Google Sheets from the list
 
<br>
 
<br>
 
<br>
 
<br>
Line 123: Line 124:
 
<br>
 
<br>
 
<br>
 
<br>
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
+
6. In the Google Sheets table url field enter the url (link) of your Google Sheet
 
<br>
 
<br>
 
<br>
 
<br>
Line 131: Line 132:
 
[[File:EditorGoogleSheet13.png|400px]]
 
[[File:EditorGoogleSheet13.png|400px]]
 
<br>
 
<br>
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
+
7. In the Data value field enter the data that will be sent to the spreadsheet in the specified format as an object:
 
<br>
 
<br>
 
[[File:EditorGoogleSheet14.png|250px]]  [[File:EditorGoogleSheet15.png|250px]]
 
[[File:EditorGoogleSheet14.png|250px]]  [[File:EditorGoogleSheet15.png|250px]]
 
<br>
 
<br>
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''
+
'''''Make sure you give access to edit your spreadsheet'''''
 
[[Category:Qubot]]
 
[[Category:Qubot]]

Revision as of 07:17, 29 June 2022

Connecting Google Sheets to a Bot

By connecting your Google spreadsheets to the bot, your bot experience will improve significantly. For example, your bot will be able to download data directly from your Google spreadsheet, as well as upload new data in real time. Using Google Sheets will make your work much easier, because you will have direct access to read and edit the saved data at any time without interfering with the bot code.

The instructions below will help you to share Google spreadsheets:

Step 1

Sign in or create an account at https://accounts.google.com

GoogleSheets1.png

Step 2

Open your Google Sheets here https://docs.google.com/spreadsheets

You can also access your Google Sheets from the Google homepage(https://www.google.com/) by clicking the Google apps button.

GoogleSheets2.png GoogleSheets3.png

Step 3

Share the Google Spreadsheet with your bot:

In your Google Sheets, open a spreadsheet and click the Share button.

GoogleSheets4.png

Share the access in any of the possible ways. First way. Share with a specific account: copy the following account into the input field of the sharing window and send the invitation.

qudata-bot-service@qudata-services.iam.gserviceaccount.com

GoogleSheets5.png

Second way. Get shareable link: in the Get link section change status Restricted to Anyone with the link, and click Done.

GoogleSheets6.png

Please note that you can control the access: if the bot will only read data from Google spreadsheet, then the Viewer role is enough, and if the bot will also save data to Google spreadsheet, then the Editor role is required. You can change the role at any time in the sharing settings.

Step 4

Set up data loading to a spreadsheet in the bot editor. Additional information about this can be found in the bot editor templates (e.g. Trivia, Order Food templates) or in our help center.

How to set up Google Spreadsheet data in a bot

Choose the required bot and go to the Editor.

Loading data from a spreadsheet

1. Select a step in your bot to download data from the Google Sheets (for example, Main).

EditorGoogleSheet1.png

2. Select/create an element to have its action load data from the spreadsheet. It can be buttons, actions or just entering any text by the user (click to show actions when) and other elements.

EditorGoogleSheet2.png EditorGoogleSheet3.png
3. In the Item properties field you can add a property:

EditorGoogleSheet4.png EditorGoogleSheet5.png
4. Select the load property:

EditorGoogleSheet6.png

5. In the load property select Google Sheets from the list

EditorGoogleSheet7.png

6. In the Google Sheets table url field enter the url (link) of your Google Sheet

EditorGoogleSheet8.png

EditorGoogleSheet9.png
7. In the Slot name field enter the name of the variable that will store data from your spreadsheet as an array of objects:

EditorGoogleSheet10.png

Use this variable to work with your data.

Make sure you give access to view or edit your spreadsheet

Sending data to a spreadsheet

Go through steps 1-3 described above in "Loading data from a spreadsheet" and choose a step where to send data to the spreadsheet.

4. Select the save property:

EditorGoogleSheet11.png

5. In the save property select Google Sheets from the list

EditorGoogleSheet12.png

6. In the Google Sheets table url field enter the url (link) of your Google Sheet

EditorGoogleSheet8.png

EditorGoogleSheet13.png
7. In the Data value field enter the data that will be sent to the spreadsheet in the specified format as an object:
EditorGoogleSheet14.png EditorGoogleSheet15.png
Make sure you give access to edit your spreadsheet