SMS senden

Auf dieser Seite wird beschrieben, wie Nachrichten erstellt werden, die inline wie von einem Nutzer eingegeben angezeigt werden. Verwenden Sie Textnachrichten, um Nutzern einfache Informationen zu präsentieren. Informationen zum Erstellen komplexerer Nachrichten, die Karten im Chat generieren, finden Sie unter Kartennachricht senden.

Voraussetzungen

Sie benötigen die folgenden Voraussetzungen, um die Beispiele in diesem Leitfaden auszuführen:

Python

Aufbau einer SMS

Jede Nachricht in Google Chat wird als JSON-Objekt dargestellt. Das folgende Beispiel zeigt eine einfache Nachricht, die einen einfachen Klartexttext angibt:

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

In Google Chat gepostetes Beispiel wird so dargestellt:

Asynchrone SMS senden

So erstellen Sie eine SMS:

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_create_text_message.py.

  2. Fügen Sie den folgenden Code in chat_create_text_message.py ein:

    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. Ersetzen Sie im Code SPACE durch einen Gruppenbereichsnamen, den Sie über die Methode spaces.list() in der Chat API oder über die URL eines Gruppenbereichs abrufen können.

  4. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:

    python3 chat_create_text_message.py

Text in Nachrichten formatieren

Mit Google Chat können Sie dem Nachrichtentext eine grundlegende Formatierung hinzufügen, z. B. fett, kursiv oder durchgestrichen. Sie formatieren den Text mit den folgenden Symbolen:

Format Symbol Beispiel Ergebnis
Fett * *Hallo* Hallo
Kursiv _ (Unterstrich) _hello_, Hallo
Durchstreichen ~ ~Hallo~ Hallo
Festbreitenschrift ` (Backquote) „Hallo“ hello
Festbreitenschriftblock ``` (drei Anführungszeichen) ```
Hello
World
```		 Hello
World

Sehen Sie sich beispielsweise den folgenden JSON-Code an:

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

Dadurch wird eine Nachricht wie diese im Chatbereich angezeigt:

Diese Syntax für Text-Markup ist mit der Syntax für Nachrichten identisch, die von Nutzern eingegeben wird. Deshalb unterscheidet sie sich von der HTML-basierten Formatierung, die auf Text in Karten angewendet wird.

Links im Nachrichtentext einfügen

Wenn du in deinem Nachrichtentext eine einfache Link-URL wie http://example.com/ verwendest, verwendet Google Chat diese URL als Linktext und verknüpft diesen Text automatisch mit der angegebenen URL.

Verwenden Sie die folgende Syntax, um alternativen Linktext für Ihren Link anzugeben:

Syntax Rendering
<https://example.com/|LINK_TEXT> LINK_TEXT

Der senkrechte Strich und Linklink sind optional, sodass <https://example.com/> und https://example.com/ äquivalent sind.

Nachrichten, die bestimmte Nutzer @erwähnen

Eine Chat-App kann einen Nutzer in einer Nachricht @erwähnen, indem er USER_ID in der folgenden Syntax angibt. Um das USER_ID für einen Nutzer zu ermitteln, untersuchen Sie das Feld sender der eingehenden Nachricht des Nutzers.

<users/USER_ID>

Dieser String wird durch eine @Erwähnung des angegebenen Nutzers ersetzt. Sehen Sie sich beispielsweise den folgenden JSON-Code an:

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

Das Ergebnis sieht so aus:

Nachrichten, die alle Nutzer @erwähnen

Mit der Nutzer-ID all können Sie alle menschlichen Nutzer in einem Gruppenbereich @erwähnen. Beispiel:

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