TikTok - レコード一覧取得アクション
List recordsアクションは、TikTokで接続済みユーザーの公開動画を一覧表示します。特定の動画を取得するにはVideo IDsを入力し、ユーザーの公開動画をページ送りで取得するにはVideo IDsを空のままにします。
入力
| 入力フィールド | 説明 |
|---|---|
| オブジェクト | オブジェクトタイプを選択します。唯一のオプションはVideoです。 |
| 動画ID | 任意。接続済みユーザーが所有している動画IDを最大20件まで入力します。ユーザーの公開動画をページ送りで取得する場合は、空のままにします。 |
| カーソル | 任意。ミリ秒単位のUTCのUnixタイムスタンプを入力します。 Has moreがtrueの場合は、前回のレスポンスに含まれるCursorの値を使用します。 Cursorフィールドは、Video IDsが空の場合にのみ利用できます。 |
| 最大数 | 任意。ページごとに返す動画数を入力します。有効な値は1～20です。空欄の場合、デフォルト値は10です。 Max countフィールドは、Video IDsが空の場合にのみ利用できます。 |
| フィールド | 任意。各動画について返すフィールドを選択します。すべての動画フィールドを返す場合は、空のままにします。 |
出力
主な出力フィールドは次のとおりです。利用可能な出力フィールドの詳細については、TikTok APIドキュメントを参照してください。
| 出力フィールド | 説明 |
|---|---|
| 動画 | リクエスト条件に一致する動画です。 |
| ID（動画） | 動画の一意の識別子です。 |
| タイトル（動画） | 動画のタイトルです。 |
| 共有URL（動画） | 動画の公開共有URLです。 |
| 「いいね」数（動画） | 動画が受け取った「いいね」の数です。 |
| コメント数（動画） | 動画に付いたコメント数です。 |
| 共有数（動画） | 視聴者がその動画を共有した回数です。 |
| 再生回数（動画） | 動画の再生回数です。 |
| カーソル | 次回のリクエストでCursorとして渡すタイムスタンプです。 Cursorフィールドは、Video IDsが空の場合にのみ利用できます。 |
| さらにある | 追加の動画が利用可能かどうかを示す、trueまたはfalseのブール値です。 Has moreフィールドは、Video IDsが空の場合にのみ利用できます。 |
最終更新日: