Аутентификация и авторизация — это механизмы, используемые для проверки личности и доступа к ресурсам соответственно. В этом документе описывается, как работают аутентификация и авторизация для запросов к REST API Google Meet.
This guide explains how to use OAuth 2.0 with a user's Google credentials to access the Meet REST API . Authenticating and authorizing with user credentials lets Meet apps access user data and perform operations on the authenticated user's behalf. By authenticating on a user's behalf, the app has the same permissions as that user and can perform actions as if they were performed by that user.
Важная терминология
The following is a list of terms related to authentication and authorization:
- Аутентификация
The act of ensuring that a principal , which can be a user
или приложение, действующее от имени пользователя, — это тот, за кого себя выдает. При разработке приложений для Google Workspace следует учитывать следующие типы аутентификации: аутентификация пользователя и аутентификация приложения. Для REST API Meet аутентификация возможна только с помощью аутентификации пользователя.
- Авторизация
The permissions or "authority" the principal has to access
для доступа к данным или выполнения операций. Авторизация осуществляется с помощью кода, который вы пишете в своем приложении. Этот код информирует пользователя о том, что приложение хочет действовать от его имени и, если это разрешено, использует уникальные учетные данные вашего приложения для получения токена доступа от Google для доступа к данным или выполнения операций.
Ознакомьтесь с областями действия REST API.
Authorization scopes are the permissions that you request users to authorize for your app to access the meeting content. When someone installs your app, the user is asked to validate these scopes. Generally, you should choose the most narrowly focused scope possible and avoid requesting scopes that your app doesn't require. Users more readily grant access to limited, clearly described scopes.
The Meet REST API supports the following OAuth 2.0 scopes:
| Код области действия | Описание | Использование |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.settings | Edit and see the settings for all of your Google Meet calls. | Нечувствительный |
https://www.googleapis.com/auth/meetings.space.created | Allow apps to create, modify, and read metadata about meeting spaces created by your app. | Чувствительный |
https://www.googleapis.com/auth/meetings.space.readonly | Allow apps to read metadata about any meeting space the user has access to. | Чувствительный |
https://www.googleapis.com/auth/drive.readonly | Allow apps to download recording and transcript files from Google Drive API. | Ограниченный |
The following Meet-adjacent OAuth 2.0 scope resides in the Google Drive API scopes list :
| Код области действия | Описание | Использование |
|---|---|---|
https://www.googleapis.com/auth/drive.meet.readonly | View Drive files created or edited by Google Meet. | Ограниченный |
The Usage column in the table indicates the sensitivity of each scope, according to the following definitions:
Non-sensitive : These scopes provide the smallest scope of authorization access and only require basic app verification. To learn more, see Verification requirements .
Конфиденциальные данные : Эти области доступа предоставляют доступ к определенным пользовательским данным Google, авторизованным пользователем для вашего приложения. Для этого требуется дополнительная проверка приложения. Подробнее см. Требования к конфиденциальным и ограниченным областям доступа .
Ограниченный доступ : Эти области доступа предоставляют широкий доступ к данным пользователей Google и требуют прохождения процедуры проверки на наличие ограниченного доступа. Для получения дополнительной информации см. Политику Google API Services в отношении данных пользователей и Дополнительные требования к конкретным областям доступа API . Если вы храните данные с ограниченным доступом на серверах (или передаете их), вам необходимо пройти оценку безопасности.
If your app requires access to any other Google APIs, you can add those scopes as well. For more information about Google API scopes, see Using OAuth 2.0 to Access Google APIs .
To define what information is displayed to users and app reviewers, see Configure the OAuth consent screen and choose scopes .
For more information about specific OAuth 2.0 scopes, see OAuth 2.0 Scopes for Google APIs .
Authenticate and authorize using domain-wide delegation
If you're a domain administrator, you can grant domain-wide delegation of authority to authorize an application's service account to access your users' data without requiring each user to give consent. After you configure domain-wide delegation, the service account can impersonate a user account . Although a service account is used for authentication, domain-wide delegation impersonates a user and is therefore considered user authentication . Any capability that requires user authentication can use domain-wide delegation.
Связанные темы
For an overview of authentication and authorization in Google Workspace, see Learn about authentication and authorization .
For an overview of authentication and authorization in Google Cloud, see Authentication methods at Google .