إرسال رسائل خاصة إلى مستخدمي Google Chat

Node.js

• مشروع على Google Cloud تم فيه تفعيل Google Chat API وضبطه لمعرفة الخطوات، يُرجى الاطّلاع على مقالة إنشاء تطبيق Google Chat.
• للاستجابة بشكل خاص لأمر يستخدم الشرطة المائلة، يتم ضبط أمر يبدأ بشرطة مائلة لتطبيق Chat. ولإنشاء أحد هذه الأوامر، يُرجى مراجعة الاستجابة للأوامر التي تبدأ بشرطة مائلة.
• لإرسال رسالة خاصة باستخدام طريقة messages.create()، عليك استخدام مصادقة التطبيقات.

ملاحظة: تمت كتابة نماذج رمز Node.js في هذا الدليل لتشغيلها كدالة Google Cloud.

Python

• مشروع على Google Cloud تم فيه تفعيل Google Chat API وضبطه لمعرفة الخطوات، يُرجى الاطّلاع على مقالة إنشاء تطبيق Google Chat.
• للاستجابة بشكل خاص لأمر يستخدم الشرطة المائلة، يتم ضبط أمر يبدأ بشرطة مائلة لتطبيق Chat. ولإنشاء أحد هذه الأوامر، يُرجى مراجعة الاستجابة للأوامر التي تبدأ بشرطة مائلة.
• لإرسال رسالة خاصة باستخدام طريقة messages.create()، عليك استخدام مصادقة التطبيقات.

ملاحظة: تمت كتابة نماذج التعليمات البرمجية Python في هذا الدليل للتشغيل بصفتها دالة Google Cloud باستخدام Python 3.10.

برمجة تطبيقات

• تطبيق في Chat. لإنشاء تطبيق في Chat، يمكنك اتّباع مقالة quickstart هذه.
• للاستجابة بشكل خاص لأمر يستخدم الشرطة المائلة، يتم ضبط أمر يبدأ بشرطة مائلة لتطبيق Chat. ولإنشاء أحد هذه الأوامر، يُرجى مراجعة الاستجابة للأوامر التي تبدأ بشرطة مائلة.
• لإرسال رسالة خاصة باستخدام طريقة messages.create()، عليك استخدام مصادقة التطبيقات.

Node.js

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {!Object} req Request sent from Google Chat app
* @param {!Object} res Response to send back
*
* @return {!Object} respond to slash command
*/
exports.onMessage = function onMessage(req, res) {
  if (req.method === 'GET' || !req.body.message) {
    return res.send('Hello! This function is meant to be used in Google Chat app.');
  }

  const event = req.body;

  // Checks for the presence of event.message.slashCommand.
  // If the slash command is "/help", responds with a private text message.
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case '1':  // /help
        return res.json({
          privateMessageViewer: event.user,
          text: 'This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>.'
        });
    }
  }

  // If the Chat app doesn't detect a slash command, it responds
  // with a private text message
  return res.json({
    privateMessageViewer: event.user,
    text: 'Try a slash command.'
  });
};

برمجة تطبيقات

/**
* Responds to a MESSAGE event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onMessage(event) {
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case 1: // Responds to /help
        return {
          "privateMessageViewer": event.user,
          "text": "This Chat app was created by Cymbal Labs. To get help with this app, <https://cymbalgroup.com/docs|see our documentation> or <https://cymbalgroup.com/support|contact our support team>."
        };
    }
  }
  else {
    return { "text": "Try a slash command.", "privateMessageViewer": event.user };
  }
}

Python

from typing import Any, Mapping

import flask
import functions_framework

@functions_framework.http
def main(req: flask.Request) -> Mapping[str, Any]:
  """Responds to a MESSAGE event in Google Chat.

  Args:
      req (flask.Request): the event object from Chat API.

  Returns:
      Mapping[str, Any]: open a Dialog in response to a card's button click.
  """
  if req.method == 'GET':
    return 'Hello! This function must be called from Google Chat.'

  request = req.get_json(silent=True)

  # Checks for the presence of event.message.slashCommand.
  # If the slash command is "/help", responds with a private text message.
  if request.get('message', {}).get('slashCommand'):
    command_id = request.get('message', {}).get('slashCommand').get('commandId')
    if command_id == '1':  # /help
      return {
          'privateMessageViewer': request.get('user'),
          'text': (
              'This Chat app was created by Cymbal Labs. To get help with this'
              ' app, <https://cymbalgroup.com/docs|see our documentation> or'
              ' <https://cymbalgroup.com/support|contact our support team>.'
          ),
      }

  return {
      'privateMessageViewer': request.get('user'),
      'text': 'Try a slash command.',
  }