概要

このエンドポイントを使用すると、アップロードした字幕をアップロードした動画に関連付けることができます。動画への字幕の関連付けは、ツイートする前でも後でもできます。

動画をツイートする前に動画に字幕を関連付けるリクエストフローは次のとおりです。1.チャンク化アップロードエンドポイントを使用して動画をアップロードし、動画のmedia_idを取得します。2.メディアのカテゴリーを「Subtitles」に設定したうえで、チャンク化アップロードエンドポイントを使用して字幕をアップロードし、字幕のmedia_idを取得します。3.このエンドポイントを呼び出して、字幕を動画に関連付けます。4.動画のmedia_idを使用してツイートを作成します。

動画をツイートした後に動画に字幕を関連付けるリクエストフローは次のとおりです。1.チャンク化アップロードエンドポイントを使用して動画をアップロードし、動画のmedia_idを取得します。2.動画のmedia_idを使用してツイートを作成します。3.メディアのカテゴリーをSUBTITLESに設定したうえで、チャンク化アップロードエンドポイントを使用して字幕をアップロードし、字幕のmedia_idを取得します。4.このエンドポイントを呼び出して、字幕を動画に関連付けます。

リクエスト

リクエストはJSONでコンテンツ本体を記述したHTTP POSTで、コンテンツのタイプがapplication/json; charset=UTF-8である必要があります

注: このエンドポイントのドメインはupload.twitter.comです

応答

このエンドポイントが返すHTTP応答は次のとおりです。

ステータス	テキスト	説明
200	OK	字幕を作成するリクエストが正常に送信されました。
400	Bad Request	通常この応答が発生するのは、無効なJSONがリクエストに含まれている場合、またはリクエストがいずれかのJSONペイロードの送信に失敗した場合です。この場合、このエラーは無効な字幕ファイルを示すことがあります。
403	Unauthorized	無効な認証情報によりHTTP認証に失敗しました。OAuthキーおよびトークンを確認してください。
404	Not Found	リクエスト送信先のURLでリソースが見つかりません。media_idが不正確であることが原因と考えられます。
500	Internal Server Error	Twitter側で問題が発生しました。指数関数的後退パターンを使用してリクエストを再試行してください。
503	Service Unavailable	Twitter側で問題が発生しました。指数関数的後退パターンを使用してリクエストを再試行してください。

リソースURL

https://upload.twitter.com/1.1/media/subtitles/create.json

リソース情報

応答形式	JSON
認証の要否	要（ユーザーのコンテキストに限る）
レート制限	あり

リクエストの例

POST https://upload.twitter.com/1.1/media/subtitles/create.json

    {
      "media_id":"692797692624265216",
      "media_category":"TweetVideo",
      "subtitle_info": {
        "subtitles": [
          "media_id":"105195515189863968",
          "language_code":"EN", //The language code should be a BCP47 code (e.g. 'en", "sp"),
          "display_name":"English"
        ]
      }
    }

結果の例

// Successful response returns HTTP 2XX code without any content body.