یک برنامه Google Chat به عنوان یک وب هوک بسازید

پایتون

• یک حساب کاربری تجاری یا سازمانی در گوگل ورک اسپیس با دسترسی به گوگل چت . سازمان گوگل ورک اسپیس شما باید به کاربران اجازه اضافه کردن و استفاده از وب هوک‌های ورودی را بدهد.
• پایتون ۳.۶ یا بالاتر
• ابزار مدیریت بسته pip

• کتابخانه httplib2 . برای نصب کتابخانه، دستور زیر را در رابط خط فرمان خود اجرا کنید:

  pip install httplib2

• یک فضای چت گوگل. برای ایجاد آن با استفاده از API چت گوگل، به بخش ایجاد فضا مراجعه کنید. برای ایجاد آن در چت، به مستندات مرکز راهنما مراجعه کنید.

نود جی اس

• یک حساب کاربری تجاری یا سازمانی در گوگل ورک اسپیس با دسترسی به گوگل چت . سازمان گوگل ورک اسپیس شما باید به کاربران اجازه اضافه کردن و استفاده از وب هوک‌های ورودی را بدهد.
• Node.js نسخه ۱۴ یا بالاتر
• ابزار مدیریت بسته npm
• یک فضای چت گوگل. برای ایجاد آن با استفاده از API چت گوگل، به بخش ایجاد فضا مراجعه کنید. برای ایجاد آن در چت، به مستندات مرکز راهنما مراجعه کنید.

جاوا

• یک حساب کاربری تجاری یا سازمانی در گوگل ورک اسپیس با دسترسی به گوگل چت . سازمان گوگل ورک اسپیس شما باید به کاربران اجازه اضافه کردن و استفاده از وب هوک‌های ورودی را بدهد.
• جاوا ۱۱ یا بالاتر
• ابزار مدیریت بسته Maven
• یک فضای چت گوگل. برای ایجاد آن با استفاده از API چت گوگل، به بخش ایجاد فضا مراجعه کنید. برای ایجاد آن در چت، به مستندات مرکز راهنما مراجعه کنید.

اسکریپت برنامه‌ها

• یک حساب کاربری تجاری یا سازمانی در گوگل ورک اسپیس با دسترسی به گوگل چت . سازمان گوگل ورک اسپیس شما باید به کاربران اجازه اضافه کردن و استفاده از وب هوک‌های ورودی را بدهد.
• یک پروژه مستقل Apps Script ایجاد کنید و سرویس چت پیشرفته (Advanced Chat Service) را فعال کنید.
• یک فضای چت گوگل. برای ایجاد آن با استفاده از API چت گوگل، به بخش ایجاد فضا مراجعه کنید. برای ایجاد آن در چت، به مستندات مرکز راهنما مراجعه کنید.

پایتون

1. در دایرکتوری کاری خود، فایلی با نام quickstart.py ایجاد کنید.

2. در quickstart.py ، کد زیر را قرار دهید:

   پایتون/وب‌هوک/quickstart.py

   مشاهده در گیت‌هاب
   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. در دایرکتوری کاری خود، فایلی با نام index.js ایجاد کنید.

2. در index.js ، کد زیر را قرار دهید:

   گره/وب‌هوک/index.js

   مشاهده در گیت‌هاب
   /**
    * 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. مقدار متغیر url را با آدرس وب‌هوک که هنگام ثبت وب‌هوک کپی کرده‌اید، جایگزین کنید.

جاوا

1. در دایرکتوری کاری خود، فایلی با نام pom.xml ایجاد کنید.

2. در pom.xml ، کد زیر را کپی و پیست کنید:

   جاوا/وب‌هوک/pom.xml

   مشاهده در گیت‌هاب
   <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

   مشاهده در گیت‌هاب
   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. در مرورگر، به Apps Script بروید.

2. روی پروژه جدید کلیک کنید

3. کد زیر را جایگذاری کنید:

   apps-script/webhook/webhook.gs

   مشاهده در گیت‌هاب
   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 را با آدرس وب‌هوک که هنگام ثبت وب‌هوک کپی کرده‌اید، جایگزین کنید.

پایتون

  python3 quickstart.py

نود جی اس

  node index.js

جاوا

  mvn compile exec:java -Dexec.mainClass=App

اسکریپت برنامه‌ها

• روی اجرا کلیک کنید.

پایتون

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

نود جی اس

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