Інтеграція з Google

Підключення Google-сервісів: вхід через Google, календар, контакти, диск.

Інтеграції з Google (Календар, Контакти, вибір файлів з Google Диска, маршрути на картах, індексація сайту) працюють через ваш власний проєкт у Google Cloud. Система підключається до нього за протоколом OAuth 2.0 або за ключем API. Налаштування робить адміністратор один раз.

Де знаходиться

Робочий стіл → «Інтеграції» → у лівій панелі, розділ «Google» → «Налаштування Google» (або через пошук Ctrl+K: «Налаштування Google»). Там же - «Google Календар» і «Google Контакти». Розділ видно користувачам з роллю системного адміністратора.

Поля форми:

• Увімкнути - загальний перемикач інтеграції;
• Ідентифікатор клієнта і Секрет клієнта (розділ «Ідентифікатор клієнта OAuth») - для Календаря, Контактів та індексації сайту;
• Ключ API - для карт і вибору файлів з Google Диска;
• Вибір із Google Диска ввімкнено і App ID - щоб у вікні «Вкладення» з'явилась кнопка вибору файлу з Google Диска.

Календар, Контакти, індексація

1. У Google Cloud Console створіть проєкт.
2. У бібліотеці API увімкніть потрібні: Google Calendar - Calendar API, Google Контакти - People API, індексація сайту - Indexing API.
3. У розділі APIs & Services → Credentials натисніть Create credentials → OAuth client ID, тип застосунку Web application.
4. В Authorized JavaScript origins додайте адресу вашої системи, наприклад https://company.erp.ua-pro.net.
5. В Authorized redirect URIs додайте дві адреси (замість company.erp.ua-pro.net - ваша):
   • для Календаря: https://company.erp.ua-pro.net?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback
   • для решти служб: https://company.erp.ua-pro.net/api/method/frappe.integrations.google_oauth.callback
6. Скопіюйте Client ID і Client Secret у «Налаштування Google», поставте «Увімкнути» і збережіть.

Далі кожна служба підключається у своїй формі:

• Google Календар: «Створити», вкажіть «Назва календаря» і «Користувач», натисніть «Дозволити доступ до Google Календаря», потім оберіть напрям: «Отримати з Google Calendar» і/або «Надіслати в Google Calendar».
• Google Контакти: вкажіть «Адреса електронної пошти», натисніть «Дозволити доступ до Google Контактів», оберіть «Отримати з Google Contacts» і/або «Надіслати в Google Contacts».

Пошта Gmail через OAuth підключається не тут, а через «Підключений застосунок» в обліковому записі електронної пошти. Найпростіше - звичайний вхід з паролем застосунку.

Карти (маршрути доставки)

Ключ API потрібен лише для розрахунку маршрутів у документі «Рейс доставки» (Directions API). Для інших функцій він не обов'язковий.

1. У тому самому проєкті Google Cloud увімкніть Directions API і створіть ключ: Create credentials → API key.
2. Вставте ключ у поле «Ключ API» в «Налаштування Google» і збережіть.