עדכון קטע

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

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

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

Python

עדכון קטע

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

  • מציינים את chat.users.sections היקף ההרשאה.
  • מבצעים קריאה ל-method‏ UpdateSection.
  • בגוף הבקשה, מציינים משאב Section ומסכת שדות:
    • מגדירים את name של הקטע שרוצים לעדכן.
    • מגדירים את displayName לשם החדש של החלק.
    • מגדירים את updateMask להיות displayName.

בדוגמה הבאה מעדכנים קטע:

Python

from google.cloud import chat_v1
from google.protobuf import field_mask_pb2

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

    # Initialize request
    request = chat_v1.UpdateSectionRequest(
        section=chat_v1.Section(
            name="SECTION_NAME",
            display_name="NEW_SECTION_DISPLAY_NAME"
        ),
        update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
    )

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

    print(response)

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

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

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