به روز رسانی عضویت کاربر در فضای چت گوگل، به روز رسانی عضویت کاربر در فضای چت گوگل

این راهنما نحوه استفاده از متد update() را در منبع Membership API Google Chat برای تغییر ویژگی‌های عضویت، مانند تغییر عضو فضایی به مدیر فضایی یا تغییر مدیر فضایی به عضو فضایی توضیح می‌دهد.

اگر یک سرپرست Google Workspace هستید، می‌توانید برای به‌روزرسانی عضویت هر فضا در سازمان Google Workspace خود، متد update() را فراخوانی کنید.

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

پیش نیازها

Node.js

یک عضویت را به روز کنید

برای به‌روزرسانی عضویت فضایی، موارد زیر را در درخواست خود بنویسید:

  • محدوده مجوز را مشخص کنید:
  • متد UpdateMembership() را فراخوانی کنید.
  • تصویب membership به عنوان نمونه ای از Membership با موارد زیر:
    • فیلد name روی عضویت برای به‌روزرسانی تنظیم شده است که شامل شناسه فاصله و شناسه عضو است.
    • فیلدهای عضویت برای به‌روزرسانی روی مقادیر جدید تنظیم می‌شوند.
  • برای مشخص کردن جنبه های عضویت برای به روز رسانی، updateMask پاس کنید، شامل موارد زیر است:
    • role : نقش کاربر در فضای چت، که اقدامات مجاز آنها را در فضا تعیین می کند. مقادیر ممکن عبارتند از:
      • ROLE_MEMBER : عضوی از فضا. کاربر دارای مجوزهای اولیه مانند ارسال پیام به فضا است. در مکالمات گروهی 1:1 و بدون نام، همه این نقش را دارند.
      • ROLE_MANAGER : یک مدیر فضا. کاربر تمام مجوزهای اولیه به اضافه مجوزهای مدیریتی را دارد که به او اجازه می دهد فضا را مدیریت کند، مانند افزودن یا حذف اعضا. فقط در فضاهایی که spaceType SPACE است (فضاهای نامگذاری شده) پشتیبانی می شود.

یک عضو معمولی فضایی را به عنوان کاربر مدیر فضا کنید

مثال زیر Chat API را با استفاده از احراز هویت کاربر فراخوانی می‌کند تا با تعیین role به‌عنوان ROLE_MANAGER یک عضو فضای معمولی را به عنوان مدیر فضا تبدیل کند:

Node.js

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

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

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

  // Initialize request argument(s)
  const request = {
    membership: {
      // Replace SPACE_NAME and MEMBER_NAME here
      name: 'spaces/SPACE_NAME/members/MEMBER_NAME',
      // Replace ROLE_NAME here with ROLE_MEMBER or ROLE_MANAGER
      role: 'ROLE_NAME'
    },
    updateMask: {
      // The field paths to update.
      paths: ['role']
    }
  };

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

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

main().catch(console.error);

برای اجرای نمونه، موارد زیر را جایگزین کنید:

  • SPACE_NAME : شناسه از name فضا. شما می توانید شناسه را با فراخوانی متد ListSpaces() یا از URL فضا بدست آورید.
  • MEMBER_NAME : شناسه از name عضویت. شما می توانید با فراخوانی متد ListMemberships() یا از بدنه پاسخی که پس از ایجاد عضویت به طور ناهمزمان با Chat API بازگردانده شده است، شناسه را دریافت کنید.
  • ROLE_NAME : نقش به روز شده، ROLE_MANAGER .

Google Chat API عضویت مشخص شده را به یک مدیر فضا به‌روزرسانی می‌کند و نمونه‌ای از Membership را برمی‌گرداند.

یک مدیر فضایی را به عنوان یک کاربر به عضویت عادی در آورید

مثال زیر Chat API را با استفاده از احراز هویت کاربر فراخوانی می‌کند تا با تعیین role به‌عنوان ROLE_MEMBER یک مدیر فضایی را به یک عضو فضای معمولی تبدیل کند:

Node.js

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

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

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

  // Initialize request argument(s)
  const request = {
    membership: {
      // Replace SPACE_NAME and MEMBER_NAME here
      name: 'spaces/SPACE_NAME/members/MEMBER_NAME',
      // Replace ROLE_NAME here with ROLE_MEMBER or ROLE_MANAGER
      role: 'ROLE_NAME'
    },
    updateMask: {
      // The field paths to update.
      paths: ['role']
    }
  };

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

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

main().catch(console.error);

برای اجرای نمونه، موارد زیر را جایگزین کنید:

  • SPACE_NAME : شناسه از name فضا. شما می توانید شناسه را با فراخوانی متد ListSpaces() یا از URL فضا بدست آورید.
  • MEMBER_NAME : شناسه از name عضویت. شما می توانید با فراخوانی متد ListMemberships() یا از بدنه پاسخی که پس از ایجاد عضویت به طور ناهمزمان با Chat API بازگردانده شده است، شناسه را دریافت کنید.
  • ROLE_NAME : نقش به روز شده، ROLE_MEMBER .

Google Chat API عضویت مشخص شده را به یک مدیر فضا به‌روزرسانی می‌کند و نمونه‌ای از Membership را برمی‌گرداند.

یک عضو معمولی فضایی را به عنوان یک برنامه چت مدیر فضا کنید

احراز هویت برنامه نیاز به تأیید یکباره سرپرست دارد.

