В этом курсе описывается коробочная версия портала Битрикс24 Облачная и коробочная версии Битрикс24 имеют свои плюсы и минусы, связанные с их функционалом, безопасностью, обслуживанием, лицензированием и др.
Различия облачного и коробочного Битрикс24 . Одним из её преимуществ является возможность установки на выбранном вами сервере хостера или в локальной сети. Но Google Docs - онлайн сервис (облачный сервис, SaaS). Он доступен из глобальной сети, поэтому его политика безопасности постоянно корректируется и ужесточается. В связи с этим, при настройке внешней авторизации вы можете получить запрос на верификацию вашего приложения (портала Битрикс24).

Есть два варианта решения этой ситуации:

• Вариант 1. Вы можете не проходить процедуру верификации. Тогда вам придется каждый раз переходить по ссылке Дополнительные настройки и давать разрешение на доступ.
• Вариант 2. Верифицировать ваше приложение. Для этого нужно:
  • заполнить форму на вкладке Окно запроса доступа OAuth. В форме нужно указать данные вашего приложения (портала Битрикс24) - название, логотип, адрес техподдержки.
  • Обязательно указать Области действия для API Google.

    

  • В список используемых скоупов Скоуп - содержание и область действия функции.
    См. Полный список скоупов Google. рекомендуется включать:

    - https://www.googleapis.com/auth/userinfo.email и https://www.googleapis.com/auth/userinfo.profile - используются для базовой авторизации и привязки аккаунта Google к аккаунту Битрикс24

    - https://www.googleapis.com/auth/calendar - используется для интеграции календаря в Битрикс24 с Google Calendar

    - https://www.googleapis.com/auth/drive - используется для загрузки файлов Google Drive в Битрикс24 и для редактирования документов из Битрикс24 в Google Docs.

    - https://mail.google.com/ и email - используются для работы веб-интерфейса почты внутри Битрикс24.

  • Даже если вы не используете что-то из перечисленного у себя в коробочном портале, лучше указать все возможности, чтобы не проходить верификацию повторно. Если у вас есть какие-то свои дополнения на основе Google API к функционалу коробки, их тоже нужно здесь указать и описать.
  • После заполнения формы нужно подождать ответа от техподдержки Google. Обычно это 2-3 рабочих дня. Техподдержка Google может прислать вам инструкции о том, что вам необходимо изменить или настроить на сайте, чтобы использовать ваше OAuth-приложение.
    
    

    Пример инструкции от техподдержки Google

    Dear Developer, Thank you for submitting an OAuth App Verification request. It appears that your homepage URL https://mysite.ru/ is a login screen, which restricts public access to your app's information and intent. Google requires that your homepage accurately represents your app’s identity to users. If your app requires a log in, we recommend that you place the limited access sign-in procedure on a separate web page. If your app is meant to be available to the public, please make sure that your app’s homepage URL features content associated with your brand, accurately represents your true identity, and clearly describes the functionality of your app. If you need to update the homepage URL linked to your OAuth Consent Screen, you can do the following: Sign-in to Google Cloud Console Select the project ID: my_site_ru Go to Credentials on OAuth consent screen Enter the homepage URL Click Submit If your app is meant to be internal, please let us know by replying to this email. We will then close your case so that you are able to update your project from public to internal. To update your project fr om public to internal: Sign-in to Google Cloud Console Select the project ID: my_site_ru Go to Credentials on OAuth consent screen Go to Application Type Select Internal Click Save In addition, you will need to associate your project with your organization: If you have not already done so, create an Organization by following the Quickstart Using Organizations instructions. Migrate the project into the organization you created as shown in Migrating Existing Projects into the Organization. Once you have associated your project with your organization, you and the project users in your organization can use the app to directly access OAuth scopes. No verification will be required. Please reply to this email once you have made the appropriate updates to your site and/or your OAuth Consent Screen so that we may continue with the verification process. Note that any new email sent to api-oauth-dev-verification@google.com will not be received by our team. You can find more information in the OAuth Application Verification FAQ. If you have additional questions, please respond to this email.

  • В случае, если техподдержка Google начнет настоятельно требовать перейти со скоупа https://mail.google.com/ на https://www.googleapis.com/auth/gmail.readonly, можно ответить, что такой возможности нет, поскольку веб-интерфейс работает по протоколу IMAP, для которого требуется токен со скоупом https://mail.google.com/.
  • После подтверждения все заработает, но в будущем может потребоваться повторное подтверждение, если Google будет менять настройки приложения, или если Битрикс будет выпускать новые возможности интеграции с Google. Потому данные заполнения формы лучше сохранить, чтобы не сочинять их потом заново.

Опция Включить работу с документами через внешние службы (Google Docs, MS Office Web Apps и другие) находится в настройках модуля Библиотека документов (Настройки > Настройки продукта > Настройки модулей > Библиотека документов).