Google Documents
бесплатный онлайн-офис, разрабатываемый компанией Google. Позволяет работать с файлами
Как подготовить Google Документ
В нужном документе переходим в настройки доступа, где меняем общий доступ на “всех, у кого есть ссылка” и присваиваем право “редактор”.
Как работать через свой сервисный аккаунт
По умолчанию конструктор работает с собственными сервисными аккаунтами для доступа к вашим документам. Поэтому вам необходимо выдавать доступ на редактирование по ссылке. Чтобы обеспечить достаточный уровень безопасности, вы можете передавать json с аутентификационными данными.
В Google Документах есть лимиты на количество запросов в единицу времени. Чтобы не зависеть от лимитов, вы можете использовать сервисный аккаунт.
Подробно процесс подключения сервисного аккаунта описан тут
Подключайте сервис Google Docs API и переходите к настройке самого документа
После предоставления доступа через сервисный аккаунт нашему боту создаем и подготавливаем к работе шаблон документа.
Функции для работы с Google-документами используйте только при работе через сервисный аккаунт. Это позволит избежать необходимость повторной авторизации
Как создать новый Google-документ из бота
Для создания нового документа из Salebot воспользуйтесь функцией gd_create_new_doc(title, google_email), где
title - название нового документа, строка
google_email - ваша почта google, с которой Вы будете просматривать документ, строка.
Поскольку функция работает через сервисный аккаунт, то в результате выполнения функции права создателя документа будут у данного аккаунта. Функция автоматически выдаст права редактора указанному google_email и новый документ будет доступен для редактирования.
Пример: gd_create_new_doc('Новый документ. Да-да', 'googlemailtest@gmail.com')
В случае успешного исполнения функции будет создан новый документ, который вы увидите авторизовавшись под указанным в функции google_email.
Результат выполнения функции - словарь, содержащий статус исполнения функции, имя и ид вновь созданного документа
{"status":true,"message":"Google document Новый документ. Да-да, id 1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY is created"}
Как скопировать существующий Google-документ
Чтобы скопировать существующий документ, воспользуйтесь функцией gd_copy(doc_id, google_email), где:
doc_id - идентификатор документа, строка (например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)
google_email - ваша почта google, с которой Вы будете просматривать документ, строка.
Поскольку функция работает через сервисный аккаунт, то в результате выполнения функции права создателя документа будут у данного аккаунта. Функция автоматически выдаст права редактора указанному google_email и новый документ будет доступен для редактирования.
Пример: result_copy = gd_copy('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY', 'googlemailtest@gmail.com')
В случае успешного исполнения функции будет создана копия документа, id которого вы указали. Документ вы увидите авторизовавшись под указанным в функции google_email.
Результат выполнения функции - словарь, содержащий статус исполнения функции и ид копии документа
{"status":true,"message":"document 13eufZJVlFT64tujOOInTZfAExOW1PpqSZhLupj_PT1U successfully created"}
Как вставить текст в конец Google-документа
Для вставки текста в конец документа используйте функцию gd_add_text(doc_id, text), где
doc_id - идентификатор документа, строка (например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)
text - текст для вставки. Если документ пустой, текст добавится в его начало. Если документ заполнен, текст вставится с нового абзаца в самом конце.
Пример: result_add_text = gd_add_text('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY','Это же был чистый документ, верно? Ну вот, теперь здесь есть новая фраза!')
В случае успешного исполнения функции в ваш документ будет добавлен текст, указанный в функции.
Результат выполнения функции - словарь, содержащий уведомление об успехе {"status":true,"message":"document 1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY successfully updated"}
Как заменить части текста Google-документа
Эта функция будет полезна тем, у кого есть готовый шаблон документа, в котором нужно заменить некоторые части. gd_replace_text(doc_id, text_array, match_case), где:
doc_id - идентификатор документа, строка(например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)
text_array - словарь, в котором ключи - это текст, который надо заменить, а значение - текст, которым заменяют
match_case - необязательная переменная. Если указать ее, равной 1, то поиск будет выполнен в строгом соответствии с указанным регистром. По умолчанию регистр не учитывается.
Обратите внимание! В словаре с данными для замены используются только двойные кавычки.
Пример: У нас есть текст-заготовка для анкетирования.
name ='Одинсон Локи Лафейсон' phone = 79004443322 array = {"company":"ООО АСГАРД","fio": "#{name}","phone_number": "#{phone}","address":"Асгард, дворцовая улица, Палас 1","message":"Эй, пс. Не хочешь поговорить о Локи?"} new_doc = gd_replace_text('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY',array, 0) new_doc = gd_replace_text('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY',array, 0)
Результат выполнения функции - словарь, содержащий уведомление об успехе
({"status":true,"message":"document 1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY successfully updated"}) и видим, как изменился документ.
Совет! Если используете шаблон, сначала копируйте, а затем вносите изменения в копию - правки, которые вносятся через Salebot, нельзя откатить обратно через документы.
Как вставить изображение в конец Google-документа
Воспользуйтесь функцией gd_add_image(doc_id, img_url), где doc_id - идентификатор документа, строка(например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M) img_url - ссылка на изображение, например, "https://cdn.sstatic.net/Sites/stackoverflow/company/img/logos/so/so-logo.png"
Пример: add_immage_to_doc= gd_add_image('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY','https://giknutye.r u/wp-content/uploads/2017/02/loki-6.jpg')
Результат выполнения функции - словарь, содержащий уведомление об успехе
{"status":true,"message":"Image https://giknutye.ru/wp-content/uploads/2017/02/loki-6.jpg added to document 1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY"}
Как получить ссылку для сохранения Google-документа
Вы можете запросить ссылку на скачивание нужного документа в формате doc или pdf. Воспользуйтесь функцией save_google_doc(doc_id, type), где:
doc_id - идентификатор документа, строка(например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)
type - тип для скачивания, необязательный параметр. По умолчанию документ сформирует ссылку на скачивание в формате ‘.doc’. Если указать ‘pdf’, то документ сформирует ссылку на скачивание в формате ‘.pdf’
Пример: save_doc = save_google_doc('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY')
Результат выполнения функции - ссылка на документ
Остается его скачать.
Last updated
