إنشاء تطبيق Google Chat كردّ تلقائي على الويب

Node.js

• حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat يجب أن تسمح مؤسسة Google Workspace للمستخدمين بإضافة واستخدام الويب هوك الواردة.
• ‫Node.js 14 أو إصدار أحدث
• أداة إدارة الحزم npm
• مساحة Chat في Google لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء مساحة في Chat، انتقِل إلى مستندات مركز المساعدة.

Python

• حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat يجب أن تسمح مؤسسة Google Workspace للمستخدمين بإضافة واستخدام الويب هوك الواردة.
• الإصدار 3.6 أو الإصدارات الأحدث من Python
• أداة إدارة الحزم pip

• مكتبة httplib2 لتثبيت المكتبة، شغِّل الأمر التالي في واجهة سطر الأوامر:

  pip install httplib2

• مساحة Chat في Google لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء مساحة في Chat، انتقِل إلى مستندات مركز المساعدة.

جافا

• حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat يجب أن تسمح مؤسسة Google Workspace للمستخدمين بإضافة واستخدام الويب هوك الواردة.
• الإصدار 11 من Java أو إصدار أحدث
• أداة إدارة الحِزم Maven
• مساحة Chat في Google لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء مساحة في Chat، انتقِل إلى مستندات مركز المساعدة.

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

• حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat يجب أن تسمح مؤسسة Google Workspace للمستخدمين بإضافة واستخدام الويب هوك الواردة.
• أنشئ مشروعًا مستقلاً في "برمجة تطبيقات Google"، وفعِّل خدمة Chat المتقدّمة.
• مساحة Chat في Google لإنشاء مساحة باستخدام Google Chat API، اطّلِع على مقالة إنشاء مساحة. لإنشاء مساحة في Chat، انتقِل إلى مستندات مركز المساعدة.

Node.js

1. في دليل العمل، أنشئ ملفًا باسم index.js.

2. في index.js، الصِق الرمز التالي:

   solutions/webhook-chat-app/index.js

   عرض على GitHub
   /**
    * Sends asynchronous message to Google Chat
    * @return {Object} response
    */
   async function webhook() {
     const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN"
     const res = await fetch(url, {
       method: "POST",
       headers: {"Content-Type": "application/json; charset=UTF-8"},
       body: JSON.stringify({
         text: "Hello from a Node script!"
       })
     });
     return await res.json();
   }
   
   webhook().then(res => console.log(res));

3. استبدِل قيمة المتغيّر url برابط ويب هوك الذي نسخته عند تسجيل الويب هوك.

Python

1. في دليل العمل، أنشئ ملفًا باسم quickstart.py.

2. في quickstart.py، الصِق الرمز التالي:

   solutions/webhook-chat-app/quickstart.py

   عرض على GitHub
   from json import dumps
   from httplib2 import Http
   
   # Copy the webhook URL from the Chat space where the webhook is registered.
   # The values for SPACE_ID, KEY, and TOKEN are set by Chat, and are included
   # when you copy the webhook URL.
   
   def main():
       """Google Chat incoming webhook quickstart."""
       url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN"
       app_message = {
           "text": "Hello from a Python script!"
       }
       message_headers = {"Content-Type": "application/json; charset=UTF-8"}
       http_obj = Http()
       response = http_obj.request(
           uri=url,
           method="POST",
           headers=message_headers,
           body=dumps(app_message),
       )
       print(response)
   
   
   if __name__ == "__main__":
       main()

3. استبدِل قيمة المتغيّر url برابط ويب هوك الذي نسخته عند تسجيل الويب هوك.

جافا

1. في دليل العمل، أنشئ ملفًا باسم pom.xml.

2. في pom.xml، انسخ ما يلي والصِقه:

   solutions/webhook-chat-app/pom.xml

   عرض على GitHub
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.google.chat.webhook</groupId>
     <artifactId>webhook-app</artifactId>
     <version>0.1.0</version>
     <name>webhook-app</name>
   
     <properties>
       <maven.compiler.target>11</maven.compiler.target>
       <maven.compiler.source>11</maven.compiler.source>
     </properties>
   
     <dependencies>
       <dependency>
           <groupId>com.google.code.gson</groupId>
           <artifactId>gson</artifactId>
           <version>2.9.1</version>
       </dependency>
     </dependencies>
   
     <build>
       <pluginManagement>
         <plugins>
           <plugin>
             <artifactId>maven-compiler-plugin</artifactId>
             <version>3.8.0</version>
           </plugin>
         </plugins>
       </pluginManagement>
     </build>
   </project>

