Справочник по клиенту JavaScript для входа в Google

В этом справочнике описаны методы и атрибуты клиента JavaScript, которые вы будете использовать для реализации входа через Google в свои веб-приложения.

Если вы столкнулись с какой-либо проблемой при использовании библиотеки, сообщите об этом в наш репозиторий GitHub .

Настройка аутентификации

Загрузите библиотеку платформы API Google, чтобы создать объект gapi :

<script src="https://apis.google.com/js/platform.js?onload=init" async defer></script>

После загрузки библиотеки платформы загрузите библиотеку auth2 :

function init() {
  gapi.load('auth2', function() {
    /* Ready. Make a call to gapi.auth2.init or some other API */
  });
}

gapi.auth2.init( params )

Инициализирует объект GoogleAuth . Вы должны вызвать этот метод перед вызовом методов gapi.auth2.GoogleAuth .

Когда вы инициализируете объект GoogleAuth , вы настраиваете объект с вашим идентификатором клиента OAuth 2.0 и любыми дополнительными параметрами, которые вы хотите указать. Затем, если пользователь уже вошел в систему, объект GoogleAuth восстанавливает состояние входа пользователя из предыдущего сеанса.

{
  client_id: 'CLIENT_ID.apps.googleusercontent.com'
}

GoogleAuth.then( onInit , onError )

Вызывает функцию onInit , когда объект GoogleAuth полностью инициализирован. Если при инициализации возникает ошибка (такое может случиться в старых неподдерживаемых браузерах), вместо этого будет вызвана функция onError .

Коды ошибок

idpiframe_initialization_failed

Не удалось инициализировать необходимый iframe от Google, например, из-за неподдерживаемой среды. Свойство details предоставит дополнительную информацию о возникшей ошибке.

gapi.auth2.ClientConfig

Интерфейс, представляющий различные параметры конфигурации для метода gapi.auth2.init .

Аутентификация

GoogleAuth — это одноэлементный класс, который предоставляет методы, позволяющие пользователю входить в систему с помощью учетной записи Google, получать текущий статус входа пользователя, получать определенные данные из профиля пользователя Google, запрашивать дополнительные области действия и выходить из текущей учетной записи.

gapi.auth2.getAuthInstance()

Возвращает объект GoogleAuth . Вы должны инициализировать объект GoogleAuth с помощью gapi.auth2.init() перед вызовом этого метода.

GoogleAuth.isSignedIn.get()

Возвращает, вошел ли текущий пользователь в систему.

GoogleAuth.isSignedIn.listen(слушатель)

Прослушивайте изменения в состоянии входа текущего пользователя.

GoogleAuth.signIn()

Выполняет вход пользователя с параметрами, указанными для gapi.auth2.init() .

Коды ошибок

См. GoogleAuth.signIn( options ) .

GoogleAuth.signIn( options )

Выполняет вход пользователя с указанными параметрами.

Коды ошибок

popup_closed_by_user

Пользователь закрыл всплывающее окно до завершения процесса входа.

access_denied

Пользователь запретил доступ к требуемым областям.

immediate_failed

Ни один пользователь не может быть выбран автоматически без запроса согласия. Возникла ошибка при использовании signIn с prompt: 'none' . Этот параметр не требуется использовать, так как gapi.auth2.init автоматически войдет в систему пользователя, если он ранее входил в систему во время предыдущего сеанса.

gapi.auth2.SignInOptions

Интерфейс, представляющий различные параметры конфигурации для метода GoogleAuth.signIn( options ) .

GoogleAuth.signOut()

Выходит из текущего аккаунта из приложения.

GoogleAuth.отключить()

Отменяет все области действия, предоставленные пользователем.

GoogleAuth.grantOfflineAccess( options )

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

{
  scope: 'profile email'
}

auth2.grantOfflineAccess().then(function(resp) {
  var auth_code = resp.code;
});

Коды ошибок

popup_closed_by_user

Пользователь закрыл всплывающее окно до завершения потока согласия.

access_denied

Пользователь запретил доступ к требуемым областям.

immediate_failed

Ни один пользователь не может быть выбран автоматически без запроса согласия. Возникла ошибка при использовании signIn с prompt: 'none' . Этот параметр не требуется использовать, так как gapi.auth2.init автоматически войдет в систему пользователя, если он ранее входил в систему во время предыдущего сеанса.

gapi.auth2.OfflineAccessOptions

Интерфейс, представляющий различные параметры конфигурации для метода GoogleAuth.grantOfflineAccess( options ) .

