Salebot.pro
Search…
⌃K

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('Новый документ. Да-да', '[email protected]')
В случае успешного исполнения функции будет создан новый документ, который вы увидите авторизовавшись под указанным в функции 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', '[email protected]')
В случае успешного исполнения функции будет создана копия документа, id которого вы указали. Документ вы увидите авторизовавшись под указанным в функции google_email.
Результат выполнения функции - словарь, содержащий статус исполнения функции и ид копии документа
{"status":true,"message":"document 13eufZJVlFT64tujOOInTZfAExOW1PpqSZhLupj_PT1U successfully created"}

Как вставить текст в конец Google-документа

Для вставки текста в конец документа используйте функцию gd_add_text(self, 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')
Результат выполнения функции - ссылка на документ
Остается его скачать.