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

คู่มือนี้อธิบายวิธีใช้เมธอด 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);
}

await main();

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

  • 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

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