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 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
שדות
שדה איחוד position. חובה. המיקום החדש של הקטע. הערך 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 סוף רשימת הקטעים.