3. في دليل العمل، أنشئ بنية الدليل التالية src/main/java.

4. في الدليل src/main/java، أنشئ ملفًا باسم App.java.

5. في App.java، الصِق الرمز التالي:

   solutions/webhook-chat-app/src/main/java/com/google/chat/webhook/App.java

   عرض على GitHub
   import com.google.gson.Gson;
   import java.net.http.HttpClient;
   import java.net.http.HttpRequest;
   import java.net.http.HttpResponse;
   import java.util.Map;
   import java.net.URI;
   
   public class App {
     private static final String URL = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN";
     private static final Gson gson = new Gson();
     private static final HttpClient client = HttpClient.newHttpClient();
   
     public static void main(String[] args) throws Exception {
       String message = gson.toJson(Map.of(
         "text", "Hello from Java!"
       ));
   
       HttpRequest request = HttpRequest.newBuilder(URI.create(URL))
         .header("accept", "application/json; charset=UTF-8")
         .POST(HttpRequest.BodyPublishers.ofString(message)).build();
   
       HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
   
       System.out.println(response.body());
     }
   }

6. استبدِل قيمة المتغيّر URL برابط ويب هوك الذي نسخته عند تسجيل الويب هوك.

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

1. في المتصفّح، انتقِل إلى برمجة تطبيقات Google.

2. انقر على مشروع جديد.

3. ألصِق الرمز التالي:

   solutions/webhook-chat-app/webhook.gs

   عرض على GitHub
   function webhook() {
     const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN"
     const options = {
       "method": "post",
       "headers": {"Content-Type": "application/json; charset=UTF-8"},
       "payload": JSON.stringify({
         "text": "Hello from Apps Script!"
       })
     };
     const response = UrlFetchApp.fetch(url, options);
     console.log(response);
   }

4. استبدِل قيمة المتغيّر url برابط ويب هوك الذي نسخته عند تسجيل الويب هوك.

Node.js

  node index.js

Python

  python3 quickstart.py

جافا

  mvn compile exec:java -Dexec.mainClass=App

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

• انقر على تشغيل.

Node.js

/**
 * Sends asynchronous message to Google Chat
 * @return {Object} response
 */
async function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
  const res = await fetch(url, {
    method: "POST",
    headers: {"Content-Type": "application/json; charset=UTF-8"},
    body: JSON.stringify({
      text: "Hello from a Node script!",
      thread: {
        threadKey: "THREAD_KEY_VALUE"
      }
    })
  });
  return await res.json();
}

webhook().then(res => console.log(res));

Python

from json import dumps
from httplib2 import Http

# Copy the webhook URL from the Chat space where the webhook is registered.
# The values for SPACE_ID, KEY, and TOKEN are set by Chat, and are included
# when you copy the webhook URL.
#
# Then, append messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD to the
# webhook URL.


def main():
    """Google Chat incoming webhook that starts or replies to a message thread."""
    url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
    app_message = {
        "text": "Hello from a Python script!",
        # To start a thread, set threadKey to an arbitratry string.
        # To reply to a thread, specify that thread's threadKey value.
        "thread": {
            "threadKey": "THREAD_KEY_VALUE"
        },
    }
    message_headers = {"Content-Type": "application/json; charset=UTF-8"}
    http_obj = Http()
    response = http_obj.request(
        uri=url,
        method="POST",
        headers=message_headers,
        body=dumps(app_message),
    )
    print(response)


if __name__ == "__main__":
    main()

جافا

import com.google.gson.Gson;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Map;
import java.net.URI;

public class App {
  private static final String URL = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD";
  private static final Gson gson = new Gson();
  private static final HttpClient client = HttpClient.newHttpClient();

  public static void main(String[] args) throws Exception {
    String message = gson.toJson(Map.of(
      "text", "Hello from Java!",
      "thread", Map.of(
        "threadKey", "THREAD_KEY_VALUE"
      )
    ));

    HttpRequest request = HttpRequest.newBuilder(URI.create(URL))
      .header("accept", "application/json; charset=UTF-8")
      .POST(HttpRequest.BodyPublishers.ofString(message)).build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    System.out.println(response.body());
  }
}

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

function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
  const options = {
    "method": "post",
    "headers": {"Content-Type": "application/json; charset=UTF-8"},
    "payload": JSON.stringify({
      "text": "Hello from Apps Script!",
      "thread": {
        "threadKey": "THREAD_KEY_VALUE"
      }
    })
  };
  const response = UrlFetchApp.fetch(url, options);
  console.log(response);
}