אובייקטים ושגיאות של תגובה

בדף הזה מפורטים אובייקטים שונים של תגובות JSON ושגיאות שמשמשים את Tenor API.

אובייקט התגובה

בטבלה הבאה מפורטים המאפיינים של אובייקטים של תגובה:

מאפיינים
created

float

חותמת זמן של מערכת Unix שמייצגת את הזמן שבו הפוסט הזה נוצר.
hasaudio

boolean

הפונקציה מחזירה את הערך true אם הפוסט הזה מכיל אודיו.
id

string

מזהה תוצאת טנור
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

מילון עם פורמט תוכן כמפתח ואובייקט מדיה כערך.
tags

string[]

מערך של תגים לפוסט
title

string

הכותרת של הפוסט
content_description

string

תיאור מילולי של התוכן.

מומלץ להשתמש ב-content_description לתכונות נגישות למשתמשים.
itemurl

string

כתובת ה-URL המלאה לצפייה בפוסט בכתובת tenor.com.
hascaption

boolean

הפונקציה מחזירה true אם הפוסט הזה מכיל כתוביות.
flags

string

רשימה מופרדת באמצעות פסיקים שמציינת אם התוכן הוא סטיקר או תמונה סטטית, אם יש לו אודיו או אם הוא שילוב כלשהו של האפשרויות האלה. אם התגים sticker ו-static לא מופיעים, התוכן הוא קובץ GIF. שדה flags ריק מציין קובץ GIF ללא אודיו.
bg_color

string

צבע הפיקסל הנפוץ ביותר ברקע של התוכן
url

string

כתובת URL קצרה לצפייה בפוסט בכתובת tenor.com.

אובייקט קטגוריה

בטבלה הבאה מפורטות המאפיינים של אובייקטים של קטגוריות:

מאפיינים
searchterm

string

מונח החיפוש שמתאים לקטגוריה. מונח החיפוש מתורגם כדי להתאים לlocale של הבקשה המתאימה.
path

string

כתובת ה-URL של החיפוש שתישלח בקשה לגביה אם המשתמש יבחר את הקטגוריה
image

string

כתובת URL למקור המדיה של קובץ ה-GIF לדוגמה של הקטגוריה
name

string

שם הקטגוריה שיוצג כשכבת-על מעל התמונה. השם מתורגם כך שיתאים ל-locale של הבקשה המתאימה.

אובייקט מדיה

בטבלה הבאה מפורטים המאפיינים של אובייקטים של מדיה:

מאפיינים
url

string

כתובת URL למקור המדיה
dims

int[]

הרוחב והגובה של המדיה בפיקסלים
duration

float

מייצג את הזמן בשניות של לולאה אחת של התוכן. אם התוכן סטטי, משך הזמן מוגדר ל-0.
size

int

גודל הקובץ בבייטים

פורמטים של תוכן

ממשק ה-API של Tenor מציע את חמשת הפורמטים הבסיסיים הבאים במגוון גדלים:

  • GIF
  • MP4
  • WebM
  • WebP שקוף
  • קובץ GIF שקוף

הפורמטים MP4 ו-WebM מפעילים את הקליפ רק פעם אחת, למעט loopedmp4, שמפעיל את הקליפ כמה פעמים. פורמט GIF מציג את הקליפ בלופ מתמשך. הפורמטים השקופים מיועדים לתוכן של סטיקרים ולא זמינים בתוצאות החיפוש של קובצי GIF.

סוגי פורמטים

בטבלה הבאה מפורטים סוגי פורמטי המדיה שזמינים ב-Tenor:

סוגי פורמטים
preview
  • רזולוציה וגודל: פורמט GIF של פריים יחיד באיכות גבוהה; קטן יותר בגודל מפורמט GIF
  • מידות: המידות המקוריות של התמונה שהועלתה (ללא הגבלות)
  • הערות לגבי השימוש: צריך להוסיף את המסגרת הזו בתחילת התוכן. התמונה מיועדת לשימוש כתצוגה מקדימה של תמונה ממוזערת.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
gif
  • רזולוציה וגודל: פורמט GIF באיכות גבוהה; גודל הקובץ הגדול ביותר שזמין
  • מידות: המידות המקוריות של התמונה שהועלתה (ללא הגבלות)
  • הערות לגבי שימוש: אפשר להשתמש בגודל הזה לשיתוף קובצי GIF במחשב.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
