Đối tượng phản hồi và lỗi

Trang này cung cấp thông tin về các đối tượng phản hồi và lỗi JSON mà Tenor API sử dụng.

Đối tượng phản hồi

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính cho Đối tượng phản hồi:

Thuộc tính
created	float Dấu thời gian Unix biểu thị thời điểm tạo bài đăng này.
hasaudio	boolean Trả về true nếu bài đăng này có chứa âm thanh. Lưu ý: Chỉ định dạng video mới hỗ trợ âm thanh. Định dạng tệp hình ảnh GIF không thể chứa thông tin âm thanh.
id	string Giá trị nhận dạng kết quả Tenor
media_formats	{ CONTENT_FORMAT : MEDIA_OBJECT } Một từ điển có định dạng nội dung làm khoá và Đối tượng đa phương tiện làm giá trị.
tags	string[] Một mảng các thẻ cho bài đăng
title	string Tiêu đề của bài đăng
content_description	string Nội dung mô tả bằng văn bản về nội dung. Bạn nên sử dụng content_description cho các tính năng hỗ trợ tiếp cận của người dùng.
itemurl	string URL đầy đủ để xem bài đăng trên tenor.com.
hascaption	boolean Trả về true nếu bài đăng này có phụ đề.
flags	string Danh sách được phân tách bằng dấu phẩy để cho biết nội dung là hình dán hay hình ảnh tĩnh, có âm thanh hay là tổ hợp của các yếu tố này. Nếu không có sticker và static, thì nội dung đó là ảnh GIF. Trường flags trống biểu thị một ảnh GIF không có âm thanh.
bg_color	string Màu pixel nền phổ biến nhất của nội dung
url	string URL ngắn để xem bài đăng trên tenor.com.

Đối tượng danh mục

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính cho Đối tượng danh mục:

Thuộc tính
searchterm	string Cụm từ tìm kiếm tương ứng với danh mục. Cụm từ tìm kiếm được dịch để khớp với locale của yêu cầu tương ứng.
path	string URL tìm kiếm cần yêu cầu nếu người dùng chọn danh mục
image	string URL đến nguồn nội dung nghe nhìn cho ảnh GIF minh hoạ của danh mục
name	string Tên danh mục để phủ lên hình ảnh. Tên được dịch để khớp với locale của yêu cầu tương ứng.

Đối tượng nội dung nghe nhìn

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính của Đối tượng đa phương tiện:

Thuộc tính
url	string URL đến nguồn nội dung nghe nhìn
dims	int[] Chiều rộng và chiều cao của nội dung nghe nhìn tính bằng pixel
duration	float Biểu thị thời gian tính bằng giây cho một vòng lặp của nội dung. Nếu nội dung là tĩnh, thì thời lượng được đặt thành 0.
size	int Kích thước của tệp tính bằng byte

Định dạng nội dung

API của Tenor cung cấp 5 định dạng cơ bản sau đây với nhiều kích thước:

• GIF
• MP4
• WebM
• WebP trong suốt
• Ảnh GIF trong suốt

Định dạng MP4 và WebM chỉ phát đoạn video một lần, ngoại trừ loopedmp4, định dạng này phát đoạn video vài lần. Định dạng GIF phát đoạn video của mình theo một vòng lặp liên tục. Các định dạng trong suốt là dành cho nội dung hình dán và không có trong kết quả tìm kiếm ảnh GIF.

Các loại định dạng

Bảng sau đây cung cấp thông tin chi tiết về các loại định dạng nội dung nghe nhìn hiện có cho Tenor:

