ออบเจ็กต์การตอบกลับและข้อผิดพลาด
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้ให้ข้อมูลเกี่ยวกับการตอบสนอง JSON และออบเจ็กต์ข้อผิดพลาดต่างๆ ที่ Tenor API ใช้
ออบเจ็กต์การตอบกลับ
ตารางต่อไปนี้แสดงรายละเอียดของพร็อพเพอร์ตี้สําหรับออบเจ็กต์การตอบกลับต่างๆ
พร็อพเพอร์ตี้
created
float
การประทับเวลา Unix ที่แสดงถึงเวลาที่สร้างโพสต์นี้
hasaudio
boolean
แสดงผล true ถ้าโพสต์นี้มีเสียง
หมายเหตุ: เฉพาะรูปแบบวิดีโอเท่านั้นที่รองรับเสียง รูปแบบไฟล์ GIF ต้องไม่มีข้อมูลเสียง
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)
gif3,356
956
mediumgif2,548
574
tinygif521
101
nanogif175
56
mp4207
91
loopedmp4515
228
tinymp484
81
nanomp437
28
webm76
61
tinywebm57
45
nanowebm35
25
webp_transparent530
95
tinywebp_transparent249
60
nanowebp_transparent107
25
gif_transparent643
35
tinygif_transparent349
20
nanogif_transparent116
10
โค้ดตอบกลับ
ตารางต่อไปนี้แสดงรหัสการตอบสนองสถานะ HTTP ซึ่งใช้เพื่อระบุคําขอที่สําเร็จ
รหัสสถานะ HTTP
200 หรือ 202ตกลงหรือยอมรับแล้ว
ข้อผิดพลาด
API ของ Tenor จะแสดงผลข้อผิดพลาดพร้อมรหัสการตอบกลับ HTTP 4xx หรือ 5xx และในรูปแบบข้อผิดพลาดมาตรฐานของ Google API โปรดดูรายละเอียดที่หัวข้อข้อผิดพลาด
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2023-07-11 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2023-07-11 UTC"],[[["This documentation details the JSON response and error objects for the Tenor API, including properties for responses, categories, and media objects."],["It outlines available content formats (GIF, MP4, WebM, WebP, GIF) and types (preview, gif, mediumgif, tinygif, etc.), providing size and usage recommendations."],["The document offers best practices like using nano or tiny files for mobile previews and the `media_filter` parameter for reducing response size."],["It includes information on response codes (200, 202) indicating successful requests and standard Google API error formats for unsuccessful ones."]]],["The Tenor API uses JSON response objects, including Response, Category, and Media objects. Response objects contain properties like `id`, `created`, `media_formats`, and `tags`. Category objects have `searchterm`, `path`, `image`, and `name`. Media objects hold `url`, `dims`, `duration`, and `size` data. The API supports GIF, MP4, WebM, and transparent WebP/GIF formats, offering various sizes (e.g., nano, tiny, medium). Format sizes and best practices are detailed, and success is indicated by HTTP status codes 200 or 202, with errors using 4xx or 5xx codes.\n"]]
