คุณมีเวลา 5 นาทีไหม ช่วยเราปรับปรุงเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ Google Chat โดยการทําแบบสํารวจสั้นๆ

หน้านี้ได้รับการแปลโดย Cloud Translation API

ตั้งค่าพื้นที่ทํางาน

คู่มือนี้อธิบายวิธีใช้เมธอด setup ในทรัพยากร Space ของ Google Chat API เพื่อตั้งค่าพื้นที่ใน Google Chat การตั้งค่าพื้นที่ทำงานจะสร้างพื้นที่ทำงานและเพิ่มผู้ใช้ที่ระบุไปยังพื้นที่ทำงาน

แหล่งข้อมูล Space เป็นพื้นที่ที่ผู้คนและแอป Chat จะใช้ส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้ พื้นที่ทำงานมีหลายประเภทดังนี้

ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนกับผู้ใช้กับแอป Chat
การแชทเป็นกลุ่มคือการสนทนาระหว่างผู้ใช้ 3 คนขึ้นไปกับแอป Chat
พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ถาวรที่ผู้คนจะส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน

โปรดพิจารณาสิ่งต่อไปนี้เมื่อตั้งค่าพื้นที่ทำงาน

ระบบจะเพิ่มผู้ใช้ที่โทรออก (ตรวจสอบสิทธิ์แล้ว) ไปยังพื้นที่ทำงานโดยอัตโนมัติ คุณจึงไม่ต้องระบุการเป็นสมาชิกของผู้ใช้ในคำขอ
เมื่อสร้างข้อความส่วนตัว (DM) หากมี DM ระหว่างผู้ใช้ 2 คน ระบบจะแสดงผล DM ไม่เช่นนั้น ระบบจะสร้าง DM
คุณไม่สามารถตั้งค่าพื้นที่ทำงานด้วยการตอบกลับแบบแยกชุดข้อความหรือเพิ่มผู้คนนอก Google Workspace

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

Python

Python 3.6 ขึ้นไป
เครื่องมือการจัดการแพ็กเกจ pip
ไลบรารีของไคลเอ็นต์ Google ล่าสุดสำหรับ Python หากต้องการติดตั้งหรืออัปเดต ให้เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง
```
pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client
```
แอป Chat ที่เผยแพร่แล้ว หากต้องการสร้างและเผยแพร่ แอป Chat โปรดดูที่ สร้างแอป Google Chat
มีการกำหนดค่าการให้สิทธิ์สำหรับแอป Chat แล้ว การตั้งค่าพื้นที่ทำงานจะต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์ chat.spaces.create หรือ chat.spaces

ตั้งค่าพื้นที่ทำงาน

หากต้องการตั้งค่าพื้นที่ทำงาน ให้ส่งข้อมูลต่อไปนี้ในคำขอ

ระบุขอบเขตการให้สิทธิ์ chat.spaces.create หรือ chat.spaces
เรียกใช้เมธอด setup ในทรัพยากร Space
หากต้องการเพิ่มผู้ใช้ที่เป็นมนุษย์เป็นสมาชิกพื้นที่ทำงาน ให้ระบุ users/{user} โดยที่ {user} อาจเป็น {person_id} สำหรับ person จาก People API หรือรหัสของ user ใน Directory API เช่น หากบุคคล API resourceName คือ people/123456789 คุณสามารถเพิ่มผู้ใช้ไปยังพื้นที่ทำงานโดย รวมการเป็นสมาชิกกับ users/123456789 เป็น member.name ได้
หากต้องการสร้าง DM ระหว่างผู้ใช้ที่โทรกับผู้ใช้ที่เป็นมนุษย์รายอื่น ให้ระบุการเป็นสมาชิกของผู้ใช้ที่เป็นมนุษย์ในคำขอ
หากต้องการสร้าง DM ระหว่างผู้ใช้ที่โทรและแอปการโทร ให้ตั้งค่า Space.singleUserBotDm เป็น true และไม่ต้องระบุการเป็นสมาชิกใดๆ คุณใช้วิธีนี้ได้เพื่อตั้งค่า DM กับแอปการโทรเท่านั้น หากต้องการเพิ่มแอปการโทรเป็นสมาชิกของพื้นที่ทำงานหรือเพิ่ม DM ที่มีอยู่ระหว่างผู้ใช้ที่เป็นมนุษย์ 2 คน โปรดดูสร้างการเป็นสมาชิก

ตัวอย่างต่อไปนี้สร้างพื้นที่ทำงานที่มีชื่อและสร้างการเป็นสมาชิกพื้นที่ทำงานสำหรับผู้ใช้ที่เป็นมนุษย์ 3 ราย ได้แก่ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว และผู้ใช้ที่ระบุอีก 2 ราย

Python

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

ใส่รหัสต่อไปนี้ใน chat_space_setup.py:

import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 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.spaces.create"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then sets up a Chat space by creating a space and adding members.
    '''

    # 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().setup(

      # Details about the space to set up.
      body = {

        # Attributes of the space to set up, like space type and display name.
        'space': {

            # To set up a named space, set spaceType to SPACE.
            'spaceType': 'SPACE',

            # The user-visible name of the space
            'displayName': 'API-setup'
        },

        # The people and app to add to the space.
        #
        # The authenticated user is automatically added to the space,
        # and doesn't need to be specified in the memberships array.
        'memberships': [
            {
              'member': {
                'name':'users/123456789',
                'type': 'HUMAN'
              }
            },
            {
              'member': {
                'name':'users/987654321',
                'type': 'HUMAN'
              }
            }
        ]
      }

      ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่าง:
```
python3 chat_space_setup.py
```

มีการตั้งค่าพื้นที่แชทที่มีชื่อซึ่งมีผู้ใช้ที่เป็นมนุษย์ 3 คน รวมถึงผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

หากต้องการไปยังพื้นที่ทำงาน ให้ใช้รหัสทรัพยากรของพื้นที่ทำงานนั้นเพื่อสร้าง URL ของพื้นที่ทำงาน คุณสามารถดูรหัสทรัพยากรได้จากพื้นที่ทำงาน name ในเนื้อความการตอบกลับของ Google Chat ตัวอย่างเช่น หาก name ของพื้นที่ทํางานคือ spaces/1234567 คุณสามารถไปยังพื้นที่ทํางานโดยใช้ URL ต่อไปนี้ https://mail.google.com/chat/u/0/#chat/space/1234567

ตั้งค่าพื้นที่ทํางาน

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

Python

ตั้งค่าพื้นที่ทำงาน

Python

หัวข้อที่เกี่ยวข้อง