איך מציגים רשימה של אמוג'י בהתאמה אישית בארגון

במדריך הזה מוסבר איך להשתמש בשיטה list במשאב CustomEmoji של Google Chat API כדי להציג רשימה של סמלי אמוג'י מותאמים אישית שגלויים למשתמש המאומת בארגון Google Workspace.

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

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

Node.js

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.

• מגדירים את הסביבה:
  • יוצרים פרויקט ב-Google Cloud.
  • הגדרת מסך ההסכמה של OAuth.
  • מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
  • מתקינים את ספריית הלקוח של Cloud ל-Node.js.
  • יוצרים פרטי גישה בהתאם לאופן שבו רוצים לבצע אימות בבקשה של Google Chat API:
    • כדי לבצע אימות כמשתמש ב-Chat, יוצרים פרטי כניסה של מזהה לקוח OAuth ושומרים אותם כקובץ JSON בשם credentials.json בספרייה המקומית.
    • כדי לבצע אימות כאפליקציית Chat, יוצרים פרטי כניסה לחשבון שירות ושומרים אותם כקובץ JSON בשם credentials.json.
• בוחרים היקף הרשאה בהתאם לאופן שבו רוצים לבצע אימות – כמשתמש או כאפליקציית Chat.

בדוגמאות הקוד שבדף הזה נעשה שימוש בממשק gRPC API עם ספריות הלקוח של Google Cloud. אפשר גם להשתמש בממשק REST API. מידע נוסף על ממשקי gRPC ו-REST זמין במאמר סקירה כללית על Google Chat API.

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

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

• מציינים את chat.customemojis היקף ההרשאה.
• מבצעים קריאה ל-method‏ ListCustomEmojis.

בדוגמה הבאה מוצגים אמוג'י בהתאמה אישית בארגון.

Node.js

chat/client-libraries/cloud/list-custom-emojis-user-cred.js

הצגת הקוד ב-GitHub

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.customemojis'];

// This sample shows how to get custom emoji with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Optional. Replace FILTER here
    filter: 'FILTER'
  };

  // Make the request
  const pageResult = await chatClient.listCustomEmojisAsync(request);

  // Handle the response. Iterating over pageResult will yield results and
  // resolve additional pages automatically.
  for await (const response of pageResult) {
    console.log(response);
  }
}

main().catch(console.error);

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

• ‫FILTER: אופציונלי, המסנן להחלה על בקשת הרשימה.

נושאים קשורים

• איך יוצרים אמוג'י בהתאמה אישית
• מחיקת אמוג'י בהתאמה אישית
• איך מקבלים פרטים על סמלי אמוג'י בהתאמה אישית