שינוי המיקום של קטע

במדריך הזה מוסבר איך להשתמש בשיטה position במשאב Section של Google Chat API כדי לשנות את סדר המיון של קטע ב-Google Chat.

מידע נוסף זמין במאמר בנושא יצירה וארגון של חלקים ב-Google Chat.

דרישות מוקדמות

Python

שינוי המיקום של קטע

כדי לשנות את המיקום של קטע עם אימות משתמש, מעבירים את הפרטים הבאים בבקשה:

  • מציינים את chat.users.sections היקף ההרשאה.
  • מבצעים קריאה ל-method‏ PositionSection.
  • בגוף הבקשה, מציינים את name של החלק שרוצים למקם ואת המיקום החדש:
    • מגדירים את sortOrder למיקום מוחלט (גדול מ-0).
    • או מגדירים את relativePosition לערך START או END.

בדוגמה הבאה מוצג מעבר של קטע לתחילת הרשימה:

Python

from google.cloud import chat_v1

def position_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.PositionSectionRequest(
        name="SECTION_NAME",
        relative_position=chat_v1.PositionSectionRequest.Position.START
    )

    # Make the request
    response = client.position_section(request=request)

    print(response)

כדי להריץ את הדוגמה הזו, מחליפים את הערכים הבאים:

  • ‫SECTION_NAME: שם המשאב של הקטע. כדי לקבל את שם המשאב, מפעילים את השיטה ListSections.

‫Chat API מחזיר את המופע המעודכן של Section.