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

پایتون

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat . سازمان Google Workspace شما باید به کاربران اجازه دهد تا وب‌قلاب‌های ورودی را اضافه و استفاده کنند .
• پایتون 3.6 یا بالاتر
• ابزار ��دیریت بسته پیپ

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

  pip install httplib2

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

Node.js

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat . سازمان Google Workspace شما باید به کاربران اجازه دهد تا وب‌قلاب‌های ورودی را اضافه و استفاده کنند .
• Node.js 14 یا بالاتر
• ابزار مدیریت بسته npm
• فضای چت گوگل. برای ایجاد یکی با استفاده از Google Chat API، به ایجاد فضا مراجعه کنید. برای ایجاد یکی در چت، از مستندات مرکز راهنمایی دیدن کنید.

جاوا

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat . سازمان Google Workspace شما باید به کاربران اجازه دهد تا وب‌قلاب‌های ورودی را اضافه و استفاده کنند .
• جاوا 11 یا بالاتر
• ابزار مدیریت بسته Maven
• فضای چت گوگل. برای ایجاد یکی با استفاده از Google Chat API، به ایجاد فضا مراجعه کنید. برای ایجاد یکی در چت، از مستندات مرکز راهنمایی دیدن کنید.

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

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

پایتون

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

2. در quickstart.py کد زیر را جایگذاری کنید:

   python/webhook/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 را با URL webhook که هنگام ثبت وب‌هوک کپی کرده‌اید، جایگزین کنید.

Node.js

1. در پوشه کاری خود، یک فایل با نام index.js ایجاد کنید.

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

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

جاوا

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

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

1. در مرورگر، به Apps Script بروید.

2. روی New Project کلیک کنید

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

پایتون

  python3 quickstart.py

Node.js

  node index.js

جاوا

  mvn compile exec:java -Dexec.mainClass=App

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

• روی Run کلیک کنید.

پایتون

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