Создайте именованное пространство в Google Chat (original) (raw)

В этом руководстве объясняется, как создать именованное пространство с помощью метода create() ресурса Space API Google Chat.

Именованное пространство (где spaceType — SPACE ) — это место, где люди отправляют сообщения, делятся файлами и работают вместе. Именованное пространство может включать приложения для чата. У именованных пространств есть менеджеры, которые могут применять административные настройки, описания, а также добавлять или удалять пользователей и приложения.

Чтобы создать различные типы чат-пространств (включая личные сообщения или групповые сообщения), используйте метод setUp() ресурса Space для создания пространства и одновременного добавления участников. Подробнее см. в разделе «Настройка пространства» .

После создания именованного пространства единственным его участником является аутентифицированный пользователь. Чтобы добавить участников в пространство, вызовите метод create() ресурса Membership для каждого пользователя или приложения, которое вы хотите добавить. Или вы можете использовать метод setUp() для создания именованного пространства и одновременного добавления в него участников.

Предпосылки

Node.js

Питон

Ява

Скрипт приложений

Создайте именованное пространство как пользователь

Чтобы создать именованное пространство с аутентификацией пользователя , передайте в запрос следующее:

Вот как создать именованное пространство:

Node.js

Питон

Ява

Скрипт приложений

Создайте именованное пространство как приложение чата

Аутентификация приложения требует однократного одобрения администратора .

Чтобы пригласить или добавить пользователя в пространство с аутентификацией через приложение , передайте в запросе следующее:

Напишите скрипт, который вызывает Chat API

Вот как создать именованное пространство:

Питон

  1. В рабочем каталоге создайте файл с именем chat_space_create_named_app.py .
  2. Включите следующий код в chat_space_create_named_app.py :
from google.oauth2 import service_account  
from apiclient.discovery import build  
# Define your app's authorization scopes.  
# When modifying these scopes, delete the file token.json, if it exists.  
SCOPES = ["https://www.googleapis.com/auth/chat.app.spaces.create"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then creates a Chat space.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # Build a service endpoint for Chat API.  
    chat = build('chat', 'v1', credentials=creds)  
    # Use the service endpoint to call Chat API.  
    result = chat.spaces().create(  
      # Details about the space to create.  
      body = {  
        # To create a named space, set spaceType to SPACE.  
        'spaceType': 'SPACE',  
        # The user-visible name of the space.  
        'displayName': 'API-made',  
        # The customer ID of the Workspace domain.  
        'customer': 'CUSTOMER'  
      }  
      ).execute()  
    # Prints details about the created space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. В коде замените следующее:
    • CUSTOMER : идентификатор клиента домена пространства в формате customer/{customer} , где {customer} — это ID из ресурса customer в Admin SDK . Чтобы создать пространство в той же организации Google Workspace, что и приложение Chat, используйте customers/my_customer .
  2. В вашем рабочем каталоге соберите и запустите пример:
python3 chat_space_create_named_app.py

Откройте пространство в Google Chat

Чтобы перейти в чат-группу, используйте идентификатор ресурса чат-группы для создания её URL-адреса. Идентификатор ресурса можно найти в name чат-группы в тексте ответа Google Chat. Например, если name вашей чат-группы — spaces/1234567 , вы можете перейти в неё по следующему URL-адресу: https://mail.google.com/chat/u/0/#chat/space/1234567 .

Ограничения и соображения