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

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

जवाब देने वाला ऑब्जेक्ट

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

प्रॉपर्टी
created

float

यह एक Unix टाइमस्टैंप है. इससे पता चलता है कि यह पोस्ट कब बनाई गई थी.
hasaudio

boolean

अगर इस पोस्ट में ऑडियो शामिल है, तो true दिखाता है.
id

string

टेनोर के नतीजे का आइडेंटिफ़ायर
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

यह एक डिक्शनरी है. इसमें 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 की तरह ही, लेकिन वीडियो कंटेनर की खास बातों के मुताबिक पैडिंग की जाती है. यह आम तौर पर 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 पैरामीटर को उन फ़ॉर्मैट पर सेट करें जिनका आपको इस्तेमाल करना है. इससे एपीआई के जवाब का साइज़ 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 की गड़बड़ी के स्टैंडर्ड फ़ॉर्मैट में गड़बड़ियां दिखाता है. ज़्यादा जानकारी के लिए, गड़बड़ियां देखें.