mediumgif
  • רזולוציה וגודל: הקטנה קלה בגודל של פורמט ה-GIF
  • מידות: המידות המקוריות של ההעלאה (ללא הגבלות), אבל עם שיעור דחיסה גבוה בהרבה
  • הערות לגבי השימוש: משתמשים בגודל הזה לתצוגות מקדימות של קובצי GIF במחשב.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
tinygif
  • רזולוציה וגודל: גודל מופחת של פורמט GIF
  • מידות: רוחב של עד 220 פיקסלים. הגובה משתנה כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי שימוש: כדאי להשתמש בגודל הזה לתצוגות מקדימות של קובצי GIF ולשיתוף שלהם בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
nanogif
  • רזולוציה וגודל: הגודל הכי קטן של פורמט GIF
  • מידות: גובה של עד 90 פיקסלים. הרוחב משתנה כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי שימוש: אפשר להשתמש בגודל הזה לתצוגות מקדימות של קובצי GIF בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
mp4
  • רזולוציה וגודל: פורמט הווידאו באיכות הכי גבוהה; הגדול מבין פורמטי הווידאו, אבל קטן יותר מ-GIF
  • מאפיינים: דומה ל-GIF אבל עם ריווח כדי להתאים למפרט של מאגר הסרטונים, שבדרך כלל מוגדר במרווחים של 8 פיקסלים.
  • הערות לגבי שימוש: כדאי להשתמש בגודל הזה לתצוגות מקדימות ולשיתופים של קובצי MP4 במחשב.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
loopedmp4
  • רזולוציה וגודל: פורמט הווידאו באיכות הכי גבוהה; גדול יותר מ-MP4
  • מאפיינים: דומה ל-GIF אבל עם ריווח כדי להתאים למפרט של מאגר הסרטונים, שבדרך כלל מוגדר במרווחים של 8 פיקסלים.
  • הערות לגבי השימוש: כדאי להשתמש בגודל הזה לשיתופי MP4 כשרוצים שהקליפ יפעל כמה פעמים ולא רק פעם אחת.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
tinymp4
  • רזולוציה וגודל: גודל מופחת של פורמט MP4
  • מידות: רוחב וגובה משתנים, עם תיבה תוחמת (bounding box) מקסימלית של 320x320 פיקסלים
  • הערות לגבי שימוש: אפשר להשתמש בגודל הזה לתצוגות מקדימות ולשיתופים של קובצי MP4 בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
nanomp4
  • רזולוציה וגודל: הגודל הכי קטן של פורמט MP4
  • מידות: רוחב וגובה משתנים, עם תיבה תוחמת מקסימלית של 150x150 פיקסלים
  • הערות לגבי שימוש: משתמשים בגודל הזה לתצוגות מקדימות של MP4 בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
webm
  • רזולוציה וגודל: פורמט וידאו באיכות נמוכה יותר; קטן יותר מ-MP4
  • מאפיינים: דומה ל-GIF אבל עם ריווח כדי להתאים למפרט של מאגר הסרטונים, שבדרך כלל מוגדר במרווחים של 8 פיקסלים.
  • הערות לגבי השימוש: כדאי להשתמש בגודל הזה לתצוגות מקדימות ולשיתופים של WebM במחשב.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
tinywebm
  • רזולוציה וגודל: גודל מופחת של פורמט WebM
  • מידות: רוחב וגובה משתנים, עם תיבה תוחמת (bounding box) מקסימלית של 320x320 פיקסלים
  • הערות לגבי שימוש: אפשר להשתמש בגודל הזה לשיתוף קובצי GIF בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
nanowebm
  • רזולוציה וגודל: הגודל הכי קטן של פורמט WebM
  • מידות: רוחב וגובה משתנים, עם תיבה תוחמת מקסימלית של 150x150 פיקסלים
  • הערות לגבי שימוש: אפשר להשתמש בגודל הזה לתצוגות מקדימות של קובצי GIF בנייד.

הפורמט הזה נתמך בקובצי GIF ובסטיקרים.
webp_transparent
  • רזולוציה וגודל: פורמט מדבקה באיכות גבוהה ב-WebP; גודל הקובץ הגדול ביותר שזמין
  • מידות: המידות המקוריות של התמונה שהועלתה (ללא הגבלות)
  • הערות לגבי השימוש: השתמשו בגודל הזה לשיתוף סטיקרים עם משתמשים שיש להם רוחב פס גבוה.