Các loại định dạng
preview	Độ phân giải và kích thước: Định dạng GIF một khung hình chất lượng cao; kích thước nhỏ hơn định dạng GIF Kích thước: Kích thước tải lên ban đầu (không giới hạn) Lưu ý khi sử dụng: Đặt khung hình này làm khung hình đầu tiên của nội dung. Thành phần này được dùng làm bản xem trước hình thu nhỏ. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
gif	Độ phân giải và kích thước: Định dạng GIF chất lượng cao; kích thước tệp lớn nhất có thể Kích thước: Kích thước tải lên ban đầu (không giới hạn) Lưu ý về cách sử dụng: Sử dụng kích thước này cho ảnh GIF được chia sẻ trên máy tính. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
mediumgif	Độ phân giải và kích thước: Giảm nhẹ kích thước của định dạng GIF Kích thước: Kích thước tải lên ban đầu (không giới hạn) nhưng tỷ lệ nén cao hơn nhiều Lưu ý về cách sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên máy tính. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinygif	Độ phân giải và kích thước: Giảm kích thước của định dạng GIF Kích thước: Chiều rộng tối đa là 220 pixel. Chiều cao được điều chỉnh theo tỷ lệ để duy trì tỷ lệ khung hình. Lưu ý về việc sử dụng: Sử dụng kích thước này cho ảnh GIF xem trước và chia sẻ trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanogif	Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng GIF Kích thước: Chiều cao tối đa là 90 pixel. Chiều rộng được điều chỉnh theo tỷ lệ để duy trì tỷ lệ khung hình. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
mp4	Độ phân giải và kích thước: Định dạng video có chất lượng cao nhất; lớn nhất trong số các định dạng video, nhưng nhỏ hơn GIF Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước và chia sẻ tệp MP4 trên máy tính. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
loopedmp4	Độ phân giải và kích thước: Định dạng video có chất lượng cao nhất; kích thước lớn hơn MP4 Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel. Lưu ý khi sử dụng: Sử dụng kích thước này cho nội dung chia sẻ ở định dạng MP4 khi bạn muốn đoạn video chạy vài lần thay vì chỉ một lần. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinymp4	Độ phân giải và kích thước: Giảm kích thước của định dạng MP4 Kích thước: Chiều rộng và chiều cao thay đổi, với hộp giới hạn tối đa là 320x320 pixel Lưu ý về cách sử dụng: Sử dụng kích thước này cho bản xem trước và nội dung chia sẻ MP4 trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanomp4	Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng MP4 Kích thước: Chiều rộng và chiều cao có thể thay đổi, với hộp giới hạn tối đa là 150x150 pixel Lưu ý về việc sử dụng: Sử dụng kích thước này cho bản xem trước MP4 trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
webm	Độ phân giải và kích thước: Định dạng video có chất lượng thấp hơn; kích thước nhỏ hơn MP4 Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước và chia sẻ tệp WebM trên máy tính. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinywebm	Độ phân giải và kích thước: Giảm kích thước của định dạng WebM Kích thước: Chiều rộng và chiều cao thay đổi, với hộp giới hạn tối đa là 320x320 pixel Lưu ý về cách sử dụng: Sử dụng kích thước này cho ảnh GIF được chia sẻ trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanowebm	Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng WebM Kích thước: Chiều rộng và chiều cao có thể thay đổi, với hộp giới hạn tối đa là 150x150 pixel Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên thiết bị di động. Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
webp_transparent	Độ phân giải và kích thước: Định dạng nhãn dán WebP chất lượng cao; kích thước tệp lớn nhất có thể Kích thước: Kích thước tải lên ban đầu (không giới hạn) Lưu ý khi sử dụng: Sử dụng kích thước này cho các lượt chia sẻ hình dán đối với người dùng có băng thông cao. Định dạng này được hỗ trợ cho hình dán.
tinywebp_transparent	Độ phân giải và kích thước: Giảm kích thước của định dạng nhãn dán WebP; kích thước tối đa là 500 KB Kích thước: Tối đa 220x220 pixel, chiều cao được điều chỉnh để duy trì tỷ lệ khung hình. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông cao và nội dung chia sẻ đối với người dùng có băng thông thấp. Định dạng này được hỗ trợ cho hình dán.
nanowebp_transparent	Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng nhãn dán WebP; kích thước tối đa là 100 KB Kích thước: Tối đa 90x90 pixel, với chiều rộng được điều chỉnh để giữ nguyên tỷ lệ khung hình. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông thấp. Định dạng này được hỗ trợ cho hình dán.
gif_transparent	Độ phân giải và kích thước: Định dạng nhãn dán GIF chất lượng cao; kích thước tệp lớn nhất có thể Kích thước: Kích thước tải lên ban đầu (không giới hạn) Lưu ý khi sử dụng: Sử dụng kích thước này cho các lượt chia sẻ hình dán đối với người dùng có băng thông cao. Định dạng này được hỗ trợ cho hình dán.
tinygif_transparent	Độ phân giải và kích thước: Giảm kích thước của định dạng hình dán GIF; kích thước tối đa là 500 KB Kích thước: Tối đa 220 x 220 pixel, với chiều cao được điều chỉnh để giữ nguyên tỷ lệ khung hình. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông cao và nội dung chia sẻ đối với người dùng có băng thông thấp. Định dạng này được hỗ trợ cho hình dán.
nanogif_transparent	Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng hình dán GIF; kích thước tối đa là 100 KB Kích thước: Tối đa 90x90 pixel, với chiều rộng được điều chỉnh để giữ nguyên tỷ lệ khung hình. Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông thấp. Định dạng này được hỗ trợ cho hình dán.

Các phương pháp hay nhất

• Đối với thiết bị di động, hãy dùng các tệp có kích thước siêu nhỏ hoặc rất nhỏ để xem trước và các tệp có kích thước rất nhỏ để chia sẻ.
• Đặt tham số media_filter thành các định dạng mà bạn dự định sử dụng. Điều này có thể giảm kích thước phản hồi API xuống 70%.

Kích thước định dạng

Kích thước tệp của mỗi định dạng nội dung phụ thuộc vào kích thước và thời lượng của GIF cụ thể mà bạn chọn. Do đó, hãy xem xét giá trị trung bình và trung vị được cung cấp trong bảng sau đây như các nguyên tắc chung thay vì các giá trị cố định.

Định dạng tệp	Kích thước tệp trung bình (KB)	Kích thước tệp trung bình (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

Mã phản hồi

Bảng sau đây cung cấp các mã trạng thái phản hồi HTTP được dùng để cho biết yêu cầu thành công:

Mã trạng thái HTTP
200 hoặc 202	OK hoặc được chấp nhận

Lỗi

API của Tenor trả về lỗi bằng mã phản hồi HTTP 4xx hoặc 5xx và ở định dạng lỗi API tiêu chuẩn của Google. Để biết thông tin chi tiết, hãy xem phần Lỗi.