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

Python

• Python 3.10.7 أو أحدث
• حساب على Google Workspace لديه إذن بالوصول إلى Chat
• مشروع على Google Cloud:
• احرص على تفعيل الفوترة لمشروعك على Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
• مساحة Chat حالية

• مكتبة "httplib2" إذا لزم الأمر، شغِّل الأمر التالي لواجهة سطر الأوامر (CLI) لتثبيت المكتبة باستخدام pip:

  pip install httplib2
  

Node.js

• تم تثبيت Node.js وnpm.
• حساب على Google Workspace لديه إذن بالوصول إلى Chat
• مشروع على Google Cloud:
• احرص على تفعيل الفوترة لمشروعك على Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
• مساحة Chat حالية

Java

• الإصدار 11 من لغة Java أو إصدار أحدث
• Apache Maven
• حساب على Google Workspace لديه إذن بالوصول إلى Chat
• مشروع على Google Cloud:
• احرص على تفعيل الفوترة لمشروعك على Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
• مساحة Chat حالية

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

• حساب على Google Workspace لديه إذن بالوصول إلى Chat
• مساحة Chat حالية

Python

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

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

   python/webhook/quickstart.py

   العرض على GitHub

   from json import dumps
   from httplib2 import Http
   
   
   def main():
       """Google Chat incoming webhook quickstart."""
       url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages"
       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. استبدِل قيمة المتغيّر WEBHOOK_URL بعنوان URL للردّ التلقائي على الويب الذي نسخته عند تسجيل الردّ التلقائي على الويب.

Node.js

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

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

   عقدة/webhook/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"
     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. استبدِل قيمة المتغيّر webhookURL بعنوان URL للردّ التلقائي على الويب الذي نسخته عند تسجيل الردّ التلقائي على الويب.

Java

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

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

   java/webhook/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>java-webhook-app</artifactId>
     <version>0.1.0</version>
   
     <name>java-webhook-app</name>
     <url>https://github.com/googleworkspace/google-chat-samples/tree/main/java/webhook</url>
   
     <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، الصق الرمز التالي:

   java/webhook/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/AAAAGCYeSRY/messages";
     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 بعنوان URL للردّ التلقائي على الويب الذي نسخته عند تسجيل الردّ التلقائي على الويب.

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

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

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

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

   apps-script/webhook/webhook.gs

   العرض على GitHub

   function webhook() {
     const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages"
     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 بعنوان URL للردّ التلقائي على الويب الذي نسخته عند تسجيل الردّ التلقائي على الويب.

Python

  python3 quickstart.py

Node.js

  node index.js

Java

  mvn compile exec:java -Dexec.mainClass=App

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

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

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()

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));

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

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);
}