Google Documents

Как подготовить Google Документ

В нужном документе переходим в настройки доступа, где меняем общий доступ на “всех, у кого есть ссылка” и присваиваем право “редактор”.

Как работать через свой сервисный аккаунт

По умолчанию конструктор работает с собственными сервисными аккаунтами для доступа к вашим документам. Поэтому вам необходимо выдавать доступ на редактирование по ссылке. Чтобы обеспечить достаточный уровень безопасности, вы можете передавать json с аутентификационными данными.

Подробно процесс подключения сервисного аккаунта описан тут

Подключайте сервис Google Docs API и переходите к настройке самого документа

После предоставления доступа через сервисный аккаунт нашему боту создаем и подготавливаем к работе шаблон документа.

Как создать новый Google-документ из бота

Для создания нового документа из Salebot воспользуйтесь функцией gd_create_new_doc(title, google_email), где

1. title - название нового документа, строка

2. 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), где:

1. doc_id - идентификатор документа, строка (например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)

2. 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(doc_id, text), где

1. doc_id - идентификатор документа, строка (например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)

2. 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), где:

1. doc_id - идентификатор документа, строка(например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)

2. text_array - словарь, в котором ключи - это текст, который надо заменить, а значение - текст, которым заменяют

3. 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"}) и видим, как изменился документ.

Как вставить изображение в конец 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), где:

1. doc_id - идентификатор документа, строка(например, 1pgC9TFC6P6tUse6KwmFFzmAmj0bhU3fwW8hIvJwXJ_M)

2. type - тип для скачивания, необязательный параметр. По умолчанию документ сформирует ссылку на скачивание в формате ‘.doc’. Если указать ‘pdf’, то документ сформирует ссылку на скачивание в формате ‘.pdf’

Пример: save_doc = save_google_doc('1UfOZ5-AXb-QRAs7Gev9tv_H3Cx5JuWbFeeHq48CEyAY')

Результат выполнения функции - ссылка на документ

Остается его скачать.