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

במדריך הזה מוסבר איך להשתמש בשיטה get במקור המידע CustomEmojiשל Google Chat API כדי לקבל פרטים על אמוג'י בהתאמה אישית.

אפשר ליצור אמוג'י בהתאמה אישית ולהשתמש בהם רק בחשבונות 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‏ GetCustomEmoji.
• בגוף הבקשה, מגדירים את name לשם המשאב של האמוג'י בהתאמה אישית שרוצים לקבל.

בדוגמה הבאה מוצגים הפרטים של אמוג'י בהתאמה אישית.

Node.js

chat/client-libraries/cloud/get-custom-emoji-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 = {
    // TODO(developer): Replace EMOJI_NAME here
    name: 'customEmojis/EMOJI_NAME'
  };

  // Make the request
  const response = await chatClient.getCustomEmoji(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

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

• ‫EMOJI_NAME: השם הייחודי של סמל האמוג'י המותאם אישית, בשדה emoji_name. אפשר לקבל את המזהה באמצעות קריאה לשיטה ListCustomEmoji(), או מגוף התגובה שמוחזר אחרי יצירת אימוג'י בהתאמה אישית באופן אסינכרוני באמצעות Chat API.

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

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