במדריך הזה מוסבר איך להשתמש בשיטה list במשאב Section של Google Chat API כדי להציג רשימה של קטעים שזמינים למשתמש המאומת ב-Google Chat.
מידע נוסף זמין במאמר בנושא יצירה וארגון של חלקים ב-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
ListSections. - מגדירים את
parentלהיותusers/me.
בדוגמה הבאה מפורטים קטעים:
Python
from google.cloud import chat_v1
def list_sections():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.ListSectionsRequest(
parent="users/me"
)
# Make the request
page_result = client.list_sections(request=request)
# Handle the response
for section in page_result:
print(section)
Chat API מחזיר רשימה של משאבי Section.
נושאים קשורים
- יצירת אוסף
- עדכון קטע
- מחיקת קטע
- שינוי המיקום של קטע
- הצגת רשימת המרחבים באוסף
- איך מעבירים מרחב לחלק אחר