Aggiornare un messaggio

Questa guida spiega come utilizzare il metodo update() nella risorsa Message dell'API Google Chat per aggiornare un messaggio di testo o con scheda in uno spazio. Aggiorna un messaggio per modificarne gli attributi, ad esempio o i contenuti di una scheda. Puoi anche anteporre un messaggio a una o aggiungere una scheda a un messaggio di testo.

Nell'API Chat, un messaggio di Chat è rappresentato dalla Message risorsa. Anche se gli utenti di Chat possono inviare solo messaggi contenenti testo, Le app di chat possono utilizzare molte altre funzionalità di messaggistica, tra cui: Mostrare interfacce utente statiche o interattive, raccogliendo informazioni da utenti e distribuire i messaggi in privato. Per scoprire di più sui messaggi disponibili per l'API Chat, consulta le Panoramica dei messaggi di Google Chat.

Prerequisiti

Node.js

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.

• Configura l'ambiente:
  • Creare un progetto Google Cloud.
  • Configura la schermata per il consenso OAuth.
  • Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
  • Installa la libreria client Cloud per Node.js.
  • Crea credenziali di accesso in base a come vuoi autenticarti nell'API Google Chat richiesta:
    • Per autenticarti come utente di Chat, crea le credenziali dell'ID client OAuth e salvale come file JSON nominato client_secrets.json nella tua directory locale.
    • Per autenticarti come app Chat, crea account di servizio credenziali e salvale come file JSON denominato credentials.json.
• Scegli un ambito di autorizzazione a seconda che tu voglia eseguire l'autenticazione come utente o come App Chat.

Python

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.

• Configura l'ambiente:
  • Crea un progetto Google Cloud.
  • Configura la schermata per il consenso OAuth.
  • Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
  • Installa il Python libreria client di Cloud.
  • Crea le credenziali di accesso in base alla modalità di autenticazione nella richiesta dell'API Google Chat:
    • Per autenticarti come utente di Chat, crea le credenziali dell'ID client OAuth e salvale come file JSON nominato client_secrets.json nella tua directory locale.
    • Per autenticarti come app Chat, crea le credenziali dell'account di servizio e salvale come file JSON denominato credentials.json.
• Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.

Java

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.

• Configura l'ambiente:
  • Crea un progetto Google Cloud.
  • Configura la schermata per il consenso OAuth.
  • Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
  • Installa la libreria client Cloud per Java.
  • Crea credenziali di accesso in base a come vuoi autenticarti nell'API Google Chat richiesta:
    • Per autenticarti come utente di Chat, crea le credenziali dell'ID client OAuth e salvale come file JSON nominato client_secrets.json nella tua directory locale.
    • Per autenticarti come app Chat, crea le credenziali dell'account di servizio e salvale come file JSON denominato credentials.json.
• Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.

Apps Script

• Un'azienda o un'impresa Google Workspace con accesso a Google Chat.

• Configura l'ambiente:
  • Creare un progetto Google Cloud.
  • Configura la schermata per il consenso OAuth.
  • Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
  • Creare un progetto Apps Script autonomo e attivare il Servizio di chat avanzato.
  • In questa guida devi utilizzare l'autenticazione dell'utente o dell'app. Per autenticarti come app Chat, crea le credenziali dell'account di servizio. Per la procedura, consulta Autenticare e autorizzare come app Google Chat.
• Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.

Gli esempi di codice in questa pagina utilizzano l'interfaccia dell'API gRPC con le librerie client di Google Cloud. In alternativa, puoi utilizzare l'interfaccia dell'API REST. Per ulteriori informazioni su gRPC e REST, consulta Panoramica dell'API Google Chat.

Aggiornare un messaggio per conto di un utente

Con l'autenticazione utente, solo il testo di un messaggio può essere aggiornato.

Per aggiornare un messaggio con l'autenticazione utente, inserisci quanto segue nel richiesta:

• Specifica l'ambito di autorizzazione chat.messages.
• Chiama il UpdateMessage() .
• Passa message come istanza di Message con quanto segue:
  • Il campo name impostato sul messaggio da aggiornare, che include un ID spazio e un ID messaggio.
  • Il campo text è stato impostato con il nuovo testo.
• Supera updateMask con il valore text.

Se il messaggio aggiornato è un messaggio nella scheda, il testo viene anteposto alle schede (che continuano a essere visualizzate).

Per aggiornare un messaggio o anteporre un messaggio a un messaggio di una scheda, procedi nel seguente modo: con l'autenticazione utente:

Node.js

chat/client-libraries/cloud/update-message-user-cred.js

Visualizza su GitHub

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.messages'];

