นำสมาชิกออกจากพื้นที่ทำงาน

คู่มือนี้อธิบายวิธีใช้เมธอด delete() ในทรัพยากร Membership ของ Google Chat API เพื่อนำสมาชิกออกจากสเปซ หรือที่เรียกว่าการลบการเป็นสมาชิก ระบบจะนำผู้จัดการพื้นที่ทำงานออกไม่ได้หาก เป็นผู้จัดการพื้นที่ทำงานเพียงคนเดียวในพื้นที่ทำงาน โปรดมอบหมายให้ผู้ใช้รายอื่นเป็นผู้จัดการพื้นที่ทำงานก่อนนำการเป็นสมาชิกเหล่านี้ออก

หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถนำผู้ใช้ กลุ่ม Google หรือแอป Chat ออกจากพื้นที่ใดก็ได้ในองค์กร Google Workspace

Membershipทรัพยากร แสดงว่าผู้ใช้ที่เป็นมนุษย์หรือแอป Google Chat ได้รับเชิญให้เข้าร่วม เป็นส่วนหนึ่งของ หรือไม่ได้อยู่ในพื้นที่ทำงาน

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

Node.js

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

นำสมาชิกออกจากพื้นที่ทำงานในฐานะผู้ใช้

หากต้องการนำผู้ใช้ กลุ่ม Google หรือแอป Chat ออกจาก พื้นที่ทำงานที่มี การตรวจสอบสิทธิ์ผู้ใช้ ให้ส่ง ข้อมูลต่อไปนี้ในคำขอ

  • ระบุขอบเขตการให้สิทธิ์ chat.memberships ผู้ใช้ที่ให้สิทธิ์ต้องมีสิทธิ์นำผู้ใช้หรือ Google Group ออกจากพื้นที่ทำงาน หากต้องการนำแอปใน Chat ออก ให้ระบุchat.memberships.appขอบเขตการให้สิทธิ์ (แอปจะลบได้เฉพาะการเป็นสมาชิกของตัวเองเท่านั้น ไม่ใช่ของแอปอื่นๆ) แนวทางปฏิบัติแนะนำคือให้เลือกขอบเขตที่จำกัดที่สุด ซึ่งยังคงช่วยให้แอปทำงานได้
  • เรียกใช้เมธอด DeleteMembership()
  • ส่ง name ของการเป็นสมาชิกที่จะลบ หากการเป็นสมาชิกเป็นของผู้จัดการพื้นที่ทำงานเพียงคนเดียวในพื้นที่ทำงาน ให้มอบหมายให้ผู้ใช้รายอื่นเป็นผู้จัดการพื้นที่ทำงานก่อนลบการเป็นสมาชิกนี้

วิธีลบการเป็นสมาชิกด้วยการตรวจสอบสิทธิ์ผู้ใช้มีดังนี้

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME'
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้

  • SPACE_NAME: รหัสจากname ของพื้นที่ทำงาน คุณรับรหัสได้โดยเรียกใช้เมธอด ListSpaces() หรือจาก URL ของพื้นที่ทำงาน
  • MEMBER_NAME: รหัสจากnameของสมาชิก คุณรับรหัสได้โดยเรียกใช้เมธอด ListMemberships()

หากสำเร็จ เนื้อหาการตอบกลับจะแสดงการเป็นสมาชิกพร้อม 'state': 'NOT_A_MEMBER' ซึ่งบ่งบอกว่าสมาชิกไม่ได้อยู่ในพื้นที่นั้นอีกต่อไป

{
    "name": "spaces/SPACE_NAME/members/MEMBER_NAME",
    "state": "NOT_A_MEMBER"
}

นำสมาชิกออกจากพื้นที่ทำงานในฐานะแอป Chat

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

หากต้องการนำผู้ใช้ กลุ่ม Google หรือแอป Chat ออกจาก พื้นที่ที่มี การตรวจสอบสิทธิ์แอป ให้ส่ง ข้อมูลต่อไปนี้ในคำขอ

  • ระบุchat.app.memberships ขอบเขตการให้สิทธิ์ การลบการเป็นสมาชิกของผู้จัดการพื้นที่ทำงานจะใช้ได้เฉพาะในพื้นที่ทำงานที่สร้างโดยแอป Chat เท่านั้น
  • เรียกใช้เมธอด delete ในmembership ทรัพยากร
  • ส่ง name ของการเป็นสมาชิกที่จะลบ หากการเป็นสมาชิกเป็นของผู้จัดการพื้นที่ทำงานเพียงคนเดียวในพื้นที่ทำงาน ให้มอบหมายให้ผู้ใช้รายอื่นเป็นผู้จัดการพื้นที่ทำงานก่อนลบการเป็นสมาชิกนี้

เขียนสคริปต์ที่เรียกใช้ Chat API

วิธีลบการเป็นสมาชิกด้วยการตรวจสอบสิทธิ์แอปมีดังนี้

Python

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

  2. ใส่โค้ดต่อไปนี้ใน chat_membership_delete_app.py

    from google.oauth2 import service_account
from apiclient.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.app.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified membership.
    '''

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

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

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

        # The membership to delete.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBER with a membership name.
        # Obtain the membership name from the memberships resource of
        # Chat API. To delete a Chat app's membership, replace MEMBER
        # with app; an alias for the app calling the API.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a membership, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. ในโค้ด ให้แทนที่ค่าต่อไปนี้

    • SPACE: ชื่อพื้นที่ ซึ่งคุณรับได้จากเมธอด spaces.list ใน Chat API หรือจาก URL ของพื้นที่

    • MEMBER: ชื่อการเป็นสมาชิก ซึ่งคุณดูได้จากspaces.members.listเมธอด ใน Chat API หากต้องการลบการเป็นสมาชิกของแอป ให้แทนที่ MEMBER ด้วย app

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

    python3 chat_membership_delete_app.py

หากสำเร็จ เนื้อหาการตอบกลับจะแสดงการเป็นสมาชิกพร้อม 'state': 'NOT_A_MEMBER' ซึ่งบ่งบอกว่าสมาชิกไม่ได้อยู่ในพื้นที่นั้นอีกต่อไป

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}

นำผู้ใช้หรือกลุ่ม Google ออกจากพื้นที่ทำงานในฐานะผู้ดูแลระบบ Google Workspace

หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้เมธอด DeleteMembership() เพื่อนำผู้ใช้ กลุ่ม Google หรือ แอป Chat ออกจากพื้นที่ใดก็ได้ในองค์กร Google Workspace

หากต้องการเรียกใช้เมธอดนี้ในฐานะผู้ดูแลระบบ Google Workspace ให้ทำดังนี้

ดูข้อมูลเพิ่มเติมและตัวอย่างได้ที่หัวข้อจัดการพื้นที่ใน Google Chat ในฐานะผู้ดูแลระบบ Google Workspace

ข้อจำกัดและข้อควรพิจารณา