كائنات الاستجابة والأخطاء

تقدّم هذه الصفحة معلومات عن استجابة JSON المختلفة وكائنات الأخطاء التي تستخدمها Tenor API.

كائن الرد

يقدم الجدول التالي تفاصيل حول خصائص عناصر الاستجابة:

أماكن إقامة
created	float طابع زمني على Unix يمثّل وقت إنشاء هذه المشاركة
hasaudio	boolean عرض true إذا كانت هذه المشاركة تحتوي على صوت. ملاحظة: تتيح تنسيقات الفيديو فقط استخدام الصوت. ولا يمكن أن يحتوي تنسيق ملف صورة GIF على معلومات صوتية.
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 حجم الملف بالبايت

تنسيقات المحتوى

توفّر واجهة برمجة تطبيقات 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 الأبعاد: عرض المتغيّر وارتفاعه، وضبط مربّع حد أقصى 150×150 بكسل ملاحظات الاستخدام: استخدِم هذا الحجم لمعاينة 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 كيلوبايت الأبعاد: حتى 90×90 بكسل، مع ضبط العرض للحفاظ على نسبة العرض إلى الارتفاع ملاحظات الاستخدام: يمكنك استخدام هذا الحجم في معاينات الملصقات للمستخدمين ذوي معدل نقل البيانات المنخفض. هذا التنسيق متوافق مع الملصقات.
gif_transparent	درجة الدقة والحجم: تنسيق ملصق عالي الجودة لملف GIF، ويتوفر أكبر حجم للملف الأبعاد: سمات التحميل الأصلية (بدون حدود) ملاحظات الاستخدام: يمكنك استخدام هذا الحجم لمشاركة الملصقات للمستخدمين ذوي معدل نقل البيانات العالي. هذا التنسيق متوافق مع الملصقات.
tinygif_transparent	درجة الدقة والحجم: تم تقليل حجم تنسيق ملصق GIF، والحد الأقصى للحجم 500 كيلوبايت الأبعاد: حتى 220x220 بكسل، مع قياس الارتفاع للحفاظ على نسبة العرض إلى الارتفاع ملاحظات الاستخدام: يمكنك استخدام هذا الحجم في معاينات الملصقات للمستخدمين ذي معدل نقل البيانات العالي والمشاركات للمستخدمين ذوي معدل نقل البيانات المنخفض. هذا التنسيق متوافق مع الملصقات.
nanogif_transparent	درجة الدقة والحجم: أصغر حجم لتنسيق ملصق GIF، والحد الأقصى للحجم 100 كيلوبايت الأبعاد: حتى 90×90 بكسل، مع ضبط العرض للحفاظ على نسبة العرض إلى الارتفاع ملاحظات الاستخدام: يمكنك استخدام هذا الحجم في معاينات الملصقات للمستخدمين ذوي معدل نقل البيانات المنخفض. هذا التنسيق متوافق مع الملصق.

أفضل الممارسات

• بالنسبة إلى الأجهزة الجوّالة، استخدِم الملفات الصغيرة جدًا أو الصغيرة جدًا لإجراء المعاينات والملفات الصغيرة الحجم للمشاركة معها.
• ضبط المَعلمة media_filter على التنسيقات التي تنوي استخدامها ويمكن أن يؤدي ذلك إلى تقليل حجم استجابة واجهة برمجة التطبيقات بنسبة %70.

أحجام الأشكال

يعتمد حجم الملف لكل تنسيق محتوى على أبعاد ملف GIF المحدّد وطوله. لذا، يمكنك اعتبار الوسائل والمتوسطات المتوفرة في الجدول التالي كإرشادات عامة بدلاً من قيم صارمة.

تنسيق الملف	متوسط حجم الملف (كيلوبايت)	متوسط حجم الملف (كيلوبايت)
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	باخت تايلاندي
nanogif_transparent	116	10

رموز الاستجابة

يعرض الجدول التالي رموز استجابة حالة HTTP المستخدَمة للإشارة إلى طلب ناجح:

رمز حالة HTTP‬
200 أو 202	موافق أو مقبول

الأخطاء

تعرض واجهة برمجة تطبيقات Tenor الأخطاء برموز استجابة HTTP 4xx أو 5xx وبالتنسيق العادي لواجهة برمجة التطبيقات Google API. لمعرفة التفاصيل، يُرجى الاطّلاع على الأخطاء.