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

בדף הזה מוצג מידע על תגובת JSON ואובייקטים שונים של שגיאות, שנמצאים בשימוש ב-Tenor API.

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

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

מאפיינים
created

float

חותמת זמן של Unix שמציינת מתי הפוסט הזה נוצר.
hasaudio

boolean

מחזירה true אם הפוסט הזה מכיל אודיו.
id

string

מזהה התוצאה של Tenor
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
  • מידות: רוחב וגובה משתנה, עם תיבה תוחמת מקסימלית בגודל 320x320 פיקסלים
  • הערות שימוש: יש להשתמש בגודל הזה לתצוגה מקדימה ולשיתופים ב-MP4 בנייד.

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

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

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

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

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

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

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

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

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

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

בפורמט הזה יש תמיכה בסטיקרים.

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

  • בנייד, אפשר להשתמש בקבצים קטנים או קטנים (בתצוגה מקדימה) ובקבצים קטנים (כמו קבצים קטנים).
  • עליכם להגדיר את הפרמטר 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. מידע נוסף מופיע במאמר בנושא שגיאות.