Перейти к основному содержимому

Google Sheets

Этот раздел посвящен библиотеке для работы с API Google Sheets в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы

important

Если вы уже используете ОПИ для работы с другими сервисами Google Workspaсe и выполняли стартовую настройку, то пункты Создание проекта и Настройка OAuth можно пропустить. Необходимо лишь включить сервис Google Sheets в своем проекте и заново получить токен (последние два пункта инструкции).

Начало работы​

Создание проекта​

  1. Перейдите на главную страницу Google Cloud и создайте проект

BF

  1. Выберите созданный проект и в боковом меню перейдите APIs and Services -> OAuth consent screen

BF

  1. Выберите пункт External

BF

  1. Заполните поля App name, User support email и Email addresses (все поля со звездочками)

BF

  1. Нажимайте далее и Save and continue на последней вкладке

BF

  1. Нажмите Publish App

BF

Настройка OAuth​

  1. В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID

BF

  1. Введите имя и выберите Application type - Desktop app

BF

  1. Сохраните ClientID и Client Secret

BF

Включение сервиса Google Sheets​

  1. Перейдите на страницу Sheets в Marketplace

  2. Нажмите Enable

BF

Получение Токена​

  1. Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода() с булево параметрами используемых вами сервисов. Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google

BF

  1. Скопируйте код из URL после авторизации

BF

important

Время жизни кода крайне мало. После его получения нужно выполнить шаг 3 максимально быстро. Лучше всего заранее подготовить обработку с полем для ввода и кнопкой (в 1С), либо же использовать CLI версию ОПИ. В случае истечения срока жизни кода до выполнения пункта 3, будет получена ошибка invalid_grant

  1. Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code)
Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON

{
 "token_type": "Bearer",
 "refresh_token": "1//09au6OES3JN9oCgYIARAAGAkSNwF-L9Ir1B7uawfwafT1wE0FKO519Xj6JxawfawfyjMyJ_QlUZYLHZqw",
 "scope": "https://www.googleapis.com/auth/...",
 "expires_in": 3599,
 "access_token": "ya29.a0AfB_byA344tXkIawdawdwadadhyZQV8bSZn_snNXtY2HLb7l71awdawdawdad-ASgpzyOSWIvEmPruhUa_1yCCq6jvoD0r_q-fNEsARrH8zpJ3c6LNGWvwdg8CXsSxYaCgYKAWkSawfwafawfrCK0EP5kZY_A0171"
}

  1. Используйте access_token для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз.