لیست جدا شده با کاما برای نشان دادن اینکه آیا محتوا یک برچسب یا تصویر ثابت است، صدا دارد یا ترکیبی از اینها است. اگر sticker و static وجود نداشته باشد، محتوا یک GIF است. یک فیلد flags خالی به معنای GIF بدون صدا است.
جدول زیر جزئیات مربوط به ویژگی های اشیاء دسته را ارائه می دهد:
خواص
searchterm
string
عبارت جستجویی که مربوط به دسته است. عبارت جستجو برای مطابقت با locale درخواست مربوطه ترجمه می شود.
path
string
URL جستجو برای درخواست در صورت انتخاب دسته توسط کاربر
image
string
یک URL به منبع رسانه برای مثال GIF دسته
name
string
نام دسته برای همپوشانی روی تصویر. نام برای مطابقت با locale درخواست مربوطه ترجمه شده است.
شی رسانه ای
جدول زیر جزئیات مربوط به ویژگی های Media Object را ارائه می دهد:
خواص
url
string
یک URL به منبع رسانه
dims
int[]
عرض و ارتفاع رسانه بر حسب پیکسل
duration
float
زمان یک حلقه از محتوا را بر حسب ثانیه نشان می دهد. اگر محتوا ثابت باشد، مدت زمان روی 0 تنظیم می شود.
size
int
حجم فایل بر حسب بایت
فرمت های محتوا
Tenor's API پنج فرمت پایه زیر را در اندازه های مختلف ارائه می دهد:
GIF
MP4
WebM
وب پی شفاف
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. حداکثر حجم 500 کیلوبایت
ابعاد: حداکثر 220x220 پیکسل، ارتفاع برای حفظ نسبت تصویر کوچک شده است.
نکات استفاده: از این اندازه برای پیش نمایش استیکر برای کاربران با پهنای باند بالا و اشتراک گذاری برای کاربران با پهنای باند کم استفاده کنید.
این فرمت برای استیکرها پشتیبانی می شود.
nanowebp_transparent
وضوح و اندازه: کوچکترین اندازه فرمت برچسب WebP. حداکثر حجم 100 کیلوبایت
ابعاد: حداکثر 90x90 پیکسل، با عرض کوچک شده برای حفظ نسبت تصویر.
نکات استفاده: از این اندازه برای پیش نمایش استیکر برای کاربران با پهنای باند کم استفاده کنید.
این فرمت برای استیکرها پشتیبانی می شود.
gif_transparent
وضوح و اندازه: فرمت برچسب GIF با کیفیت بالا. بزرگترین اندازه فایل موجود
ابعاد: ابعاد بارگذاری اصلی (بدون محدودیت)
نکات استفاده: از این اندازه برای اشتراک گذاری استیکر برای کاربران با پهنای باند بالا استفاده کنید.
این فرمت برای استیکرها پشتیبانی می شود.
tinygif_transparent
وضوح و اندازه: کاهش اندازه فرمت برچسب GIF. حداکثر حجم 500 کیلوبایت
ابعاد: حداکثر 220x220 پیکسل، با ارتفاع کوچک شده برای حفظ نسبت تصویر.
نکات استفاده: از این اندازه برای پیش نمایش استیکر برای کاربران با پهنای باند بالا و اشتراک گذاری برای کاربران با پهنای باند کم استفاده کنید.
این فرمت برای استیکرها پشتیبانی می شود.
nanogif_transparent
وضوح و اندازه: کوچکترین اندازه فرمت برچسب GIF. حداکثر حجم 100 کیلوبایت
ابعاد: حداکثر 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 برمیگرداند. برای جزئیات، به خطاها مراجعه کنید.