ดูรายละเอียดเกี่ยวกับข้อความ

คำแนะนำนี้จะอธิบายวิธีใช้เมธอด get ในแหล่งข้อมูล Message ของ Google Chat API เพื่อแสดงรายละเอียดเกี่ยวกับ SMS หรือข้อความในการ์ด

ใน Chat API ข้อความใน Chat จะแสดงด้วยส่วนหัว แหล่งข้อมูล Message แม้ว่าผู้ใช้ Chat จะส่งได้เฉพาะข้อความที่มีข้อความเท่านั้น แอปแชทสามารถใช้ฟีเจอร์การรับส่งข้อความอื่นๆ ได้มากมาย รวมถึง แสดงอินเทอร์เฟซผู้ใช้แบบคงที่หรือแบบอินเทอร์แอกทีฟ ซึ่งรวบรวมข้อมูลจาก ผู้ใช้ และการส่งข้อความแบบส่วนตัว หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการรับส่งข้อความ ฟีเจอร์ที่ใช้ได้กับ Chat API โปรดดู ภาพรวมข้อความ Google Chat

ข้อกำหนดเบื้องต้น

Python

  • ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat

รับข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้

วิธีดูรายละเอียดเกี่ยวกับข้อความที่มี การตรวจสอบสิทธิ์ผู้ใช้ ส่งต่อสิ่งต่อไปนี้ในคำขอของคุณ

  • ระบุขอบเขตการให้สิทธิ์ chat.messages.readonly หรือ chat.messages
  • เรียกใช้ get วิธี ใน แหล่งข้อมูล Message
  • ตั้งค่า name เป็นชื่อทรัพยากรของข้อความเพื่อรับ

ตัวอย่างต่อไปนี้ได้รับข้อความที่มี การตรวจสอบสิทธิ์ผู้ใช้:

Python

  1. สร้างไฟล์ชื่อ chat_message_get_user.py ในไดเรกทอรีการทำงาน

  2. รวมรหัสต่อไปนี้ใน chat_message_get_user.py:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.messages.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets a message.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().messages().get(

        # The message to get.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MESSAGE with a message name.
        # Obtain the message name from the response body returned
        # after creating a message asynchronously with Chat REST API.
        name = 'spaces/SPACE/messages/MESSAGE'

    ).execute()

    # Prints details about the message.
    print(result)

if __name__ == '__main__':
    main()

  3. ในโค้ด ให้แทนที่

    • SPACE: ชื่อพื้นที่ทำงานซึ่งดูได้จาก เวลา spaces.list วิธี ใน Chat API หรือจาก URL ของพื้นที่ทำงาน
    • MESSAGE: ชื่อข้อความซึ่งคุณจะดูได้ จากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้างข้อความแบบไม่พร้อมกัน ด้วย Chat API หรือ ชื่อที่กำหนดเอง ที่กำหนดให้กับข้อความขณะสร้าง

  4. ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่างด้วยคำสั่งต่อไปนี้

    python3 chat_message_get_user.py

Chat API จะแสดงผลอินสแตนซ์ Message ซึ่งให้รายละเอียดข้อความที่ระบุ

รับข้อความที่มีการตรวจสอบสิทธิ์แอป

วิธีดูรายละเอียดเกี่ยวกับข้อความที่มี การตรวจสอบสิทธิ์แอป ส่งต่อสิ่งต่อไปนี้ในคำขอของคุณ

  • ระบุขอบเขตการให้สิทธิ์ chat.bot
  • เรียกใช้ get วิธี ใน แหล่งข้อมูล Message
  • ตั้งค่า name เป็นชื่อทรัพยากรของข้อความเพื่อรับ

ตัวอย่างต่อไปนี้ได้รับข้อความที่มี การตรวจสอบสิทธิ์แอป:

Python

  1. สร้างไฟล์ชื่อ chat_get_message_app.py ในไดเรกทอรีการทำงาน

  2. รวมรหัสต่อไปนี้ใน chat_get_message_app.py:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Get a Chat message.
result = chat.spaces().messages().get(

    # The message to get.
    #
    # Replace SPACE with a space name.
    # Obtain the space name from the spaces resource of Chat API,
    # or from a space's URL.
    #
    # Replace MESSAGE with a message name.
    # Obtain the message name from the response body returned
    # after creating a message asynchronously with Chat REST API.
    name='spaces/SPACE/messages/MESSAGE'

  ).execute()

# Print Chat API's response in your command line interface.
print(result)

  3. ในโค้ด ให้แทนที่

    • SPACE: name ของพื้นที่ทำงานที่ โพสต์ข้อความไปแล้ว ซึ่งคุณสามารถดูได้จาก เมธอด spaces.list ใน Chat API หรือจาก URL ของพื้นที่ทำงาน

    • MESSAGE: ชื่อข้อความ ซึ่งคุณสามารถดูได้จาก จากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้างข้อความแบบไม่พร้อมกัน ด้วย Chat API หรือ ชื่อที่กำหนดเอง ที่กำหนดให้กับข้อความขณะสร้าง

  4. ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่างด้วยคำสั่งต่อไปนี้

    python3 chat_get_message_app.py

Chat API จะแสดงผลอินสแตนซ์ Message ซึ่งให้รายละเอียดข้อความที่ระบุ