یک عضو را از یک فاصله حذف کنید

این راهنما نحوه استفاده از متد delete() در منبع Membership از Google Chat API را برای حذف اعضا از یک فضا، که به عنوان حذف عضویت نیز شناخته می‌شود، توضیح می‌دهد. مدیران فضا را نمی‌توان حذف کرد اگر تنها مدیر فضا در یک فضا باشند. قبل از حذف این عضویت‌ها، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

اگر سرپرست Google Workspace هستید، می‌توانید کاربران، گروه‌های Google یا برنامه‌های چت را از هر فضایی در سازمان Google Workspace خود حذف کنید.

منبع Membership نشان می‌دهد که آیا یک کاربر انسانی یا برنامه Google Chat به یک فضا دعوت شده، بخشی از آن است یا در آن حضور ندارد.

پیش‌نیازها

نود جی اس

حذف یک عضو از یک فضا به عنوان کاربر

برای حذف یک کاربر، گروه گوگل یا برنامه چت از فضایی که احراز هویت کاربر در آن انجام شده است، کد زیر را در درخواست خود وارد کنید:

  • دامنه مجوز chat.memberships را مشخص کنید. کاربر مجاز باید مجوز حذف کاربر یا گروه گوگل از فضا را داشته باشد. برای حذف یک برنامه چت، دامنه مجوز chat.memberships.app را مشخص کنید (برنامه‌ها فقط می‌توانند عضویت خود را حذف کنند؛ نه عضویت برنامه‌های دیگر). به عنوان بهترین روش، محدودترین دامنه‌ای را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می‌دهد.
  • متد DeleteMembership() را فراخوانی کنید.
  • name عضویت را برای حذف ارسال کنید. اگر عضویت متعلق به تنها مدیر فضا در یک فضا است، قبل از حذف این عضویت، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

در اینجا نحوه حذف عضویت با احراز هویت کاربر آورده شده است:

نود جی اس

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.app.memberships را مشخص کنید. حذف عضویت یک مدیر فضا فقط در فضاهای ایجاد شده توسط برنامه‌های چت پشتیبانی می‌شود.
  • متد delete را روی منبع membership فراخوانی کنید.
  • name عضویت را برای حذف ارسال کنید. اگر عضویت متعلق به تنها مدیر فضا در یک فضا است، قبل از حذف این عضویت، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

اسکریپتی بنویسید که Chat API را فراخوانی کند

در اینجا نحوه حذف عضویت با احراز هویت برنامه آمده است:

پایتون

  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 Workspace

اگر شما مدیر Google Workspace هستید، می‌توانید متد DeleteMembership() را برای حذف کاربران، گروه‌های Google یا برنامه‌های چت از هر فضایی در سازمان Google Workspace خود فراخوانی کنید.

برای فراخوانی این روش به عنوان مدیر Google Workspace، موارد زیر را انجام دهید:

  • با استفاده از احراز هویت کاربر، متد را فراخوانی کنید و یک محدوده مجوز مشخص کنید که از فراخوانی متد با استفاده از امتیازات مدیر پشتیبانی کند.
  • در درخواست خود، پارامتر query useAdminAccess را برابر با true قرار دهید.

برای اطلاعات و مثال‌های بیشتر، به مدیریت فضاهای چت گوگل به عنوان مدیر فضای کاری گوگل مراجعه کنید.

محدودیت‌ها و ملاحظات

  • با احراز هویت برنامه ، یک برنامه چت می‌تواند کاربران را حذف کند، اما گروه‌های گوگل یا برنامه‌های چت نمی‌توانند.
،

این راهنما نحوه استفاده از متد delete() در منبع Membership از Google Chat API را برای حذف اعضا از یک فضا، که به عنوان حذف عضویت نیز شناخته می‌شود، توضیح می‌دهد. مدیران فضا را نمی‌توان حذف کرد اگر تنها مدیر فضا در یک فضا باشند. قبل از حذف این عضویت‌ها، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

اگر سرپرست Google Workspace هستید، می‌توانید کاربران، گروه‌های Google یا برنامه‌های چت را از هر فضایی در سازمان Google Workspace خود حذف کنید.

منبع Membership نشان می‌دهد که آیا یک کاربر انسانی یا برنامه Google Chat به یک فضا دعوت شده، بخشی از آن است یا در آن حضور ندارد.

پیش‌نیازها

نود جی اس

حذف یک عضو از یک فضا به عنوان کاربر

برای حذف یک کاربر، گروه گوگل یا برنامه چت از فضایی که احراز هویت کاربر در آن انجام شده است، کد زیر را در درخواست خود وارد کنید:

  • دامنه مجوز chat.memberships را مشخص کنید. کاربر مجاز باید مجوز حذف کاربر یا گروه گوگل از فضا را داشته باشد. برای حذف یک برنامه چت، دامنه مجوز chat.memberships.app را مشخص کنید (برنامه‌ها فقط می‌توانند عضویت خود را حذف کنند؛ نه عضویت برنامه‌های دیگر). به عنوان بهترین روش، محدودترین دامنه‌ای را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می‌دهد.
  • متد DeleteMembership() را فراخوانی کنید.
  • name عضویت را برای حذف ارسال کنید. اگر عضویت متعلق به تنها مدیر فضا در یک فضا است، قبل از حذف این عضویت، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

در اینجا نحوه حذف عضویت با احراز هویت کاربر آورده شده است:

نود جی اس

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.app.memberships را مشخص کنید. حذف عضویت یک مدیر فضا فقط در فضاهای ایجاد شده توسط برنامه‌های چت پشتیبانی می‌شود.
  • متد delete را روی منبع membership فراخوانی کنید.
  • name عضویت را برای حذف ارسال کنید. اگر عضویت متعلق به تنها مدیر فضا در یک فضا است، قبل از حذف این عضویت، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

اسکریپتی بنویسید که Chat API را فراخوانی کند

در اینجا نحوه حذف عضویت با احراز هویت برنامه آمده است:

پایتون

  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 Workspace

اگر شما مدیر Google Workspace هستید، می‌توانید متد DeleteMembership() را برای حذف کاربران، گروه‌های Google یا برنامه‌های چت از هر فضایی در سازمان Google Workspace خود فراخوانی کنید.

برای فراخوانی این روش به عنوان مدیر Google Workspace، موارد زیر را انجام دهید:

  • با استفاده از احراز هویت کاربر، متد را فراخوانی کنید و یک محدوده مجوز مشخص کنید که از فراخوانی متد با استفاده از امتیازات مدیر پشتیبانی کند.
  • در درخواست خود، پارامتر query useAdminAccess را برابر با true قرار دهید.

برای اطلاعات و مثال‌های بیشتر، به مدیریت فضاهای چت گوگل به عنوان مدیر فضای کاری گوگل مراجعه کنید.

محدودیت‌ها و ملاحظات

  • با احراز هویت برنامه ، یک برنامه چت می‌تواند کاربران را حذف کند، اما گروه‌های گوگل یا برنامه‌های چت نمی‌توانند.