クリエイターの管理
トークン化されたアップロードURLがリクエストされる際に、内部ユーザーIDでクリエイターフィールドを設定できます。動画がアップロードされると、クリエイターのプロパティは自動的に内部ユーザーIDに設定され、分析データや特定のクリエイターによる動画検索に使用できます。
基本的なアップロードの場合、動画をアップロードした後にクリエイターIDを追加する必要があります。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/copy" \--header "Authorization: Bearer <API_TOKEN>" \--header "Content-Type: application/json" \--data '{"url":"https://example.com/myvideo.mp4","creator": "<CREATOR_ID>","thumbnailTimestampPct":0.529241,"allowedOrigins":["example.com"],"requireSignedURLs":true,"watermark":{"uid":"ea95132c15732412d22c1476fa83f27a"}}'レスポンス
{ "success": true, "errors": [], "messages": [], "result": { "allowedOrigins": [ "example.com" ], "created": "2014-01-02T02:20:00Z", "duration": 300, "input": { "height": 1080, "width": 1920 }, "maxDurationSeconds": 300, "meta": {}, "modified": "2014-01-02T02:20:00Z", "uploadExpiry": "2014-01-02T02:20:00Z", "playback": { "hls": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.m3u8", "dash": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/manifest/video.mpd" }, "preview": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/watch", "readyToStream": true, "requireSignedURLs": true, "size": 4190963, "status": { "state": "ready", "pctComplete": "100.000000", "errorReasonCode": "", "errorReasonText": "" }, "thumbnail": "https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.jpg", "thumbnailTimestampPct": 0.529241, "creator": "<CREATOR_ID>", "uid": "6b9e68b07dfee8cc2d116e4c51d6a957", "liveInput": "fc0a8dc887b16759bfd9ad922230a014", "uploaded": "2014-01-02T02:20:00Z", "watermark": { "uid": "6b9e68b07dfee8cc2d116e4c51d6a957", "size": 29472, "height": 600, "width": 400, "created": "2014-01-02T02:20:00Z", "downloadedFrom": "https://company.com/logo.png", "name": "マーケティング動画", "opacity": 0.75, "padding": 0.1, "scale": 0.1, "position": "center" } }}デフォルトのクリエイターID値を設定することで、動画を単一のクリエイターに関連付けることができ、後でクリエイターIDによる動画検索や分析データに使用できます。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/live_inputs" \--header "Authorization: Bearer <API_TOKEN>" \--header "Content-Type: application/json" \--data '{"DefaultCreator":"1234"}'複数のクリエイターがライブストリームを開始する場合は、ライブ入力を作成するを行い、各クリエイターごとにDefaultCreator値を設定します。各入力のデフォルトクリエイターIDを設定することで、クリエイターの入力からストリーミングされた録画動画はDefaultCreator値を継承します。
現時点では、APIを介してのみデフォルトクリエイターID値を管理できます。
既存の動画のクリエイタープロパティを更新するには、動画オブジェクトエンドポイントにPOSTリクエストを行い、以下の例のようにクリエイタープロパティを指定したJSONペイロードを送信します。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/<VIDEO_UID>" \--header "Authorization: Bearer <AUTH_TOKEN>" \--header "Content-Type: application/json" \--data '{"creator":"test123"}'curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/direct_upload" \--header "Authorization: Bearer <AUTH_TOKEN>" \--header "Content-Type: application/json" \--data '{"maxDurationSeconds":300,"expiry":"2021-01-02T02:20:00Z","creator": "<CREATOR_ID>", "thumbnailTimestampPct":0.529241,"allowedOrigins":["example.com"],"requireSignedURLs":true,"watermark":{"uid":"ea95132c15732412d22c1476fa83f27a"}}'レスポンス
{ "success": true, "errors": [], "messages": [], "result": { "uploadURL": "www.example.com/samplepath", "uid": "ea95132c15732412d22c1476fa83f27a", "creator": "<CREATOR_ID>", "watermark": { "uid": "ea95132c15732412d22c1476fa83f27a", "size": 29472, "height": 600, "width": 400, "created": "2014-01-02T02:20:00Z", "downloadedFrom": "https://company.com/logo.png", "name": "マーケティング動画", "opacity": 0.75, "padding": 0.1, "scale": 0.1, "position": "center" } }}curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/stream?after=2014-01-02T02:20:00Z&before=2014-01-02T02:20:00Z&include_counts=false&creator=<CREATOR_ID>&limit=undefined&asc=false&status=downloading,queued,inprogress,ready,error" \--header "Authorization: Bearer <API_TOKEN>"レスポンス
{ "success": true, "errors": [], "messages": [], "result": [ { "allowedOrigins": [ "example.com" ], "created": "2014-01-02T02:20:00Z", "duration": 300, "input": { "height": 1080, "width": 1920 }, "maxDurationSeconds": 300, "meta": {}, "modified": "2014-01-02T02:20:00Z", "uploadExpiry": "2014-01-02T02:20:00Z", "playback": { "hls": "https://customer-<CODE>.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.m3u8", "dash": "https://customer-<CODE>.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.mpd" }, "preview": "https://customer-<CODE>.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/watch", "readyToStream": true, "requireSignedURLs": true, "size": 4190963, "status": { "state": "ready", "pctComplete": "100.000000", "errorReasonCode": "", "errorReasonText": "" }, "thumbnail": "https://customer-<CODE>.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/thumbnails/thumbnail.jpg", "thumbnailTimestampPct": 0.529241, "creator": "some-creator-id", "uid": "ea95132c15732412d22c1476fa83f27a", "liveInput": "fc0a8dc887b16759bfd9ad922230a014", "uploaded": "2014-01-02T02:20:00Z", "watermark": { "uid": "ea95132c15732412d22c1476fa83f27a", "size": 29472, "height": 600, "width": 400, "created": "2014-01-02T02:20:00Z", "downloadedFrom": "https://company.com/logo.png", "name": "マーケティング動画", "opacity": 0.75, "padding": 0.1, "scale": 0.1, "position": "center" } } ], "total": "35586", "range": "1000"}Upload-Creatorヘッダーを介してクリエイターIDを追加します。詳細については、tusの使用を参照してください。
クリエイタープロパティを設定した後、GraphQL APIを使用して特定のクリエイターでフィルタリングできます。利用可能なメトリクスやフィルターについては、バルク分析の取得を参照してください。