Wyślij SMS-a

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Na tej stronie opisano, jak tworzyć wiadomości, które wyglądają tak, jakby były wpisywane przez użytkownika. Za pomocą SMS-ów możesz prezentować użytkownikom proste informacje. Informacje na temat tworzenia bardziej złożonych wiadomości, które generują karty na czacie, znajdziesz w artykule Wysyłanie wiadomości z karty.

Wymagania wstępne

Aby uruchomić przykłady w tym przewodniku, musisz mieć:

Python

Anatomia SMS-a

Każda wiadomość w Google Chat jest reprezentowana jako obiekt JSON. Ten przykład to podstawowy komunikat, który określa treść w postaci zwykłego tekstu:

{
  "text": "Your pizza delivery is here!"
}

Oto przykład opublikowania w Google Chat:

Wysyłanie asynchronicznego SMS-a

Aby utworzyć SMS-a:

Python

  1. W katalogu roboczym utwórz plik o nazwie chat_create_text_message.py.
  2. Umieść w kodzie chat_create_text_message.py ten kod:

    from httplib2 import Http
    from oauth2client.service_account import ServiceAccountCredentials
    from apiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name(
        'service_account.json', SCOPES)
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', http=CREDENTIALS.authorize(Http()))
    
    # Create a Chat message.
    result = chat.spaces().messages().create(
    
        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',
    
        # The message to create.
        body={'text': 'Hello, world!'}
    
    ).execute()
    
    print(result)
    
  3. W kodzie zastąp SPACE nazwą pokoju, który możesz uzyskać za pomocą metody spaces.list() w interfejsie Chat API lub z adresu URL pokoju.

  4. W katalogu roboczym utwórz i uruchom przykład:

    python3 chat_create_text_message.py
    

Formatowanie tekstu w wiadomościach

Google Chat pozwala stosować podstawowe formatowanie do tekstu wiadomości, w tym pogrubienie, kursywę i przekreślenie. Aby sformatować tekst, dodaj do niego następujące symbole:

Format Symbol Przykład Wynik
pogrubienia, * *Cześć* Cześć
kursywy, _ (podkreślenie) _cześć_ Cześć
Przekreślenie ~ ~Cześć~ Cześć
Stała szerokość znaków ` (cudzysłów prosty) `cześć` hello
Blok jednowymiarowy ``` (3 cudzysłowy) ```
Witaj
Świat
```
Hello
World

Weźmy na przykład taki plik JSON:

{
  "text": "Your pizza delivery *has arrived*!\nThank you for using _Pizza Bot!_"
}

W pokoju czatu pojawi się taki komunikat:

Ta składnia znaczników to ta sama składnia, która obowiązuje w przypadku wiadomości wpisywanych przez użytkowników. Właśnie dlatego różni się od składni opartej na języku HTML stosowanej do tekstu na kartach.

Jeśli w wiadomości umieścisz zwykły adres URL linku, np. http://example.com/, Google Chat użyje go jako tekstu linku i automatycznie utworzy hiperlink do tego adresu.

Aby podać alternatywny tekst linku, użyj następującej składni:

Składnia renderowanie,
<https://example.com/|LINK_TEXT> LINK_TEXT

Pionowa kreska i link są opcjonalne, więc <https://example.com/> i https://example.com/ są równoważne.

Wiadomości zawierające @wzmiankę o określonych użytkownikach

Aplikacja do obsługi czatu może dodać @wzmiankę o użytkowniku w wiadomości, podając USER_ID w tej składni. Aby określić właściwość USER_ID dla użytkownika, sprawdź pole sender wiadomości przychodzącej.

<users/USER_ID>

Ten ciąg jest zastępowany @wzmianką określonego użytkownika. Weźmy na przykład taki plik JSON:

{
    "text": "Hey <users/123456789012345678901>! Thank you for using _Pizza bot!_"
}

W efekcie otrzymujemy taki wynik:

Wiadomości zawierające @wzmiankę o wszystkich użytkownikach

Możesz użyć identyfikatora użytkownika all, aby dodać @wzmiankę o wszystkich użytkownikach w pokoju. Przykład:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}