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

پایتون

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .

• محیط خود را تنظیم کنید:
  • یک پروژه Google Cloud ایجاد کنید .
  • صفحه رضایت OAuth را پیکربندی کنید .
  • Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
  • کتابخانه Google API Client Python را نصب کنید.
  • اعتبارنامه دسترسی را بر اساس نحوه احراز هویت در درخواست Google Chat API خود ایجاد کنید:
    • برای احراز هویت به عنوان کاربر چت، اعتبارنامه های شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام client_secrets.json در فهرست محلی خود ذخیره کنید.
    • برای احراز هویت به‌عنوان برنامه چت، اعتبار حساب سرویس ایجاد کنید و اعتبارنامه‌ها را به‌عنوان فایل JSON با نام credentials.json ذخیره کنید.
• بر اساس اینکه می‌خواهید به‌عنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .

Node.js

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .

• محیط خود را تنظیم کنید:
  • یک پروژه Google Cloud ایجاد کنید .
  • صفحه رضایت OAuth را پیکربندی کنید .
  • Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
  • Node.js Google API Client Library را نصب کنید.
  • اعتبارنامه دسترسی را بر اساس نحوه احراز هویت در درخواست Google Chat API خود ایجاد کنید:
    • برای احراز هویت به عنوان کاربر چت، اعتبارنامه های شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام client_secrets.json در فهرست محلی خود ذخیره کنید.
    • برای احراز هویت به‌عنوان برنامه چت، اعتبار حساب سرویس ایجاد کنید و اعتبارنامه‌ها را به‌عنوان فایل JSON با نام credentials.json ذخیره کنید.
• بر اساس اینکه می‌خواهید به‌عنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .

اسکریپت برنامه ها

• یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .

• محیط خود را تنظیم کنید:
  • یک پروژه Google Cloud ایجاد کنید .
  • صفحه رضایت OAuth را پیکربندی کنید .
  • Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
  • یک پروژه Apps Script مستقل ایجاد کنید و سرویس گفتگوی پیشرفته را روشن کنید.
  • در این راهنما، باید از احراز هویت کاربر یا برنامه استفاده کنید. برای احراز هویت به عنوان برنامه چت، اعتبارنامه حساب سرویس ایجاد کنید. برای مراحل، به تأیید اعتبار و مجوز به عنوان یک برنامه گپ Google مراجعه کنید.
• بر اساس اینکه می‌خواهید به‌عنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .

پایتون

1. در پوشه کاری خود، یک فایل با نام chat_membership_update.py ایجاد کنید.

2. کد زیر را در chat_membership_update.py قرار دهید:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.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.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.
       '''
   
       # Authenticate with Google Workspace
       # and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file(
                         'client_secrets.json', SCOPES)
       creds = flow.run_local_server()
   
       # 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().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. در کد زیر را جایگزین کنید:

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

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

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

   python3 chat_membership_update.py

Node.js

1. در پوشه کاری خود، یک فایل با نام chat_membership_update.js ایجاد کنید.

2. کد زیر را در chat_membership_update.js قرار دهید:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Updates a membership in a Chat space to change it from
   * a space member to a space manager.
   * @return {!Promise<!Object>}
   */
   async function updateSpace() {
   
     /**
     * Authenticate with Google Workspace
     * and get user authorization.
     */
     const scopes = [
       'https://www.googleapis.com/auth/chat.memberships',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     /**
     * Build a service endpoint for Chat API.
     */
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     /**
     * Use the service endpoint to call Chat API.
     */
     return await chatClient.spaces.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',
       requestBody: {
         role: 'ROLE_MANAGER'
       }
     });
   }
   
   /**
   * Use the service endpoint to call Chat API.
   */
   updateSpace().then(console.log);
   

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

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

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

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

   python3 chat_membership_update.js

اسکریپت برنامه ها

این مثال Chat API را با استفاده از Advanced Chat Service فراخوانی می‌کند.

1. محدوده مجوز chat.memberships را به فایل appsscript.json پروژه Apps Script اضافه کنید:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.memberships"
   ]
   

2. تابعی مانند این را به کد پروژه Apps Script اضافه کنید:

   /**
    * Updates a membership from space member to space manager.
    * @param {string} memberName The resource name of the membership.
   */
   function updateMembershipToSpaceManager(memberName) {
     try {
       const body = {'role': 'ROLE_MANAGER'};
       Chat.Spaces.Members.patch(memberName, body);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to create membership with error %s', err.message);
     }
   }
   

پایتون

1. در پوشه کاری خود، یک فایل با نام chat_membership_update.py ایجاد کنید.

2. کد زیر را در chat_membership_update.py قرار دهید:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.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.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.
       '''
   
       # Authenticate with Google Workspace
       # and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file(
                         'client_secrets.json', SCOPES)
       creds = flow.run_local_server()
   
       # 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().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. در کد زیر را جایگزین کنید:

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

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

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

   python3 chat_membership_update.py

Node.js

1. در پوشه کاری خود، یک فایل با نام chat_membership_update.js ایجاد کنید.

2. کد زیر را در chat_membership_update.js قرار دهید:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Updates a membership in a Chat space to change it from
   * a space manager to a space member.
   * @return {!Promise<!Object>}
   */
   async function updateSpace() {
   
     /**
     * Authenticate with Google Workspace
     * and get user authorization.
     */
     const scopes = [
       'https://www.googleapis.com/auth/chat.memberships',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     /**
     * Build a service endpoint for Chat API.
     */
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     /**
     * Use the service endpoint to call Chat API.
     */
     return await chatClient.spaces.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',
       requestBody: {
         role: 'ROLE_MEMBER'
       }
     });
   }
   
   /**
   * Use the service endpoint to call Chat API.
   */
   updateSpace().then(console.log);
   

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

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

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

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

   python3 chat_membership_update.js

اسکریپت برنامه ها

این مثال Chat API را با استفاده از Advanced Chat Service فراخوانی می‌کند.

1. محدوده مجوز chat.memberships را به فایل appsscript.json پروژه Apps Script اضافه کنید:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.memberships"
   ]
   

2. تابعی مانند این را به کد پروژه Apps Script اضافه کنید:

   /**
    * Updates a membership from space manager to space member.
    * @param {string} memberName The resource name of the membership.
   */
   function updateMembershipToSpaceMember(memberName) {
     try {
       const body = {'role': 'ROLE_MEMBER'};
       Chat.Spaces.Members.patch(memberName, body);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to create membership with error %s', err.message);
     }
   }
   

پایتون

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

پایتون

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