این راهنما نحوه استفاده از روش get
در منبع membership
Google Chat API برای دریافت جزئیات عضویت در یک فضا توضیح میدهد.
منبع Membership
نشان میدهد که آیا کاربر انسانی یا برنامه چت Google به یک فضا دعوت شده، بخشی از آن یا غایب است.
احراز هویت با احراز هویت برنامه به برنامه Chat امکان میدهد از فضاهایی که در Google Chat به آنها دسترسی دارد (مثلاً فضاهایی که عضو آن است)، عضویت دریافت کند، اما عضویتهای برنامه Chat، از جمله خود، را استثنا نمیکند. احراز هویت با احراز هویت کاربر ، عضویت ها را از فضاهایی که کاربر احراز هویت شده به آنها دسترسی دارد، برمی گرداند.
پیش نیازها
پایتون
- پایتون 3.6 یا بالاتر
- ابزار مدیریت بسته پیپ
جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.
مجوز برای برنامه چت پیکربندی شد. دریافت عضویت از هر دو روش احراز هویت زیر پشتیبانی می کند:
- احراز هویت کاربر با محدوده مجوز
chat.memberships.readonly
یاchat.memberships
. - احراز هویت برنامه با محدوده مجوز
chat.bot
.
- احراز هویت کاربر با محدوده مجوز
جزئیات عضویت را دریافت کنید
برای دریافت جزئیات عضویت در Google Chat، موارد زیر را در درخواست خود بنویسید:
- با احراز هویت برنامه ، محدوده مجوز
chat.bot
را مشخص کنید. با احراز هویت کاربر ، محدوده مجوزchat.memberships.readonly
یاchat.memberships
را مشخص کنید. به عنوان بهترین روش، محدودترین محدوده را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می دهد. - روش
get
را در منبعmembership
فراخوانی کنید. - برای دریافت
name
عضویت را ارسال کنید. نام عضویت را از منبع عضویت Google Chat دریافت کنید.
در اینجا نحوه دریافت عضویت با احراز هویت کاربر آورده شده است:
پایتون
- در پوشه کاری خود، یک فایل با نام
chat_membership_get.py
ایجاد کنید. کد زیر را در
chat_membership_get.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.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a specified membership. ''' # 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().get( # The membership to get. # # 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. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
در کد زیر را جایگزین کنید:
-
SPACE
: نام فضایی است که می توانید از روشspaces.list
در Chat API یا از URL یک فضا دریافت کنید. -
MEMBER
: یک نام عضویت که می توانید از روشspaces.members.list
در Chat API دریافت کنید.
-
در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 chat_membership_get.py
Chat API نمونه ای از membership
با جزئیات عضویت مشخص شده برمی گرداند.
مطالب مرتبط
- اعضا را در یک فضا فهرست کنید .
- یک کاربر یا برنامه چت را به یک فضا دعوت یا اضافه کنید .
- عضویت کاربر را در فضای چت Google به روز کنید .
- یک کاربر یا برنامه چت را از یک فضا حذف کنید .