ส่งข้อความการ์ดหน้าแรกของแอปสําหรับแอป Google Chat

Python

• บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
• แอป Chat ที่เผยแพร่แล้ว หากต้องการสร้าง แอป Chat โปรดดูที่ quickstartนี้
• แอป Google Chat ที่กำหนดค่าไว้สำหรับการโต้ตอบ ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าแอป Google Chat ให้รับเหตุการณ์การโต้ตอบ

Apps Script

• บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
• แอป Chat ที่เผยแพร่แล้ว หากต้องการสร้าง แอป Chat ให้ทำตาม quickstartนี้
• แอป Google Chat ที่กำหนดค่าไว้สำหรับการโต้ตอบ ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าแอป Google Chat ให้รับเหตุการณ์การโต้ตอบ

Python

1. ในคอนโซล Google Cloud ให้ไปที่เมนู menu > ผลิตภัณฑ์อื่นๆ > Google Workspace > คลังผลิตภัณฑ์ > Google Chat API

   ไปที่ Google Chat API

2. คลิก Manage จากนั้นคลิกแท็บ Configuration

3. เปิดใช้หน้าแรกของแอปการสนับสนุน

4. เลือกช่องทำเครื่องหมายหน้าแรกของแอปการสนับสนุน

5. เพิ่ม URL ในช่อง URL หน้าแรกของแอป ค่านี้มักจะเป็น URL เดียวกับ URL ของแอป URL นี้จะถูกเรียกสำหรับ APP_HOME เหตุการณ์

6. คลิกบันทึก

Apps Script

1. ในคอนโซล Google Cloud ให้ไปที่เมนู menu > ผลิตภัณฑ์อื่นๆ > Google Workspace > คลังผลิตภัณฑ์ > Google Chat API

   ไปที่ Google Chat API

2. คลิก Manage จากนั้นคลิกแท็บ Configuration

3. เลือกช่องทำเครื่องหมายหน้าแรกของแอปการสนับสนุน

4. คลิกบันทึก

Python

เมื่อผู้ใช้เปิดข้อความส่วนตัวจากแอป Chat ระบบจะส่งเหตุการณ์ APP_HOME ไปยังแอป Chat เมื่อแอป Chat ได้รับเหตุการณ์นี้ ระบบจะแสดงผลอินสแตนซ์ JSON ของ RenderActions พร้อมการนําทางแบบ pushCard

@app.route('/', methods=['POST'])
def on_event():
  event = request.get_json()
  chat = event.get('chat')
  if chat is not None:
    return handle_chat_event(event)

def handle_chat_event(event):
  if event['chat'].get('type') == 'APP_HOME':
    return get_app_home_card()

def get_app_home_card():
  return {
    "action": {
      "navigations": [
        {
          "pushCard": {
            "sections": [
              {
                "widgets": [
                  {
                    "buttonList": {
                      "buttons": [
                        {
                          "text": "Open documentation",
                          "onClick": {
                            "openLink": {
                              "url": "https://developers.google.com/chat"
                            }
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  }

Apps Script

ตัวอย่างนี้จะส่งข้อความการ์ดโดยแสดงผล JSON ของการ์ด หรือจะใช้บริการการ์ด Apps Script ก็ได้

ใช้ฟังก์ชัน onAppHome เพื่อแสดงผลอินสแตนซ์ JSON ของ RenderActions ที่มีการนำทาง pushCard ดังนี้

// "onAppHome" is the pre-defined name of the callback that the Chat servers
// execute.
function onAppHome() {
  return {
    action: {
      navigations: [
        {
          pushCard: getCard()
        }
      ]
    }
  };
}

function getCard() {
  return {
    sections: [
      {
        widgets: [
          {
            buttonList: {
              buttons: [
                {
                  text: "Open documentation",
                  onClick: {
                    openLink: {
                      url: "https://developers.google.com/chat"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    ]
  };
}

Python

สำหรับแอป HTTP การอัปเดตข้อความการ์ดหน้าแรกของแอปจะคล้ายกับ การประมวลผลข้อมูลที่ผู้ใช้ป้อน แต่คุณต้องแสดงผล RenderActions invokedFunction แสดงชื่อของฟังก์ชันที่มีการเรียกใช้ซึ่งเชื่อมโยงกับวิดเจ็ต Card ดูข้อมูลเพิ่มเติมได้ที่ CommonEventObject ในตัวอย่างต่อไปนี้ submitForm แสดงให้เห็นว่าผู้ใช้ส่งข้อมูลแบบฟอร์ม

@app.route('/', methods=['POST'])
def on_event():
  event = request.get_json()
  chat = event.get('chat')
  if chat is not None:
    return handle_chat_event(event)

def handle_chat_event(event):
  if event['chat'].get('type') == 'SUBMIT_FORM':
    event_object = event.get('commonEventObject')
    if event_object is not None:
      // Forms
      if 'submitForm' == event_object.get('invokedFunction'):
        return {
          'render_actions': {
            'action': {
              'navigations': [{
                'updateCard': get_update_card()
              }]
            }
          }
        }

def get_update_card():
  return {
      "action": {
          "navigations": [{
              "pushCard": {
                  "sections": [{
                      "widgets": [{
                          "buttonList": {
                              "buttons": [{
                                  "text": "Open documentation",
                                  "onClick": {
                                      "openLink": {
                                          "url": "https://developers.google.com/chat"
                                      }
                                  },
                              }]
                          }
                      }]
                  }]
              }
          }]
      }
  }

Apps Script

ตัวอย่างนี้จะส่งข้อความการ์ดโดยแสดงผล JSON ของการ์ด หรือจะใช้บริการการ์ด Apps Script ก็ได้

// Called from elsewhere (i.e. on button press).
function updateAppHomeCard(event) {
  return {
    render_actions: {
      action: {
        navigations: [
          {
            updateCard: getCard()
          }
        ]
      }
    }
  }
}

function getCard() {
  return {
    sections: [
      {
        widgets: [
          {
            buttonList: {
              buttons: [
                {
                  text: "Open documentation",
                  onClick: {
                    openLink: {
                      url: "https://developers.google.com/chat"
                    }
                  }
                }
              ]
            }
          }
        ]
      }
    ]
  };
}