ออบเจ็กต์การตอบกลับและข้อผิดพลาด

หน้านี้ให้ข้อมูลเกี่ยวกับการตอบสนอง JSON และออบเจ็กต์ข้อผิดพลาดต่างๆ ที่ Tenor API ใช้

ออบเจ็กต์การตอบกลับ

ตารางต่อไปนี้แสดงรายละเอียดของพร็อพเพอร์ตี้สําหรับออบเจ็กต์การตอบกลับต่างๆ

พร็อพเพอร์ตี้
created

float

การประทับเวลา Unix ที่แสดงถึงเวลาที่สร้างโพสต์นี้
hasaudio

boolean

แสดงผล true ถ้าโพสต์นี้มีเสียง
id

string

ตัวระบุผลลัพธ์ของ Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

พจนานุกรมที่มีรูปแบบเนื้อหาเป็นคีย์และมี 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 ของคําขอที่เกี่ยวข้อง

ออบเจ็กต์สื่อ

ตารางต่อไปนี้แสดงรายละเอียดเกี่ยวกับพร็อพเพอร์ตี้ Media Objects

พร็อพเพอร์ตี้
url

string

URL ไปยังแหล่งที่มาของสื่อ
dims

int[]

ความกว้างและความสูงของสื่อเป็นพิกเซล
duration

float

แสดงเวลาเป็นวินาทีสําหรับลูปของเนื้อหา 1 รอบ หากเนื้อหาเป็นแบบคงที่ ระยะเวลาจะตั้งไว้ที่ 0
size

int

ขนาดไฟล์ในหน่วยไบต์

รูปแบบเนื้อหา

API ของ Tenor มีรูปแบบพื้นฐาน 5 แบบดังต่อไปนี้ซึ่งมีหลายขนาด

  • GIF
  • MP4
  • WebM
  • WebP แบบโปร่งใส
  • GIF แบบโปร่งใส

รูปแบบ MP4 และ WebM เล่นคลิปเพียงครั้งเดียว ยกเว้น loopedmp4 ซึ่งจะเล่นคลิป 2-3 ครั้ง รูปแบบ 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 เมื่อคุณต้องการให้วิดีโอคลิปเล่น 2-3 ครั้งแทนที่จะเล่นเพียงครั้งเดียว

รูปแบบนี้รองรับ 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 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 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 โปรดดูรายละเอียดที่หัวข้อข้อผิดพลาด