Method: users.sections.position

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

נדרש אימות משתמש עם היקף ההרשאה:

  • https://www.googleapis.com/auth/chat.users.sections

בקשת HTTP

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של הקטע שרוצים למקם.

פורמט: users/{user}/sections/{section}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
שדות
חובה. המיקום החדש של הקטע. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות הבאים:
sortOrder

integer

אופציונלי. המיקום המוחלט של הקטע ברשימת הקטעים. המיקום צריך להיות גדול מ-0. אם המיקום גדול ממספר הקטעים, הקטע יצורף לסוף הרשימה. הפעולה הזו מוסיפה את הקטע במיקום שצוין ומזיזה את הקטע המקורי במיקום הזה, ואת הקטעים שמתחתיו, למיקום הבא.
relativePosition

enum (Position)

אופציונלי. המיקום היחסי של הקטע ברשימת הקטעים.
סוף השדות הבלעדיים.

גוף התשובה

הודעת תגובה למיקום של קטע.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "section": {
    object (Section)
  }
}
שדות
section

object (Section)

הקטע המעודכן.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/chat.users.sections

מידע נוסף זמין במדריך ההרשאות.

מיקום

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

טיפוסים בני מנייה (enum)
POSITION_UNSPECIFIED לא צוין מיקום.
START תחילת רשימת הקטעים.
END סוף רשימת הקטעים.