> 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"*,)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://core4.gitbook.io/botpad/integracii-bota/google-sheets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.