// This sample shows how to update a message with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    message: {
      // Replace SPACE_NAME and MESSAGE_NAME here
      name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME',
      text: 'Updated with user credential!'
    },
    // The field paths to update. Separate multiple values with commas or use
    // `*` to update all field paths.
    updateMask: {
      // The field paths to update.
      paths: ['text']
    }
  };

  // Make the request
  const response = await chatClient.updateMessage(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Python

chat/client-libraries/cloud/update_message_user_cred.py

Visualizza su GitHub

from authentication_utils import create_client_with_user_credentials
from google.apps import chat_v1 as google_chat

SCOPES = ["https://www.googleapis.com/auth/chat.messages"]

# This sample shows how to update a message with user credential
def update_message_with_user_cred():
    # Create a client
    client = create_client_with_user_credentials(SCOPES)

    # Initialize request argument(s)
    request = google_chat.UpdateMessageRequest(
        message = {
            # Replace SPACE_NAME and MESSAGE_NAME here
            "name": "spaces/SPACE_NAME/messages/MESSAGE_NAME",
            "text": "Updated with user credential!"
        },
        # The field paths to update. Separate multiple values with commas or use
        # `*` to update all field paths.
        update_mask = "text"
    )

    # Make the request
    response = client.update_message(request)

    # Handle the response
    print(response)

update_message_with_user_cred()

Java

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/UpdateMessageUserCred.java

Visualizza su GitHub

import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.UpdateMessageRequest;
import com.google.chat.v1.Message;
import com.google.protobuf.FieldMask;

// This sample shows how to update message with user credential.
public class UpdateMessageUserCred {

  private static final String SCOPE =
    "https://www.googleapis.com/auth/chat.messages";

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithUserCredentials(
          ImmutableList.of(SCOPE))) {
      UpdateMessageRequest.Builder request = UpdateMessageRequest.newBuilder()
        .setMessage(Message.newBuilder()
          // replace SPACE_NAME and MESSAGE_NAME here
          .setName("spaces/SPACE_NAME/messages/MESSAGE_NAME")
          .setText("Updated with user credential!"))
        .setUpdateMask(FieldMask.newBuilder()
          // The field paths to update.
          .addPaths("text"));
      Message response = chatServiceClient.updateMessage(request.build());

      System.out.println(JsonFormat.printer().print(response));
    }
  }
}

Apps Script

chat/advanced-service/Main.gs

Visualizza su GitHub

/**
 * This sample shows how to update a message with user credential
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.messages'
 * referenced in the manifest file (appsscript.json).
 */
function updateMessageUserCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME and MESSAGE_NAME here
  const name = 'spaces/SPACE_NAME/messages/MESSAGE_NAME';
  const message = {
    text: 'Updated with user credential!'
  };
  // The field paths to update. Separate multiple values with commas or use
  // `*` to update all field paths.
  const updateMask = 'text';

  // Make the request
  const response = Chat.Spaces.Messages.patch(message, name, {
    updateMask: updateMask
  });

  // Handle the response
  console.log(response);
}

Per eseguire questo sample, sostituisci quanto segue:

• SPACE_NAME: l'ID della proprietà name Puoi ottenerlo chiamando il metodo ListSpaces() o dall'URL dello spazio.
• MESSAGE_NAME: l'ID della colonna name Puoi ottenere l'ID dal corpo della risposta restituito dopo aver creato un messaggio in modo asincrono con l'API Chat o con il nome personalizzato assegnato al messaggio al momento della creazione.

L'API Chat restituisce un'istanza di Message che descrive il messaggio aggiornato.

Aggiornare un messaggio come app Chat

Con l'autenticazione delle app, si possono aggiornare sia il testo sia le schede di un messaggio.

Per aggiornare un messaggio con l'autenticazione app, trasmetti quanto segue nella richiesta:

• Specifica l'ambito dell'autorizzazione chat.bot.
• Chiama il metodo UpdateMessage().
• Passa message come istanza di Message con quanto segue:
  • Il campo name impostato sul messaggio da aggiornare, che include un ID spazio e un ID messaggio.
  • Il campo text è stato impostato con il nuovo testo, se deve essere aggiornato.
  • Il campo cardsV2 è stato impostato con le nuove schede se devono essere aggiornate.
• Passa updateMask con l'elenco di campi ad aggiornamenti come text e cardsV2.

Se il messaggio aggiornato è un messaggio nella scheda e il testo vengono aggiornati, il testo aggiornato viene anteposto alle schede (che continuano a essere visualizzate). Se il messaggio aggiornato è un messaggio e le schede vengono aggiornate, le schede aggiornate vengono aggiunte al testo (che continua a essere visualizzato).

Ecco come aggiornare il testo e le schede di un messaggio con autenticazione app:

Node.js

chat/client-libraries/cloud/update-message-app-cred.js

