Method: customEmojis.list

הצגת רשימה של סמלי אמוג'י בהתאמה אישית גלויים למשתמשים מאומתים.

נדרש אימות משתמש.

בקשת HTTP

GET https://chat.googleapis.com/v1/customEmojis

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

פרמטרים של שאילתה

פרמטרים
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של סמלי אמוג'י בהתאמה אישית שאפשר להחזיר. השירות יכול להחזיר פחות סמלי אמוג'י בהתאמה אישית מהערך הזה. אם לא מציינים ערך, ערך ברירת המחדל הוא 25. הערך המקסימלי הוא 200. ערכים מעל 200 משתנים ל-200.
pageToken

string

זה שינוי אופציונלי. (אם ממשיכים משאילתה קודמת).

אסימון דף שהתקבל משיחה קודמת עם אמוג'י בהתאמה אישית ברשימה. צריך לספק אותו כדי לאחזר את הדף הבא.

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

string

זה שינוי אופציונלי. מסנן שאילתות.

תמיכה בסינון לפי יוצר.

כדי לסנן לפי יוצר, צריך לציין ערך חוקי. בשלב הזה, אפשר לסנן רק אמוג'י בהתאמה אישית לפי creator("users/me") ו-NOT creator("users/me") לפי אם המשתמש המתקשר יצר אותם או לא.

לדוגמה, השאילתה הבאה מחזירה אמוג'י בהתאמה אישית שנוצר על ידי מבצע הקריאה החוזרת:

creator("users/me")

שאילתות לא חוקיות נדחות על ידי השרת עם שגיאה INVALID_ARGUMENT.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תגובה לרשימת אמוג'י בהתאמה אישית.

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

ייצוג JSON 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
שדות
customEmojis[]

object (CustomEmoji)

רשימה לא ממוינת. רשימת סמלי אמוג'י בהתאמה אישית בדף המבוקש (או הראשון).
nextPageToken

string

אסימון שאפשר לשלוח בתור pageToken כדי לאחזר את דף התוצאות הבא. אם השדה ריק, אין דפים נוספים.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

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