POST media/subtitles/create

概要

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

動画をツイートする前に動画に字幕を関連付けるリクエストフローは次のとおりです。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.

Was this document helpful?

ありがとうございます

ご協力ありがとうございました。お役に立てて幸いです。

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.