GoogleAuth.attachClickHandler( container , options , onsuccess , onfailure )

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

Пользователи

Объект GoogleUser представляет одну учетную запись пользователя. Объекты GoogleUser обычно получаются путем вызова GoogleAuth.currentUser.get() .

GoogleAuth.currentUser.get()

Возвращает объект GoogleUser , представляющий текущего пользователя. Обратите внимание, что в только что инициализированном экземпляре GoogleAuth текущий пользователь не был установлен. Используйте метод currentUser.listen() или метод GoogleAuth.then() , чтобы получить инициализированный экземпляр GoogleAuth .

GoogleAuth.currentUser.listen( listener )

Слушайте изменения в currentUser.

GoogleUser.getId()

Получите уникальную строку идентификатора пользователя.

GoogleUser.isSignedIn()

Возвращает true, если пользователь вошел в систему.

GoogleUser.getHostedDomain()

Получите домен G Suite пользователя, если пользователь вошел в систему с учетной записью G Suite.

GoogleUser.getGrantedScopes()

Получите области, предоставленные пользователем, в виде строки с разделителями-пробелами.

GoogleUser.getBasicProfile()

Получить основную информацию о профиле пользователя.

GoogleUser.getAuthResponse(includeAuthorizationData)

Получите объект ответа из сеанса аутентификации пользователя.

GoogleUser.reloadAuthResponse()

Принудительно обновляет токен доступа, а затем возвращает обещание для нового AuthResponse.

gapi.auth2.AuthResponse

Ответ, возвращаемый при вызове методов GoogleUser.getAuthResponse( includeAuthorizationData ) или GoogleUser.reloadAuthResponse() .

GoogleUser.hasGrantedScopes( scopes )

Возвращает true, если пользователь предоставил указанные области.

GoogleUser.grant( options )

Запросить у пользователя дополнительные области.

См. GoogleAuth.signIn() для списка параметров и кода ошибки.

GoogleUser.grantOfflineAccess( options )

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

{
  scope: 'profile email'
}

GoogleUser.disconnect()

Отменяет все области, которые пользователь предоставил приложению.

Элементы пользовательского интерфейса

gapi.signin2.render( id , options )

Отображает кнопку входа в элементе с заданным идентификатором, используя параметры, указанные объектом options .

{
  scope: 'email',
  width: 200,
  height: 50,
  longtitle: true,
  theme: 'dark',
  onsuccess: handleSuccess,
  onfailure: handleFailure
}

Передовой

gapi.auth2.authorize ( params , callback )

Выполняет однократную авторизацию OAuth 2.0. В зависимости от используемых параметров это откроет всплывающее окно для процесса входа в Google или попытается автоматически загрузить запрошенный ответ, без взаимодействия с пользователем.

Некоторые случаи использования, когда этот метод полезен, включают:

• Вашему приложению нужно только один раз запросить конечную точку API Google, например, чтобы загрузить любимые видео пользователя YouTube при первом входе в систему.
• Ваше приложение имеет свою собственную инфраструктуру управления сеансом, и ему требуется токен идентификатора только один раз, чтобы идентифицировать пользователя в вашем бэкэнде.
• На одной странице используется несколько идентификаторов клиентов.

{
  client_id: 'CLIENT_ID.apps.googleusercontent.com',
  scope: 'email profile openid',
  response_type: 'id_token permission'
}

Пример

gapi.auth2.authorize({
  client_id: 'CLIENT_ID.apps.googleusercontent.com',
  scope: 'email profile openid',
  response_type: 'id_token permission'
}, function(response) {
  if (response.error) {
    // An error happened!
    return;
  }
  // The user authorized the application for the scopes requested.
  var accessToken = response.access_token;
  var idToken = response.id_token;
  // You can also now use gapi.client to perform authenticated requests.
});

Коды ошибок

idpiframe_initialization_failed

Не удалось инициализировать необходимый iframe от Google, например, из-за неподдерживаемой среды. Свойство details предоставит дополнительную информацию о возникшей ошибке.

popup_closed_by_user

Пользователь закрыл всплывающее окно до завершения процесса входа.

access_denied

Пользователь запретил доступ к требуемым областям.

immediate_failed

Ни один пользователь не может быть выбран автоматически без запроса согласия. Возникла ошибка при использовании signIn с prompt: 'none' .

gapi.auth2.AuthorizeConfig

Интерфейс, представляющий различные параметры конфигурации для метода gapi.auth2.authorize .

gapi.auth2.AuthorizeResponse

Ответ возвращается на обратный вызов метода gapi.auth2.authorize .