বস্তু এবং ত্রুটি প্রতিক্রিয়া

এই পৃষ্ঠাটি Tenor API দ্বারা ব্যবহৃত বিভিন্ন JSON প্রতিক্রিয়া এবং ত্রুটির বস্তু সম্পর্কে তথ্য প্রদান করে।

প্রতিক্রিয়া বস্তু

নিম্নলিখিত সারণী রেসপন্স অবজেক্টের বৈশিষ্ট্যগুলির বিশদ প্রদান করে:

বৈশিষ্ট্য
created

float

একটি ইউনিক্স টাইমস্ট্যাম্প যা এই পোস্টটি কখন তৈরি করা হয়েছিল তা উপস্থাপন করে।

hasaudio

boolean

এই পোস্টে অডিও থাকলে true ফেরত দেয়।

id

string

Tenor ফলাফল শনাক্তকারী

media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

কী হিসাবে একটি বিষয়বস্তুর বিন্যাস সহ একটি অভিধান এবং মান হিসাবে একটি মিডিয়া অবজেক্ট ৷

tags

string[]

পোস্টের জন্য ট্যাগ একটি অ্যারে

title

string

পোস্টের শিরোনাম

content_description

string

বিষয়বস্তুর একটি পাঠ্য বিবরণ।

আমরা আপনাকে ব্যবহারকারীর অ্যাক্সেসযোগ্যতার বৈশিষ্ট্যগুলির জন্য content_description ব্যবহার করার পরামর্শ দিই৷

itemurl

string

tenor.com- এ পোস্টটি দেখার জন্য সম্পূর্ণ URL।

hascaption

boolean

এই পোস্টে ক্যাপশন থাকলে true ফেরত দেয়।

flags

string

বিষয়বস্তু একটি স্টিকার বা স্ট্যাটিক ইমেজ, অডিও আছে বা এগুলোর কোনো সমন্বয় কিনা তা বোঝাতে কমা-বিভক্ত তালিকা। যদি sticker এবং static উপস্থিত না থাকে, তাহলে বিষয়বস্তু একটি GIF। একটি ফাঁকা flags ক্ষেত্র অডিও ছাড়া একটি GIF নির্দেশ করে৷

bg_color

string

বিষয়বস্তুর সবচেয়ে সাধারণ ব্যাকগ্রাউন্ড পিক্সেল রঙ

url

string

tenor.com এ পোস্টটি দেখার জন্য একটি ছোট URL।

ক্যাটাগরি অবজেক্ট

নিম্নলিখিত সারণীটি বিষয়শ্রেণীর অবজেক্টের বৈশিষ্ট্যগুলির বিশদ প্রদান করে:

বৈশিষ্ট্য
searchterm

string

অনুসন্ধান শব্দ যা বিভাগের সাথে মিলে যায়। অনুসন্ধান শব্দটি সংশ্লিষ্ট অনুরোধের locale সাথে মেলে অনুবাদ করা হয়েছে।

path

string

ব্যবহারকারী বিভাগ নির্বাচন করলে অনুরোধ করার জন্য অনুসন্ধান URL

image

string

বিভাগের উদাহরণ GIF-এর জন্য মিডিয়া উত্সের একটি URL৷

name

string

ছবির উপরে ওভারলে করার জন্য বিভাগের নাম। নামটি সংশ্লিষ্ট অনুরোধের locale সাথে মেলে অনুবাদ করা হয়েছে।

মিডিয়া অবজেক্ট

নিম্নলিখিত সারণীটি মিডিয়া অবজেক্টের বৈশিষ্ট্যগুলির বিশদ প্রদান করে:

বৈশিষ্ট্য
url

string

মিডিয়া উৎসের একটি URL

dims

int[]

মিডিয়ার প্রস্থ এবং উচ্চতা পিক্সেলে

duration

float

বিষয়বস্তুর একটি লুপের জন্য সেকেন্ডে সময় উপস্থাপন করে। বিষয়বস্তু স্থির হলে, সময়কাল 0 এ সেট করা হয়।

size

int

ফাইলের আকার বাইটে

বিষয়বস্তু বিন্যাস

Tenor's API বিভিন্ন আকারে নিম্নলিখিত পাঁচটি বেস ফরম্যাট অফার করে:

  • জিআইএফ
  • MP4
  • ওয়েবএম
  • স্বচ্ছ 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-পিক্সেলের বৃদ্ধি।
  • ব্যবহারের নোট: ওয়েবএম প্রিভিউ এবং ডেস্কটপে শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাসটি GIF এবং স্টিকারগুলির জন্য সমর্থিত।

tinywebm
  • রেজোলিউশন এবং আকার: WebM ফর্ম্যাটের আকার হ্রাস করা হয়েছে
  • মাত্রা: পরিবর্তনশীল প্রস্থ এবং উচ্চতা, সর্বাধিক 320x320 পিক্সেলের বাউন্ডিং বক্স সহ
  • ব্যবহারের নোট: মোবাইলে GIF শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাসটি GIF এবং স্টিকারগুলির জন্য সমর্থিত।

nanowebm
  • রেজোলিউশন এবং আকার: WebM ফর্ম্যাটের সবচেয়ে ছোট আকার
  • মাত্রা: পরিবর্তনশীল প্রস্থ এবং উচ্চতা, সর্বোচ্চ 150x150 পিক্সেলের বাউন্ডিং বক্স সহ
  • ব্যবহারের নোট: মোবাইলে GIF পূর্বরূপের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাসটি GIF এবং স্টিকারগুলির জন্য সমর্থিত।

webp_transparent
  • রেজোলিউশন এবং আকার: উচ্চ-মানের WebP স্টিকার বিন্যাস; বৃহত্তম ফাইল আকার উপলব্ধ
  • মাত্রা: আসল আপলোড মাত্রা (কোন সীমা নেই)
  • ব্যবহারের নোট: উচ্চ-ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাস স্টিকার জন্য সমর্থিত.

tinywebp_transparent
  • রেজোলিউশন এবং আকার: WebP স্টিকার ফর্ম্যাটের আকার হ্রাস করা; সর্বাধিক আকার 500 KB
  • মাত্রা: 220x220 পিক্সেল পর্যন্ত, আকৃতির অনুপাত সংরক্ষণ করতে উচ্চতা স্কেল করা হয়েছে।
  • ব্যবহারের নোট: উচ্চ-ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার প্রিভিউ এবং কম-ব্যান্ডউইথ ব্যবহারকারীদের জন্য শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাস স্টিকার জন্য সমর্থিত.

nanowebp_transparent
  • রেজোলিউশন এবং আকার: WebP স্টিকার বিন্যাসের সবচেয়ে ছোট আকার; সর্বোচ্চ আকার 100 KB
  • মাত্রা: 90x90 পিক্সেল পর্যন্ত, আকৃতির অনুপাত সংরক্ষণের জন্য প্রস্থ স্কেল করা হয়েছে।
  • ব্যবহারের নোট: কম ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার পূর্বরূপের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাস স্টিকার জন্য সমর্থিত.

gif_transparent
  • রেজোলিউশন এবং আকার: উচ্চ মানের GIF স্টিকার বিন্যাস; বৃহত্তম ফাইল আকার উপলব্ধ
  • মাত্রা: আসল আপলোড মাত্রা (কোন সীমা নেই)
  • ব্যবহারের নোট: উচ্চ-ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাস স্টিকার জন্য সমর্থিত.

tinygif_transparent
  • রেজোলিউশন এবং আকার: GIF স্টিকার বিন্যাসের আকার হ্রাস করা; সর্বাধিক আকার 500 KB
  • মাত্রা: 220x220 পিক্সেল পর্যন্ত, আকৃতির অনুপাত সংরক্ষণ করতে উচ্চতা স্কেল করা হয়েছে।
  • ব্যবহারের নোট: উচ্চ-ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার প্রিভিউ এবং কম-ব্যান্ডউইথ ব্যবহারকারীদের জন্য শেয়ারের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাস স্টিকার জন্য সমর্থিত.

nanogif_transparent
  • রেজোলিউশন এবং আকার: GIF স্টিকার বিন্যাসের সবচেয়ে ছোট আকার; সর্বোচ্চ আকার 100 KB
  • মাত্রা: 90x90 পিক্সেল পর্যন্ত, আকৃতির অনুপাত সংরক্ষণের জন্য প্রস্থ স্কেল করা হয়েছে।
  • ব্যবহারের নোট: কম ব্যান্ডউইথ ব্যবহারকারীদের জন্য স্টিকার পূর্বরূপের জন্য এই আকারটি ব্যবহার করুন।

এই বিন্যাসটি স্টিকারের জন্য সমর্থিত।

সেরা অনুশীলন

  • মোবাইলের জন্য, পূর্বরূপের জন্য ন্যানো- বা ক্ষুদ্র আকারের ফাইল এবং শেয়ারের জন্য ক্ষুদ্র আকারের ফাইলগুলি ব্যবহার করুন৷
  • আপনি যে ফরম্যাটে ব্যবহার করতে চান তাতে media_filter প্যারামিটার সেট করুন। এটি API প্রতিক্রিয়া আকার 70% কমাতে পারে।

বিন্যাস আকার

প্রতিটি বিষয়বস্তুর বিন্যাসের জন্য ফাইলের আকার নির্বাচিত নির্দিষ্ট GIF এর মাত্রা এবং দৈর্ঘ্যের উপর নির্ভর করে। অতএব, নিম্নোক্ত সারণীতে প্রদত্ত উপায় এবং মধ্যকগুলিকে কঠিন মানের পরিবর্তে সাধারণ নির্দেশিকা হিসাবে বিবেচনা করুন।

ফাইলের বিন্যাস গড় ফাইলের আকার (KB) মিডিয়ান ফাইলের আকার (KB)
gif ৩,৩৫৬ 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 ঠিক আছে বা গৃহীত

ত্রুটি

Tenor-এর API HTTP প্রতিক্রিয়া কোড 4xx বা 5xx সহ এবং আদর্শ Google API ত্রুটি বিন্যাসে ত্রুটি প্রদান করে। বিস্তারিত জানার জন্য, ত্রুটি দেখুন।