במדריך הזה מוסבר איך להשתמש בשיטה
move
במשאב 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היקף ההרשאה. - מבצעים קריאה ל-method
MoveSectionItem. - בגוף הבקשה, מציינים את
nameשל פריט הקטע שרוצים להעביר ואתtargetSection:- מגדירים את
nameלשם המשאב של פריט הקטע (לדוגמה,users/me/sections/default-spaces/items/spaces/123456). - מגדירים את
targetSectionלשם המשאב של הקטע שאליו רוצים להעביר את הפריט.
- מגדירים את
בדוגמה הבאה מועבר מרחב לקטע אחר:
Python
from google.cloud import chat_v1
def move_section_item():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.MoveSectionItemRequest(
name="SECTION_ITEM_NAME",
target_section="TARGET_SECTION_NAME"
)
# Make the request
response = client.move_section_item(request=request)
print(response)
כדי להריץ את הדוגמה הזו, מחליפים את הערכים הבאים:
-
SECTION_ITEM_NAME: שם המשאב של פריט הקטע. -
TARGET_SECTION_NAME: שם המשאב של קטע היעד.
Chat API מחזיר את המופע המעודכן של SectionItem.