במדריך הזה מוסבר איך להשתמש בשיטה
list
במשאב SectionItem של Google Chat API כדי להציג רשימה של פריטים (כמו מרחבים) בקטע.
רק מרחבים יכולים להיות פריטים בקטע. מידע נוסף זמין במאמר בנושא יצירה וארגון של חלקים ב-Google Chat.
דרישות מוקדמות
Python
- חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- הגדרת מסך ההסכמה ל-OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud לשימוש ב-Python.
-
יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
credentials.jsonבספרייה המקומית.
- בוחרים היקף הרשאה שתומך באימות משתמשים.
הצגת רשימת המרחבים בקטע
כדי לראות רשימה של מרחבים בקטע עם אימות משתמשים, מעבירים את הפרטים הבאים בבקשה:
- מציינים את היקף ההרשאות של
chat.users.sectionsאוchat.users.sections.readonly. - מבצעים קריאה ל-method
ListSectionItems. - מגדירים את
parentלשם המשאב של החלק.
בדוגמה הבאה מוצגת רשימה של מרחבים בקטע:
Python
from google.cloud import chat_v1
def list_section_items():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.ListSectionItemsRequest(
parent="SECTION_NAME"
)
# Make the request
page_result = client.list_section_items(request=request)
# Handle the response
for item in page_result:
print(item)
כדי להריץ את הדוגמה הזו, מחליפים את הערכים הבאים:
-
SECTION_NAME: שם המשאב של הקטע. כדי לקבל את שם המשאב, מפעילים את השיטהListSections.
Chat API מחזיר רשימה של משאבי SectionItem.