יש תמיכה בפורמט הזה בסטיקרים.
tinywebp_transparent
  • רזולוציה וגודל: גודל מופחת של פורמט המדבקה WebP; גודל מקסימלי של ‎500 KB
  • מידות: עד 220x220 פיקסלים, הגובה מותאם כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי השימוש: כדאי להשתמש בגודל הזה לתצוגה מקדימה של סטיקרים למשתמשים עם רוחב פס גבוה ולשיתופים למשתמשים עם רוחב פס נמוך.

יש תמיכה בפורמט הזה בסטיקרים.
nanowebp_transparent
  • רזולוציה וגודל: הגודל הקטן ביותר של פורמט הסטיקר WebP; גודל מקסימלי של 100 KB
  • מידות: עד 90x90 פיקסלים, כשהרוחב מותאם כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי שימוש: כדאי להשתמש בגודל הזה לתצוגה מקדימה של סטיקרים למשתמשים עם רוחב פס נמוך.

יש תמיכה בפורמט הזה בסטיקרים.
gif_transparent
  • רזולוציה וגודל: פורמט סטיקר GIF באיכות גבוהה; גודל הקובץ הגדול ביותר שזמין
  • מידות: המידות המקוריות של התמונה שהועלתה (ללא הגבלות)
  • הערות לגבי השימוש: השתמשו בגודל הזה לשיתוף סטיקרים עם משתמשים שיש להם רוחב פס גבוה.

יש תמיכה בפורמט הזה בסטיקרים.
tinygif_transparent
  • רזולוציה וגודל: גודל מופחת של פורמט סטיקר ה-GIF; גודל מקסימלי של ‎500 KB
  • מידות: עד 220x220 פיקסלים, והגובה מותאם כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי השימוש: כדאי להשתמש בגודל הזה לתצוגה מקדימה של סטיקרים למשתמשים עם רוחב פס גבוה ולשיתופים למשתמשים עם רוחב פס נמוך.

יש תמיכה בפורמט הזה בסטיקרים.
nanogif_transparent
  • רזולוציה וגודל: הגודל הקטן ביותר של פורמט סטיקר ה-GIF; גודל מקסימלי של 100 KB
  • מידות: עד 90x90 פיקסלים, כשהרוחב מותאם כדי לשמור על יחס הגובה-רוחב.
  • הערות לגבי שימוש: כדאי להשתמש בגודל הזה לתצוגה מקדימה של סטיקרים למשתמשים עם רוחב פס נמוך.

הפורמט הזה נתמך במדבקות.

שיטות מומלצות

  • בנייד, משתמשים בקבצים בגודל nano או tiny לתצוגות מקדימות ובקבצים בגודל tiny לשיתופים.
  • מגדירים את הפרמטר media_filter לפורמטים שבהם רוצים להשתמש. הפעולה הזו יכולה להקטין את גודל התגובה של ה-API ב-70%.

גדלים של פורמטים

גודל הקובץ של כל פורמט תוכן תלוי במימדים ובאורך של קובץ ה-GIF הספציפי שנבחר. לכן, כדאי להתייחס לממוצעים ולחציונים שמפורטים בטבלה הבאה כהנחיות כלליות ולא כערכים מדויקים.

תבנית קובץ גודל קובץ ממוצע (KB) גודל חציון של הקובץ (KB)
gif 3,356 956
mediumgif 2,548 574
tinygif 521 101
nanogif 175 56
mp4 207 91
loopedmp4 515 228
tinymp4 84 81
nanomp4 37 28
webm 76 61
tinywebm 57 45
nanowebm 35 25
webp_transparent 530 95
tinywebp_transparent 249 60
nanowebp_transparent 107 25
gif_transparent 643 35
tinygif_transparent 349 20
nanogif_transparent 116 10

קודי תגובה

בטבלה הבאה מפורטים קודי התשובה של סטטוס HTTP שמשמשים לציון בקשה מוצלחת:

קוד מצב HTTP
200 או 202 אישור או קבלה

שגיאות

ממשק ה-API של Tenor מחזיר שגיאות עם קודי התגובה של HTTP‏ 4xx או 5xx, ובפורמט השגיאה הסטנדרטי של Google API. פרטים נוספים מופיעים במאמר בנושא שגיאות.