> For the complete documentation index, see [llms.txt](https://core4.gitbook.io/botpad/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://core4.gitbook.io/botpad/integracii-bota/google-sheets.md).

# Google Sheets

{% hint style="warning" %}
Важно помнить, что компания Google является иностранной, серверы компании расположены вне территории РФ. Таким образом, при внесении данных российскими пользователями происходит трансграничная передача персональных данных. Учитывайте это, если подразумевается обработка персональных данных
{% endhint %}

<figure><img src="/files/VauSiGDJYTjfH1mp7wp1" alt=""><figcaption><p>Старница интеграции с Google Sheets</p></figcaption></figure>

**Порядок интеграции с Гугл.Таблицами**

* Изучите руководство от [Google](https://support.google.com/docs/answer/6000292?hl=ru\&co=GENIE.Platform%3DDesktop) или любое понятное вам в интернете
* Создайте проект в [Google Cloud Console](https://console.cloud.google.com/)
* [Включите](https://console.cloud.google.com/apis/api/sheets.googleapis.com/metrics) Google Sheets API
* [Создайте](https://console.cloud.google.com/iam-admin/serviceaccounts/create) учетные данные (credentials) и скачайте файл JSON с этими данными
* Откройте в браузере таблицу [Google Sheets](https://docs.google.com/spreadsheets/u/0/), в которой вы хотите  хранить результаты
* Посмотрите на адресную строку. URL будет выглядеть примерно так:\
  <https://docs.google.com/spreadsheets/d/><mark style="color:green;">**1bX5d7w8-aBcDeFgHiJkLmNopQrStUvWxyz12345678**</mark>/edit#gid=0\
  ID таблицы — это часть URL между /d/ и /edit. В данном примере это <mark style="color:green;">1bX5d7w8-aBcDeFgHiJkLmNopQrStUvWxyz12345678</mark>
* Скопируйте **ID** из предыдущего пункта и вставьте **в поле «ID таблицы»**
* В поле **«Файл JSON:»** укажите путь к скачанному JSON файлу настроек на вашем компьютере (вероятно в папке «Загрузки»)
* Нажмите кнопку **«Добавить»**
* Если не будет сообщения об ошибке, в разделе **«Подключенные таблицы:» появится** информация о подключенной таблице, там можно удалить подключение при необходимости
* <mark style="color:red;">**НЕ ЗАБУДЬТЕ!**</mark>**&#x20;В настройках таблицы** выдайте права **«Редактор»** для ранее указанного адреса (его можно увидеть в JSON файле в параметре "client\_email", примерно такого вида: *"имя-клиента@название-таблицы.iam.gserviceaccount.com"*,)

### **Тоже самое, но более подробно, со скриншотами:**

**Откройте** [**Google Cloud Console**](https://console.cloud.google.com/)

<figure><img src="/files/HfXKCpa7LmGXA8laSrZ1" alt=""><figcaption></figcaption></figure>

**При необходимости создайте новый проект**

<figure><img src="/files/VyWAbBaPhjzgqz8fasnT" alt=""><figcaption><p>Создание нового проекта</p></figcaption></figure>

[**Включите**](https://console.cloud.google.com/apis/api/sheets.googleapis.com/metrics) **Google Sheets API если он выключен**

<figure><img src="/files/N4O8ajWO5oCcsRND7dTP" alt=""><figcaption><p>Включение API</p></figcaption></figure>

[**Создайте**](https://console.cloud.google.com/iam-admin/serviceaccounts/create) **учетные данные (credentials) и скачайте файл JSON с этими данными**

<figure><img src="/files/FSO6IYnjas9k8fpEhByr" alt=""><figcaption><p>Создание файла</p></figcaption></figure>

{% hint style="info" %}
Обратите внимание! Для этого аккаунта «Service account ID»/**«Аккаунт ID»**, в следующих пунктах, нужно будет выдать разрешение на запись в таблицу! Его можно будет увидеть в полученном файле, но лучше запомните как он выглядит или запишите!
{% endhint %}

**Откройте в браузере таблицу** [**Google Sheets**](https://docs.google.com/spreadsheets/u/0/)**, в которой вы хотите  хранить результаты**

<figure><img src="/files/VY423I0p8UXZVJD0OZX6" alt=""><figcaption><p>Выделен ID таблицы</p></figcaption></figure>

* Посмотрите на адресную строку. URL будет выглядеть примерно так:\
  <https://docs.google.com/spreadsheets/d/><mark style="color:green;">**1bX5d7w8-aBcDeFgHiJkLmNopQrStUvWxyz12345678**</mark>/edit#gid=0\
  ID таблицы — это часть URL между /d/ и /edit. В данном примере это <mark style="color:green;">1bX5d7w8-aBcDeFgHiJkLmNopQrStUvWxyz12345678</mark>
* Скопируйте **ID** из предыдущего пункта и вставьте **в поле «ID таблицы»**
* В поле **«Файл JSON:»** укажите путь к скачанному JSON файлу настроек на вашем компьютере (вероятно в папке «Загрузки»)
* Нажмите кнопку **«Добавить»**
* Если не будет сообщения об ошибке, в разделе **«Подключенные таблицы:» появится** информация о подключенной таблице, там можно удалить подключение при необходимости
* <mark style="color:red;">**НЕ ЗАБУДЬТЕ!**</mark>**&#x20;В настройках таблицы** выдайте права **«Редактор»** для ранее указанного адреса (его можно увидеть в JSON файле в параметре "client\_email", примерно такого вида: *"имя-клиента@название-таблицы.iam.gserviceaccount.com"*,)
