Статті на: Інтеграції

Інтеграція з Gmail та Google-диском

Інтеграція Dilovod з акаунтом Google призначена для відправки документів на Google Диск або електронну пошту Gmail прямо із Вашої бази даних Dilovod.


Налаштування інтеграції з Google виконується у два етапи. Спочатку необхідно створити та налаштувати проєкт у Google Cloud Console, а потім додати отримані налаштування в Dilovod і підключити облікові записи Google.


Налаштування Google Cloud для інтеграції з Dilovod


1.Створення проєкту


  1. Відкрийте Google Cloud Console.
  2. Під час першого входу до Google Cloud Console прийміть умови використання сервісу, якщо з’явиться відповідний запит.



  1. У верхній частині сторінки відкрийте список проєктів і натисніть «New Project» (Новий проєкт).



  1. У полі назви проєкту вкажіть назву, наприклад Dilovod.
  2. Натисніть «Create» (Створити) і дочекайтеся завершення створення проєкту.



  1. Переконайтеся, що у верхній частині консолі вибрано створений проєкт «Dilovod». Двічі клацніть мишею по створеному проєкту «Dilovod». Після цього замість «Select Project» у верхній частині консолі має відображатися назва вибраного проєкту «Dilovod».



2. Увімкнення API


  1. У лівому верхньому куті натисніть меню навігації «Navigation menu» (☰).



  1. Виберіть «API & Services», а потім у підменю натисніть «Library».



  1. У бібліотеці API знайдіть і ввімкніть потрібні API:
  • У рядку пошуку введіть «Gmail API» та відкрийте відповідний результат.
  • Натисніть «Enable».



  • Поверніться до бібліотеки API та повторіть ті самі дії для «Google Drive API».




3. Налаштування екрана згоди (Google Auth platform)


  1. У меню «Navigation menu» (☰) відкрийте «API & Services» ► «ОАuth consent screen».



  1. Якщо платформу ще не налаштовано, натисніть «Get started».



  1. Налаштування «Branding». Заповніть такі поля:
  • «App name» — назва застосунку, яку користувач побачить під час надання доступу, наприклад Dilovod.
  • «User support email» — контактна адреса електронної пошти для підтримки користувачів.
  • «Audience» — виберіть «External».
  • «Developer contact email» — адреса електронної пошти для отримання сповіщень від Google.



  1. Відкрийте вкладку «Data Access», натисніть «Add or remove scopes» і додайте лише такі дозволи:



  • gmail.modify — створення чернеток Gmail;



  • drive.file — збереження на Диск файлів, створених цим застосунком.



  1. Збережіть зміни.


4. Налаштування тестових користувачів


  1. Відкрийте вкладку «Audience».
  2. У блоці «Test users» натисніть «Add users».
  3. Введіть адресу Google, яку плануєте підключати в Dilovod, і збережіть зміни.



Якщо адреси немає у списку тестових користувачів, Google не дозволить підключити цей обліковий запис. У режимі «Testing» доступний лише для доданих тестових користувачів. Можна додати до 100 тестових користувачів.


5. Створення OAuth-клієнта


  1. Відкрийте «Google Auth platform» ► «Clients» (або «Credentials», якщо цей розділ доступний у вашій консолі).
  2. Натисніть «Create client» або «Create credentials»



  1. У полі «Application type» виберіть «Web application».



  1. У полі «Name» вкажіть назву клієнта, наприклад Dilovod Web.



  1. У блоці «Authorized JavaScript origins» натисніть «Add URI» та вкажіть адресу Dilovod — протокол і домен без додаткового шляху, https://dilovod.ua.
  2. У блоці «Authorized redirect URIs» натисніть «Add URI» та вкажіть адресу перенаправлення, надану для інтеграції. Якщо для вашого налаштування використовується та сама адреса, вкажіть https://dilovod.ua.
  3. Натисніть «Create».



Після створення OAuth-клієнта збережіть такі дані:

  • Client ID — ідентифікатор клієнта.
  • Client Secret — секретний ключ клієнта.




Підключення Google до Dilovod


Щоб додати Client ID та Client Secret у Dilovod, відкрийте розділ

Сервіс ► Підключення до зовнішніх сервісів ► Додати підключення ► Google


Для налаштування підключення заповніть такі поля:

  • «Найменування» — довільна назва підключення для зручної ідентифікації, наприклад «Google».
  • «Client ID» — ідентифікатор OAuth-клієнта, отриманий у Google Cloud Console.
  • «Secret» — секретний ключ клієнта (Client Secret), створений у Google Cloud Console.



.Натисніть «Зберегти і закрити», щоб зберегти налаштування підключення.


Наступний крок — підключення облікового запису Google до бази даних Dilovod


  1. Відкрийте Налаштування користувача
  2. Перейдіть на вкладку «Облікові записи» та натисніть «Додати».



  1. Із переліку облікових записів оберіть той, який потрібно використовувати для відправки документів:




  1. У вікні, що відкрилося, натисніть «Продовжити».



  1. Надайте необхідні дозволи для dilovod.ua. Прокрутіть вікно вниз і натисніть «Продовжити».



  1. Обліковий запис додано у список



  1. Натисніть «Зберегти і закрити»


Доступ у режимі «Testing» діє 7 днів, після чого обліковий запис Google потрібно повторно підключити в Dilovod.



Відправлення документів із Dilovod


Після налаштування інтеграції з Google виконайте такі дії, щоб надіслати документ із Dilovod на Gmail або Google Диск.


  1. Сформуйте друковану форму документа, який потрібно відправити:



  1. Натисніть «Надіслати» у верхній частині екрана та виберіть, куди потрібно надіслати документ: на електронну пошту Gmail або на Google Диск.



  1. У вікні надсилання документа в Gmail автоматично заповнюються дані вашого облікового запису та інформація про отримувача, зокрема його e-mail, якщо його зазначено в картці отримувача. При відправці на Google-диск або ел.пошту (Gmail) можливо обрати формат файлу - PDF, XLSX або CSV. Натисніть команду «Підготувати до відправки».



  1. Після натискання команди «Підготувати до відправки» відкриється Gmail із сформованою чернеткою листа, до якого буде прикріплений файл документа. За потреби додайте текст листа та надішліть його контрагенту.



Якщо документ надсилається на Google Диск, відкриється вікно з додатковими налаштуваннями. Щоб надати доступ до файлу за посиланням, установіть прапорець «Відкрити доступ за посиланням». У такому разі файл буде доступний для публічного перегляду. Посилання на файл автоматично додасться до розділу «Файлове сховище». Щоб зберегти документ на Google Диск, натисніть команду «Зберегти».



Посилання на файл можна відкрити у вкладці «Файли» або за допомогою команди «Пов'язані документи».


Оновлено: 21/10/2026

Чи була ця стаття корисною?

Поділіться своїм відгуком

Скасувати

Дякуємо!