Про что статья
В этой статье я кратко опишу процесс подключения любого python-скрипта к API Google Sheets. Чтобы программно можно было редактировать гугл таблицы. Теперь, когда всё прояснили, можно переходить к настройке Google Cloude и созданию необходимых ключей доступа.
Настроим Google Cloud и создадим ключ доступа
И с самого начала я отправлю тебя на другой сайт - https://console.cloud.google.com/. Место от куда мы создадим отдельный проект и подключим к нему соответствующий API для Google Sheets. Тебе конечно же потребуется иметь Google-аккаунт, чтобы войти.
Дальше потребуется создать "проект". Делается это нажатием Ctrl-O или как показано на изображении:
Не забудь, пожалуйста, перейти в созданный ранее проект нажав на его наименование. После чего, потребуется подключить необходимый нам API из библиотеки - Google Sheets.
Найдём требуемый API через поиск.
Нажав на этот API, потребуется его активировать. Нажать кнопку "Enable".
После нажатия ты будешь перенаправлен на страницу управления данным api. Нам осталось только создать соответствующие ключи доступа и скачать их.
Для этого нажми на кнопку "+ Create credentials" и выбери создать "Service Account".
Тебя перенаправят на новую страницу, нужно будет дать имя этому автономному аккаунту плюс предоставить соответствующие разрешения на редактирование таблиц.
Осталось только сгенерировать ключи и скачать их на ту машину, на которой будет запускаться твой python скрипт.
Теперь, когда у нас есть необходимый ключ, необходимо предоставить доступ для редактирования, ранее созданному рабочему аккаунту. Делается это в той таблице, которую необходимо будет редактировать. Об этом дальше.
Делегируем доступ к таблице
Скопируй адрес рабочего аккаунта
А дальше создай соответственно таблицу с которой хочешь работать. После предоставь доступ к рабочему аккаунту, который был создан в предыдущей главе.
Главное убедись в том, что ты выставил правильные разрешения для рабочего аккаунта. Нажми отправить и теперь ты готов использовать данный api для работы с таблицами через python.
Подключим python-скрипт к Google Sheet API
И, как всегда, установим необходимые пакеты в первую очередь. Для этого потребуется создать виртуальное окружение и активировать его. После чего установить следующие пакеты:
- google-api-python-client - для взаимодействия с google sheets api
- google-auth-httplib2 - для возможности аутентифицироваться в экосистеме google
- google-auth-oauthlib - для возможности аутентифицироваться в экосистеме google
- gspread - для простого взаимодействия с таблицами используя python код
Скаченный ранее файл перемести в директорию проекта и переименуй его в более содержательное и простое название, чтобы было легче на него ссылаться из кода.
Импортируем необходимые модули:
Наконец, подключаемся к таблице:
Сейчас поясню. Файл cred.json это твой файл, который ты скачал ранее. Потом идёт sheet_id, это уникальный айдишник для каждой таблицы. Его можно получить открыв требуемую таблицу. Доступ к которой мы предоставляли рабочему аккаунту ранее. Вот здесь:
То есть sheet_id всё что между /d/ и следующим / И да, я люблю звёздные войны :)
Дальше остаётся только обращаться к таблице через переменную sheet и редактировать её под своё усмотрение и требуемые задачи. Например, можно вставить следующих данных:
Так как эта статья не про редактирование самих таблиц, то и разбирать весь функционал gspread я не буду, но направлю на существующую документацию.
Заключение
Google Sheets используются почти везде и почти всеми. Та же история и про Python. По этому не удивительно, что два этих "куска", довольно разного программного обеспечения, легко интегрируются вместе и отлично дополняют друг друга. И тебе не составит никакого труда в дальнейшем использовать это в своих следующих работах.