Visualizza su GitHub

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to update a message with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    message: {
      // Replace SPACE_NAME and MESSAGE_NAME here
      name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME',
      text: 'Text updated with app credential!',
      cardsV2 : [{ card: { header: {
        title: 'Card updated with app credential!',
        imageUrl: 'https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg'
      }}}]
    },
    // The field paths to update. Separate multiple values with commas or use
    // `*` to update all field paths.
    updateMask: {
      // The field paths to update.
      paths: ['text', 'cards_v2']
    }
  };

  // Make the request
  const response = await chatClient.updateMessage(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Python

chat/client-libraries/cloud/update_message_app_cred.py

Visualizza su GitHub

from authentication_utils import create_client_with_app_credentials
from google.apps import chat_v1 as google_chat

# This sample shows how to update a message with app credential
def update_message_with_app_cred():
    # Create a client
    client = create_client_with_app_credentials()

    # Initialize request argument(s)
    request = google_chat.UpdateMessageRequest(
        message = {
            # Replace SPACE_NAME and MESSAGE_NAME here
            "name": "spaces/SPACE_NAME/messages/MESSAGE_NAME",
            "text": "Text updated with app credential!",
            "cards_v2" : [{ "card": { "header": {
                "title": 'Card updated with app credential!',
                "image_url": 'https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg'
            }}}]
        },
        # The field paths to update. Separate multiple values with commas or use
        # `*` to update all field paths.
        update_mask = "text,cardsV2"
    )

    # Make the request
    response = client.update_message(request)

    # Handle the response
    print(response)

update_message_with_app_cred()

Java

chat/client-libraries/cloud/src/main/java/com/google/workspace/api/chat/samples/UpdateMessageAppCred.java

Visualizza su GitHub

import com.google.apps.card.v1.Card;
import com.google.apps.card.v1.Card.CardHeader;
import com.google.chat.v1.CardWithId;
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.UpdateMessageRequest;
import com.google.chat.v1.Message;
import com.google.protobuf.FieldMask;

// This sample shows how to update message with app credential.
public class UpdateMessageAppCred {

  public static void main(String[] args) throws Exception {
    try (ChatServiceClient chatServiceClient =
        AuthenticationUtils.createClientWithAppCredentials()) {
      UpdateMessageRequest.Builder request = UpdateMessageRequest.newBuilder()
        .setMessage(Message.newBuilder()
          // replace SPACE_NAME and MESSAGE_NAME here
          .setName("spaces/SPACE_NAME/messages/MESSAGE_NAME")
          .setText("Text updated with app credential!")
          .addCardsV2(CardWithId.newBuilder().setCard(Card.newBuilder()
            .setHeader(CardHeader.newBuilder()
              .setTitle("Card updated with app credential!")
              .setImageUrl("https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg")))))
        .setUpdateMask(FieldMask.newBuilder()
          // The field paths to update.
          .addAllPaths(List.of("text", "cards_v2")));
      Message response = chatServiceClient.updateMessage(request.build());

      System.out.println(JsonFormat.printer().print(response));
    }
  }
}

Apps Script

chat/advanced-service/Main.gs

Visualizza su GitHub

/**
 * This sample shows how to update a message with app credential
 * 
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.bot'
 * used by service accounts.
 */
function updateMessageAppCred() {
  // Initialize request argument(s)
  // TODO(developer): Replace SPACE_NAME and MESSAGE_NAME here
  const name = 'spaces/SPACE_NAME/messages/MESSAGE_NAME';
  const message = {
    text: 'Text updated with app credential!',
    cardsV2 : [{ card: { header: {
      title: 'Card updated with app credential!',
      imageUrl: 'https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/info/default/24px.svg'
    }}}]
  };
  // The field paths to update. Separate multiple values with commas or use
  // `*` to update all field paths.
  const updateMask = 'text,cardsV2';

  // Make the request
  const response = Chat.Spaces.Messages.patch(message, name, {
    updateMask: updateMask
  }, getHeaderWithAppCredentials());

  // Handle the response
  console.log(response);
}

Per eseguire questo sample, sostituisci quanto segue:

• SPACE_NAME: l'ID della proprietà name Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.
• MESSAGE_NAME: l'ID del messaggio name. Puoi ottenere l'ID dal corpo della risposta restituito dopo aver creato un i messaggi in modo asincrono con l'API Chat o con nome personalizzato e assegnato al messaggio al momento della creazione.

L'API Chat restituisce un'istanza di Message che descrive il messaggio aggiornato.

Argomenti correlati

• Formattare un messaggio.
• Eliminare un messaggio.
• Visualizzare i dettagli di un messaggio.
• Elenca i messaggi in uno spazio.
• Inviare un messaggio.