本頁面由 Cloud Translation API 翻譯而成。

回應物件和錯誤

本頁面說明 Tenor API 使用的不同 JSON 回應和錯誤物件。

回應物件

下表提供 Response 物件屬性的詳細資料：

屬性
`created`	`float` 代表建立這篇文章的 Unix 時間戳記。
`hasaudio`	`boolean` 如果這篇文章包含音訊，則傳回「`true`」。注意：只有影片格式支援音訊。GIF 圖片檔案格式不得包含音訊資訊。
`id`	`string` Tenor 結果 ID
`media_formats`	`{ 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 的 API 提供下列五種基本格式，各種不同的大小：

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 格式的最小尺寸尺寸：可變寬度和高度，上限為 150 x 150 像素的定界框使用注意事項：在行動裝置上執行 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 像素，寬度經過調整以維持長寬比。使用附註：這個大小可用於低頻寬使用者的貼圖預覽。這個格式支援貼圖。

最佳做法

如果是行動裝置，請使用 Nano 或小尺寸檔案以預覽，而迷你檔案則可用於分享。
將 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`	普通

錯誤

Tenor 的 API 會傳回以下錯誤：HTTP 回應代碼 4xx 或 5xx，以及標準 Google API 錯誤格式。詳情請參閱「錯誤」一節。