یک کلید API ایجاد کنید

برای فراخوانی یک روش API پیش‌نمایش برنامه‌نویس، باید از یک نسخه پیش‌نمایش برنامه‌نویس غیرعمومی سند کشف API استفاده کنید. برای احراز هویت درخواست، باید یک کلید API ارسال کنید.

برای ایجاد کلید API، پروژه Google Cloud برنامه خود را باز کنید و کارهای زیر را انجام دهید:

  1. در کنسول Google Cloud، به منو > APIs & Services > Credentials بروید.

    به Credentials بروید

  2. روی ایجاد اعتبارنامه > کلید API کلیک کنید.
  3. کلید API جدید شما نمایش داده می شود.
    • روی Copy کلیک کنید تا کلید API خود را برای استفاده در کد برنامه خود کپی کنید. کلید API را می‌توانید در بخش «کلیدهای API» اعتبار پروژه‌تان پیدا کنید.
    • برای به‌روزرسانی تنظیمات پیشرفته و محدود کردن استفاده از کلید API، روی Restrict key کلیک کنید. برای جزئیات بیشتر، به اعمال محدودیت‌های کلید API مراجعه کنید.

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

مثال زیر Chat API را با استفاده از احراز هویت برنامه فراخوانی می‌کند تا با تعیین role به‌عنوان ROLE_MANAGER در body که ویژگی‌های عضویت به‌روز شده را مشخص می‌کند، یک عضو فضای معمولی را به عنوان مدیر فضا تبدیل کند:

پایتون

  1. در فهرست کاری خود، فایلی با نام chat_membership_update_to_manager_app.py ایجاد کنید.

  2. کد زیر را در chat_membership_update_to_manager_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 updates a specified space member to change
    it from a regular member to a space manager.
    '''

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

        # The membership to update, and the updated role.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBERSHIP with a membership name.
        # Obtain the membership name from the membership of Chat API.
        name='spaces/SPACE/members/MEMBERSHIP',
        updateMask='role',
        body={'role': 'ROLE_MANAGER'}

      ).execute()

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

if __name__ == '__main__':
    main()

  3. در کد زیر را جایگزین کنید:

    • API_KEY : کلید API که برای ساختن نقطه پایانی سرویس برای Chat API ایجاد کردید.

    • SPACE : نام فضایی است که می توانید از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.

    • MEMBERSHIP : یک نام عضویت که می توانید از روش spaces.members.list در Chat API بدست آورید.

  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_membership_update_to_manager_app.py

یک مدیر فضا را به عنوان یک برنامه چت به عضویت عادی خود درآورید

احراز هویت برنامه نیاز به تأیید یکباره سرپرست دارد.

یک کلید API ایجاد کنید

برای فراخوانی یک روش API پیش‌نمایش برنامه‌نویس، باید از یک نسخه پیش‌نمایش برنامه‌نویس غیرعمومی سند کشف API استفاده کنید. برای احراز هویت درخواست، باید یک کلید API ارسال کنید.

برای ایجاد کلید API، پروژه Google Cloud برنامه خود را باز کنید و کارهای زیر را انجام دهید:

  1. در کنسول Google Cloud، به منو > APIs & Services > Credentials بروید.

    به Credentials بروید

  2. روی ایجاد اعتبارنامه > کلید API کلیک کنید.
  3. کلید API جدید شما نمایش داده می شود.
    • روی Copy کلیک کنید تا کلید API خود را برای استفاده در کد برنامه خود کپی کنید. کلید API را می‌توانید در بخش «کلیدهای API» اعتبار پروژه‌تان پیدا کنید.
    • برای به‌روزرسانی تنظیمات پیشرفته و محدود کردن استفاده از کلید API، روی Restrict key کلیک کنید. برای جزئیات بیشتر، به اعمال محدودیت‌های کلید API مراجعه کنید.

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

مثال زیر Chat API را با استفاده از احراز هویت برنامه فراخوانی می‌کند تا با تعیین role به‌عنوان ROLE_MEMBER در body که ویژگی‌های عضویت به‌روز شده را مشخص می‌کند، یک مدیر فضایی را به عضوی از فضای عادی تبدیل کند:

پایتون

  1. در فهرست کاری خود، فایلی با نام chat_membership_update_to_member_app.py ایجاد کنید.

  2. کد زیر را در chat_membership_update_to_member_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 via user credentials,
    then updates a specified space member to change
    it from a regular member to a space manager.
    '''

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

        # The membership to update, and the updated role.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBERSHIP with a membership name.
        # Obtain the membership name from the membership of Chat API.
        name='spaces/SPACE/members/MEMBERSHIP',
        updateMask='role',
        body={'role': 'ROLE_MEMBER'}

      ).execute()

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

if __name__ == '__main__':
    main()

  3. در کد زیر را جایگزین کنید:

    • API_KEY : کلید API که برای ساختن نقطه پایانی سرویس برای Chat API ایجاد کردید.

    • SPACE : نام فضایی است که می توانید از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.

    • MEMBERSHIP : یک نام عضویت که می توانید از روش spaces.members.list در Chat API بدست آورید.

  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_membership_update_to_member_app.py

عضویت ها را به عنوان سرپرست Google Workspace به روز کنید

اگر سرپرست Google Workspace هستید، می‌توانید برای به‌روزرسانی عضویت‌ها برای هر فضایی در سازمان Google Workspace خود، روش update() را فراخوانی کنید.

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

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

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