במדריך הזה מוסבר איך להשתמש ב-method create במשאב Section של Google Chat API כדי ליצור מדור מותאם אישית חדש ב-Google Chat.
הקטעים עוזרים למשתמשים לקבץ את השיחות שלהם ולהתאים אישית את רשימת המרחבים שמוצגת בחלונית הניווט של 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היקף ההרשאה. - מבצעים קריאה ל-method
CreateSection. - בגוף הבקשה, מציינים משאב
Section:- מגדירים את
displayNameלשם של הקטע (עד 80 תווים). - מגדירים את
typeלהיותCUSTOM_SECTION.
- מגדירים את
בדוגמה הבאה נוצר קטע:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
כדי להריץ את הדוגמה הזו, מחליפים את הערכים הבאים:
-
SECTION_DISPLAY_NAME: השם של הקטע החדש.
ה-Chat API מחזיר מופע של
Section עם פרטים על הקטע שנוצר.
נושאים קשורים
- עדכון קטע
- מחיקת קטע
- שינוי המיקום של קטע
- List sections
- הצגת רשימת המרחבים באוסף
- איך מעבירים מרחב לחלק אחר