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

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

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

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

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

Node.js

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

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

วิธีนําผู้ใช้, แอป Google Group หรือ 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 Group หรือแอป Chat ออกจากพื้นที่ทำงานที่มีการตรวจสอบสิทธิ์ของแอป ให้ส่งข้อมูลต่อไปนี้ในคำขอ

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

สร้างคีย์ API

หากต้องการเรียกใช้เมธอด API ของเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ คุณต้องใช้เอกสารการค้นพบ API เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์แบบไม่สาธารณะ คุณต้องส่งคีย์ API เพื่อตรวจสอบสิทธิ์คําขอ

หากต้องการสร้างคีย์ API ให้เปิดโปรเจ็กต์ Google Cloud ของแอปแล้วทำดังนี้

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และ บริการ > ข้อมูลเข้าสู่ระบบ

    ไปที่ข้อมูลเข้าสู่ระบบ

  2. คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
  3. คีย์ API ใหม่จะปรากฏขึ้น
    • คลิกคัดลอก เพื่อคัดลอกคีย์ API เพื่อใช้ในโค้ดของแอป นอกจากนี้ คุณยังดูคีย์ API ในส่วน "คีย์ API" ของข้อมูลเข้าสู่ระบบของโปรเจ็กต์ได้ด้วย
    • คลิกจำกัดคีย์เพื่ออัปเดตการตั้งค่าขั้นสูงและจำกัดการใช้งาน ของคีย์ API ดูรายละเอียดเพิ่มเติมได้ที่การใช้ข้อจำกัดของคีย์ API

เขียนสคริปต์ที่เรียกใช้ 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, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')

    # 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. ในโค้ด ให้แทนที่

    • API_KEY: คีย์ API ที่คุณสร้างเพื่อสร้าง ปลายทางบริการสำหรับ Chat API

    • 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 Groups ออกจากพื้นที่ทำงานในฐานะผู้ดูแลระบบ Google Workspace

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

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

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