रिस्पॉन्स ऑब्जेक्ट और गड़बड़ियां

इस पेज पर, अलग-अलग JSON रिस्पॉन्स और गड़बड़ी के उन ऑब्जेक्ट के बारे में जानकारी मिलती है जिनका इस्तेमाल Tenor API करता है.

रिस्पॉन्स ऑब्जेक्ट

नीचे दी गई टेबल, जवाब देने वाले ऑब्जेक्ट की प्रॉपर्टी के बारे में जानकारी देती है:

प्रॉपर्टी
created	float यूनिक्स टाइमस्टैंप, जिससे पता चलता है कि इस पोस्ट को कब बनाया गया था.
hasaudio	boolean अगर इस पोस्ट में ऑडियो शामिल है, तो true दिखाता है. ध्यान दें: ऑडियो के साथ सिर्फ़ वीडियो फ़ॉर्मैट काम करते हैं. GIF इमेज के फ़ाइल फ़ॉर्मैट में ऑडियो की जानकारी नहीं हो सकती.
id	string Tenor के नतीजे की पहचान करने वाला
media_formats	{ CONTENT_FORMAT : MEDIA_OBJECT } डिक्शनरी के तौर पर एक कॉन्टेंट फ़ॉर्मैट और वैल्यू के तौर पर एक मीडिया ऑब्जेक्ट.
tags	string[] पोस्ट के लिए टैग का एक कलेक्शन
title	string पोस्ट का शीर्षक
content_description	string कॉन्टेंट के बारे में टेक्स्ट के तौर पर जानकारी. हमारा सुझाव है कि आप उपयोगकर्ता की सुलभता सुविधाओं के लिए, content_description का इस्तेमाल करें.
itemurl	string पूरा यूआरएल देखने के लिए, tenor.com पर जाएं.
hascaption	boolean अगर इस पोस्ट में कैप्शन हैं, तो true दिखाता है.
flags	string कॉमा लगाकर अलग की गई सूची से पता चलता है कि कॉन्टेंट स्टिकर का है या स्टैटिक इमेज का. इसमें ऑडियो है या नहीं. अगर sticker और static मौजूद नहीं हैं, तो इसका मतलब है कि कॉन्टेंट GIF के तौर पर मौजूद है. खाली flags फ़ील्ड, बिना ऑडियो वाले GIF का मतलब है.
bg_color	string सामग्री के सबसे आम बैकग्राउंड पिक्सेल का रंग
url	string tenor.com पर पोस्ट को देखने के लिए एक छोटा यूआरएल.

कैटगरी ऑब्जेक्ट

नीचे दी गई टेबल में कैटगरी ऑब्जेक्ट के लिए प्रॉपर्टी की जानकारी दी गई है:

प्रॉपर्टी
searchterm	string कैटगरी से जुड़ा खोज के लिए शब्द. खोज के लिए इस्तेमाल किए गए शब्द का अनुवाद संबंधित अनुरोध के locale से मिलान करने के लिए किया जाता है.
path	string अगर उपयोगकर्ता ने कैटगरी चुनी है, तो अनुरोध का खोज यूआरएल
image	string कैटगरी के उदाहरण के GIF के लिए मीडिया सोर्स का यूआरएल
name	string इमेज के ऊपर लगाया जाने वाला कैटगरी का नाम. नाम का अनुवाद locale से जुड़े अनुरोध से मेल खाने के लिए किया जाता है.

मीडिया ऑब्जेक्ट

इस टेबल में, मीडिया ऑब्जेक्ट के लिए प्रॉपर्टी के बारे में जानकारी दी गई है:

प्रॉपर्टी
url	string मीडिया सोर्स का यूआरएल
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 की तरह ही, वीडियो कंटेनर की खास बातों के मुताबिक इसमें बदलाव किया जा सकता है. यह आम तौर पर, आठ पिक्सल तक बढ़ जाता है. इस्तेमाल से जुड़ी ज़रूरी जानकारी: इस साइज़ का इस्तेमाल, MP4 झलक और डेस्कटॉप पर शेयर करने के लिए करें. यह फ़ॉर्मैट GIF और स्टिकर के साथ काम करता है.
loopedmp4	रिज़ॉल्यूशन और साइज़: सबसे अच्छी क्वालिटी वाला वीडियो फ़ॉर्मैट, जिसका साइज़ MP4 से बड़ा है डाइमेंशन: GIF की तरह ही, वीडियो कंटेनर की खास बातों के मुताबिक इसमें बदलाव किया जा सकता है. यह आम तौर पर, आठ पिक्सल तक बढ़ जाता है. इस्तेमाल से जुड़ी जानकारी: जब ऐप्लिकेशन की वीडियो क्लिप सिर्फ़ एक बार चलाने के बजाय, कई बार इस्तेमाल करनी हो, तो MP4 शेयर के लिए इस साइज़ का इस्तेमाल करें. यह फ़ॉर्मैट GIF और स्टिकर के साथ काम करता है.
tinymp4	रिज़ॉल्यूशन और साइज़: MP4 फ़ॉर्मैट का कम किया गया साइज़ डाइमेंशन: वैरिएबल की चौड़ाई और ऊंचाई. इसके लिए, ज़्यादा से ज़्यादा 320x320 पिक्सल का बाउंडिंग बॉक्स होना चाहिए इस्तेमाल से जुड़ी जानकारी: इस साइज़ का इस्तेमाल मोबाइल पर MP4 झलक और झलक के लिए करें. यह फ़ॉर्मैट GIF और स्टिकर के साथ काम करता है.
nanomp4	रिज़ॉल्यूशन और साइज़: MP4 फ़ॉर्मैट का सबसे छोटा साइज़ डाइमेंशन: वैरिएबल की चौड़ाई और ऊंचाई. इसके लिए, ज़्यादा से ज़्यादा 150x150 पिक्सल का बाउंडिंग बॉक्स होना चाहिए इस्तेमाल से जुड़ी जानकारी: मोबाइल पर MP4 झलक में इस साइज़ का इस्तेमाल करें. यह फ़ॉर्मैट GIF और स्टिकर के साथ काम करता है.
webm	रिज़ॉल्यूशन और साइज़: खराब क्वालिटी वाला वीडियो फ़ॉर्मैट, MP4 से छोटा डाइमेंशन: GIF की तरह ही, वीडियो कंटेनर की खास बातों के मुताबिक इसमें बदलाव किया जा सकता है. यह आम तौर पर, आठ पिक्सल तक बढ़ जाता है. इस्तेमाल से जुड़ी ज़रूरी जानकारी: इस साइज़ का इस्तेमाल, 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 पैरामीटर को उन फ़ॉर्मैट पर सेट करें जिनका आपको इस्तेमाल करना है. इससे एपीआई रिस्पॉन्स का साइज़ 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	20
nanogif_transparent	116	10

रिस्पॉन्स कोड

इस टेबल में एचटीटीपी स्टेटस रिस्पॉन्स कोड दिए गए हैं. इन कोड का इस्तेमाल करके अनुरोध को स्वीकार किया गया है:

HTTP स्‍थिति कोड
200 या 202	ठीक है या स्वीकार किया गया

गड़बड़ियां

Tenor के एपीआई से, एचटीटीपी रिस्पॉन्स कोड 4xx या 5xx के साथ गड़बड़ियां दिखती हैं. ये गड़बड़ियां, Google API के स्टैंडर्ड फ़ॉर्मैट में दिखती हैं. ज़्यादा जानकारी के लिए, गड़बड़ियां देखें.