プロジェクト API

現在の確認詳細、削除ブロッカー、切断されるアーカイブ済みデバイスを返します。呼び出し元がプロジェクトを削除できない場合（所有者または組織の管理者のみ可能。エージェントは担当者のみ）やブロッカーが残る場合、allowedはfalseで理由を返します。

オーナーは、確認済みの既存のプロジェクトメンバーにオーナー権を譲渡します。これにより新しいメンバーシップは付与されません。新しいオーナーのメンバーシップから screen_scope と upload_scope が外れるため、新しいオーナーはプロジェクト全体に到達できます。

メンバーでもあるプロジェクトの組織の管理者のダッシュボードセッションも、プロジェクトの現在のオーナーが誰であっても、同じ方法で所有権を移譲できます。メンバーではない組織の管理者は次のルートを使用します：PUT /api/organizations/{org_id}/projects/{project_id}/owner.

オーナー承認による移動は、スクリーンの占有と新しい使用量を移動先の支払者へアトミックに移します。過去の請求は元の支払者のままです。移動先がすでにプランが許可する数のライブプロジェクトを持っている場合は project_limit_reached になり、その required_plan には余裕のあるプランが示されます（Enterprise では示されません）。

オーナーが管理するか、検証済みドメインが検証済みメールと一致する宛先を一覧表示

アイデンティティのすべての有効なメンバーシップを組織とオーナーの文脈付きで一覧表示。トークンや同意で除外されたものも含む。in_token をマーク。ディスカバリーは権限追加なし、64プロジェクト制限なし。

検証済み責任者が所有する名前付きプロジェクトを作成します。組織名がない場合は、その人の検証済みドメインの組織に割り当てられ、なければ現在のプロジェクトの組織、さらにその人が管理または無料で保持している組織の中で最近使用した組織、または新しい組織に割り当てられます。

組織名は正確に1つの表示可能な一致を選択し、それ以外は新しい組織を作成します。1人のユーザーは1つの無料Standard組織を持ちます。それを超える新しい組織はfree_organization_limitで、そのユーザーが持つものを指します。

組織が保持できるライブプロジェクトの数は、プランが許可する数までです（Standard 1、Plus 3、Premium 10、Education 50、Enterprise 100。フィーチャーセットによって拡張されます）。もう1つ作成すると project_limit_reached になり、その required_plan には余裕のあるプランが示されます（Enterprise では示されません。サポートにお問い合わせください）。

正確な冪等リトライは、シールされたメンバーシップ資格情報を10分間再配信します。登録は制限の対象外です。

agentアクセスJWT（identity scope、access:manage、identity access Manage権限）ではプロジェクトトークンは発行されず、プロジェクトはManageと全機能の権限に参加し、project_idでのリフレッシュはそのトークンを返します。

現在のプロジェクトの招待ライフサイクル記録をサインインリセットを除いて一覧表示。受信者アドレスは所有プロジェクトに表示。トークンと認証URLは一覧に含まれない。

メンバーまたは広告購入者の招待を作成します。メール配信は認証情報を返しません。リンク配信はメンバーのみで、1つのURLを返し、24時間以内の正確な冪等リプレイでも同様です。メール招待は7日後に期限切れ、リンクは24時間後に期限切れになります。同じ種類、アドレス、プロジェクトの未処理のメール招待は再利用されます。

スクリーンに限定されたメンバーは、ユーザーを招待できません（outside_screen_scope）。

プロジェクトの組織の外部ゲストとなる（その組織がホーム組織ではない）ユーザーへの project_member メール招待には、その組織のゲストポリシーが適用され、ポリシー（allow、domains、none）がそのアドレスを受け入れない場合は guest_not_allowed（403）が返されます。招待の承諾時にも再度チェックされます。

スタッフと組織自身の管理者は対象外です。招待に screen_scope を指定することはスクリーンのスコープであり、Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。

未処理の招待を取り消します。承認済みの招待には invitation_consumed が返されます。スクリーンに限定されたメンバーは、招待を取り消せません（outside_screen_scope）。

アドレスを保持しているかどうかを明かさずにサインインリセットリクエストを受け付けます。

アドレスが未検証のユーザー（セルフサービスサインアップなど）も対象となり、そのリセットを完了すると（所有者は replace_unverified_account で確認する必要があります）、受信トレイの所有者に新しいアカウント（リセットの認証情報を持つ新しいユーザー、新しい組織とプロジェクト）が付与され、そのアドレスが本人のものであると誰も示していなかった未検証のユーザーは削除されます。

リセットリンクは最後に要求されてから 1 時間で期限切れになります。リンクが有効で発行から 1 日未満のあいだは、再度の要求で同じリンクを再送し（最大 10 分に 1 回）、期限を要求から 1 時間後に延ばします。そのため、要求によって受信箱にあるリンクが無効になることはありません。それ以外の場合は新しいリンクに置き換わります。アドレスごとの上限はありません。

リセットを完了すると、その人のほかのパスキー（パスワードのリセットではすべてのパスキー）が削除され、新しい認証情報がパスキーの場合はパスワードも削除され、保留中のメール変更は破棄され、すべてのセッションが終了します。人の有無にかかわらず、このリクエストはそのメール宛ての招待を最大 10 件再送し、各招待の再送は 1 時間に 1 回までです。

連絡先メールアドレスが一致する未削除の最新 10 プロジェクトのうち、カタログ内のプランを持ち、登録による所有権の確定がまだ保留中の有効なプロジェクトには、登録招待が再送されます。招待が期限切れの場合や、受信者がすでに通常のメンバーとして参加している場合も対象です。

既存のサインインでその登録招待を承諾すると、所有権の取得が完了します。復旧をリクエストするだけでは、所有権も認証情報も変更されません。カタログ内のプランを持つ有効なプロジェクトに対する、メンバーおよび広告購入者向けの未処理のメール招待と、有効な組織に対する管理者向けの未処理の招待が、新しい順に残りの枠を使用します。

再送された招待は ID を維持し、新しいリンクと有効期限を取得します。古いリンクは無効になり、プロジェクトの未処理の招待数は変わりません。期限切れの登録招待は新しい招待として作成され、招待枠を再び使用するため、件数が 1 増えます。プロジェクトが上限に達している場合はスキップされます。

その他の期限切れの招待、取り消された招待、承諾済みの招待、リンクとして共有された招待は再送されません。

連絡先アドレスが既に人物またはプロジェクトに属している場合でも、明示的なバンドルCLI登録を通じて新しいプロジェクトと最初のエージェントを作成します。連絡先メールは未検証のままで権限を付与せず、不正なアドレスはinvalid_requestを返します。

同じトランザクションで登録招待をキューします。project_nameは省略可能で、省略時は読みやすい2語の名前を使用します。完全な冪等リプレイがレート制限に先行します。永続的な認証情報を保存してから成功を報告します。リプレイ用の封筒はissuance_expires_atで期限切れとなり、その後の再試行はcredential_issuance_expiredを返します。

冪等レコードは24時間持続します。

ランタイムの公開オリジンから派生したAPIホストでAgentID（OIDC）ブラウザサインインを開始します（https://play.<domain> -> https://api.<domain>）。使い捨てのバインディングクッキーを設定し、PKCE S256付きのAgentID認可エンドポイントにリダイレクトします。APIホストでのみ応答します。

リライイングパーティにクライアントIDとシークレットがない場合、このルートは503の利用不可ページを表示します。

APIホストでAgentIDブラウザサインインを完了します。issは設定済み発行者と一致し、バインド済みクッキーと未期限切れの一回限りトランザクションが必要です。

client_secret_basic と PKCE でコードを交換し、ES256 id_token（iss、aud、exp（60秒のずれ許容）、nonce）をキャッシュされたJWKSで検証し、userinfo を呼び出しオーナールールを適用し、使い捨てのクレームコードページを表示します。すでにエージェントにバインドされたサブジェクトは既登録ページを表示します。

このルートはプロジェクト、ID、招待を作成しません。

呼び出しプロジェクト。1クレジットの API メーターはデビットしないため、残高0のプロジェクトでも残高を読み取り回復できます。成功したプロジェクトプリンシパルの後、認証済み /api JSON と問題応答には ScreenRig-Credits-Remaining、ScreenRig-Credits-Reset、ScreenRig-Credits-Included が全クレジットで含まれます。

SSE、ランタイム、コンテンツ、および認証されていないレスポンスはこれらを省略します。

現在のプロジェクト名を変更します。名前は1～60文字の印刷可能文字で、URLのようなテキストは含みません。

これを削除できるのはプロジェクトのオーナーか組織の管理者のみです。他の呼び出し元は forbidden で拒否されます。人物はプロジェクトのメンバーである必要があります。

エージェントは対象メンバーシップのプロジェクト権限を必要とし、責任者の人物（オーナーまたは組織管理者）として削除します。責任者がいないエージェントは削除できません。ただし、誰も参加を承認していない状態でプロジェクトを登録したエージェントは例外です。

現在の名前とリビジョン、非アーカイブのスクリーンがゼロ、クレジットなし、予約や負債が自身のウォレットにないこと、ライブ広告がないことも必要です。無料またはローンチ条件下でのマイナス残高はブロックしません。削除時に project_delete_writeoff 元帳エントリで帳消しにします。メンバー通知をキューに入れ、取り消し不能なトゥームストーンを使用します。

呼び出しプロジェクトのプラン、独立した広告主/画面フラグとそのリビジョン、派生した実効能力セット、持っているプラン機能（plan_features）、上限（limits）。クライアントの主張を反映せず、不明なプランは禁止として失敗します。

組織自身の監査ログ: 管理者、ドメイン、請求設定の変更を、GET /api/audit と同じエントリ、フィルター、形式で記録します。組織の管理者が必要です。Enterprise プランに含まれる監査ログの一部です。プランにこの機能が含まれていない組織は feature_not_in_plan（402）で拒否されます。

すべてのプランで変更が記録されます。

組織の通知（すべてのチャネル）を古い順に返します（最大50件）。

通知は組織に属し、後から追加されたプロジェクトを含む組織のすべてのプロジェクト (project_ids なし)、または選択したプロジェクト (project_ids) を対象にします。対象プロジェクトのスクリーン、ソース、キャンペーン、カードに対して、プロジェクトの通知とまったく同じように働きます。status は、対象プロジェクトのいずれかの配信が failing である間は failing で、failing_since、last_success_at、last_failure_at は対象プロジェクトの値をまとめたものです (最も早い失敗の開始、最新の成功と失敗)。

Webhook の署名シークレットはここでは返されません。組織の管理者が必要です。それ以外は not_found です。

POST /api/notifications のメンバーと、通知の対象となるプロジェクトを指定して、組織の通知を作成します。project_ids を省略するか null にすると、組織のすべてのプロジェクト（現在のものと今後加わるもの）が対象になります。リストを指定すると、そのプロジェクトだけが対象になります。各プロジェクトはこの組織のライブプロジェクトである必要があります（そうでない場合は invalid_request）。

メール通知の受信者は、owner（対象の各プロジェクトのオーナー）か、組織のユーザー（管理者とホームメンバー）または対象プロジェクトのメンバーの user_ids です。各プロジェクトがメールを送るのは、そのプロジェクトのメンバーであるユーザーだけです。

組織に作成できる通知は、システムが作成するデフォルトの通知を除いて最大50件です（notification_limit_reached）。チャネル、ルール、条件には、プロジェクトのルートと同じプランの機能による制限が、組織のプランに基づいて適用されます。対象の各プロジェクトに notification.created が追加され、この変更は組織の監査ログに記録されます。

Webhook の署名シークレットはこの応答と rotate-secret でのみ返されます。1つのシークレットが、対象のすべてのプロジェクトの配信に署名します。同じ Idempotency-Key を付けた同一内容の再試行には、シークレットを含む同じ応答が24時間返されます。

GET /api/organizations/{org_id}/notifications が示す、組織の1件の通知です。

PATCH /api/notifications/{id} が変更できるメンバーをすべて、通知と対象のすべてのプロジェクトで変更します。さらに project_ids も変更できます。省略するとプロジェクトは変わらず、null にするとすべてのプロジェクトが対象になり、リストを指定するとそのプロジェクトだけが対象になります。通知が新たに加わるプロジェクトでは、現在のイベントから始まります（それ以前のものは送信されません）。通知が外れるプロジェクトでは、その通知が削除されます。

対象の各プロジェクトに notification.updated が追加され、この変更は組織の監査ログに記録されます。

通知が現在対象にしていないプロジェクトを対象に加える変更は、変更後の通知を新規作成する場合と同じ機能チェックを受けます（組織のプランに対するチャネル、ルール、スクリーン上の条件）。対象のプロジェクトを減らす変更はチェックされません。リストからすべてのプロジェクトへの切り替えは、常に対象を増やします。If-Match がリビジョンを保護します。

通知を対象のすべてのプロジェクトから削除し、各プロジェクトに notification.deleted を追加して、組織の監査ログに記録します。送信待ちの通知は webhook_deleted で失敗として扱われます。

Webhook 通知のみです（それ以外のチャネルは invalid_request）。対象のすべてのプロジェクトの署名シークレットを一度に置き換えるため、1つの受信先は1つのシークレットで検証を続けられます。新しいシークレットを secret に含めた通知を返します。

POST /api/notifications/{id}/rotate-secret と同様に、プロジェクトごとに、すでに送信中の試行が最大1回、古いシークレットで署名されたまま届くことがあります。同じ Idempotency-Key を付けた同一内容の再試行には、同じ新しいシークレットが24時間返されます。

通知の対象となる最初のプロジェクト（プロジェクト id 順）を通じて notification.test を1件送信します。POST /api/notifications/{id}/test がそのプロジェクトを通じて送信するのと同じです。配信は1件で、結果は配信の一覧に表示され、試行は1回だけです。

対象のすべてのプロジェクトで受信先、送信先、シークレットが同じなので、1回のテストでチャネルを確認できます。テストのメールは、そのプロジェクトの受信者に送信されます。どのプロジェクトも対象にしない通知は invalid_request です。

通知の対象となるすべてのプロジェクトの配信ログを、1つの一覧にして、各行がキューに入った時刻の新しい順に返します。各行にはプロジェクト（project_id）が示され、その id で GET .../deliveries/{delivery_id}/attempts を開けます。次のページを取得するには、これまでと同様に next_cursor を渡します。

1件の配信の試行を新しい順に、直近20件まで返します。この通知の配信でないものは not_found です。

メール通知の対象ユーザーが、メール内の配信停止リンクで停止した後に、再びメールを送ります。通知が対象とするすべてのプロジェクトに適用されます（リンクはそのすべてで停止します）。冪等です。停止していないユーザーには何も変わらず、応答はそのままの通知です。

変更するとリビジョンが上がり、対象の各プロジェクトに、change は resubscribed、user_id、via は api の詳細とともに notification.updated が追加されます。

GET /api/reports/{kind} が作成するレポートの種類と、それぞれのフィルター、レポートの出力形式を一覧します。レポートのケイパビリティが必要です。

プロジェクトのスケジュール済みレポートを古い順に一覧します（最大 50 件）。各レポートの次回の実行と前回の結果を含みます。プロジェクトのケイパビリティが必要です。

レポートを PDF、XLSX、CSV の添付ファイルとして、毎日・毎週・毎月、指定したタイムゾーンの時刻にメールで送るよう設定します。

各実行は直前の期間を UTC の日単位で対象にします（前日、直前の7日間、または先月）。recipients はプロジェクトのメンバーで、user_id またはメンバーのメールアドレスで指定します。メンバー以外は拒否されるため、購読が外部の人にメールを送る手段になることはなく、退出したメンバーには届かなくなります。

失敗した実行は再試行され、last_status failed と last_error で示されます。1 組織あたり、すべてのプロジェクトを合わせて最大 50 件（report_subscription_limit_reached）。

有効な組織の指定管理者、オリジンが完全に一致する Cookie 認証、JWT CSRF が必要です。実行者と戻り先 URL はサーバーが管理します。レスポンスは private かつ no-store です。リセラーに委任されている組織にも、そのカードと過去の請求書のために開かれています。

有効な組織の指定管理者、オリジンが完全に一致する Cookie 認証、JWT CSRF が必要です。実行者はサーバーが管理します。無効にしても、保存済みの金額と月間の支出額は保持され、無効の場合は金額フィールドが無視されます。レスポンスは private かつ no-store です。設定を変更すると、失敗した支払い対象の請求書が安全に無効化された後にのみ、回復可能な一時停止が解除されます。

リセラーに委任されている組織で有効にすると 409 billed_by_reseller が返ります。無効にすることは引き続き可能です。

有効な組織の支払い情報。指定管理者の Cookie が必要です。スタッフとして閲覧できるだけでは購入権限は付与されません。支払いが未設定の場合は available false を返します。ブラウザーが戻ってきただけではクレジットは付与されません。

有効な組織の指定管理者として前払い購入を開始します。同一オリジンの Cookie 認証と、JWT セッションの場合は一致する CSRF ヘッダーが必要です。組織、顧客、実行者、戻り先 URL はサーバーが管理します。クレジットは請求サービスが支払いを確認した後にのみ適用されます。応答が不明確な場合は同じ Idempotency-Key と金額で再試行してください。

リセラーに委任されている組織には 409 billed_by_reseller が返ります。

組織のウォレット。指定された組織管理者、組織の委任先リセラーの管理者、またはスタッフセッションが必要です。プロジェクトメンバーシップは付与しません。

課金時にこの組織に帰属するジャーナルエントリで、プロジェクトと支払者のIDを含みます。移動は履歴アクセスを移転しません。記録された組織コンテキスト以前のエントリはプロジェクトの明細に残ります。残高と同じユーザーが読み取れます（getOrganizationBillingBalance）。

組織の UTC 1 か月間の使用プールと、各プロジェクトの割合。この組織が支払う使用量が対象で、その他の支払者の費用は組織の明細に記載されています。残高と同じユーザーが読み取れます（getOrganizationBillingBalance）。

管理者のための空の組織を含む、表示可能な組織です。名前は一意ではありません。

指定された管理者と、確認済みの責任者が管理者であるエージェントは組織名を変更できます。プロジェクトの権限やメンバーシップは付与されません。

エージェント変更のレビュー必須をオンまたはオフにします。オンの場合、プロジェクトのすべてのエージェントとサービスクライアントは、資格情報に関係なくすべてのリクエストでProposeアクセスに制限されます。変更できるのはプロジェクトの所有者か組織の管理者のみ（それ以外は禁止）。スタッフのシャドウセッションは変更できません。

If-Matchはreview_policy_revision（0許可）を持ち必須です。古い値はrevision_conflict。オフにするには証明が必要で、エージェント接続承認に使う新しいpasskeyまたはpassword証明が必要。オンは不要。オープンレビューはどちらでも決定可能。project.review_policy_changedを追加。

現在の確認詳細、削除ブロッカー、切断されるアーカイブ済みデバイスを返します。呼び出し元がプロジェクトを削除できない場合（所有者または組織の管理者のみ可能。エージェントは担当者のみ）やブロッカーが残る場合、allowedはfalseで理由を返します。

オーナーは、確認済みの既存のプロジェクトメンバーにオーナー権を譲渡します。これにより新しいメンバーシップは付与されません。新しいオーナーのメンバーシップから screen_scope と upload_scope が外れるため、新しいオーナーはプロジェクト全体に到達できます。

所有者承認の移動はスクリーンの占有と新しい使用を宛先支払者に原子操作で移転し、過去の請求は元の支払者のままです。

オーナーが管理するか、検証済みドメインが検証済みメールと一致する宛先を一覧表示

現在のプロジェクトの招待ライフサイクル記録をサインインリセットを除いて一覧表示。受信者アドレスは所有プロジェクトに表示。トークンと認証URLは一覧に含まれない。

メンバーまたは広告購入者の招待を作成します。メール配信は認証情報を返しません。リンク配信はメンバーのみで、1つのURLを返し、24時間以内の正確な冪等リプレイでも同様です。メール招待は7日後に期限切れ、リンクは24時間後に期限切れになります。同じ種類、アドレス、プロジェクトの未処理のメール招待は再利用されます。

スクリーンに限定されたメンバーは、ユーザーを招待できません（outside_screen_scope）。

プロジェクトの組織の外部ゲストとなる（その組織がホーム組織ではない）ユーザーへの project_member メール招待には、その組織のゲストポリシーが適用され、ポリシー（allow、domains、none）がそのアドレスを受け入れない場合は guest_not_allowed（403）が返されます。招待の承諾時にも再度チェックされます。

スタッフと組織自身の管理者は対象外です。招待に screen_scope を指定することはスクリーンのスコープであり、Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。

呼び出しプロジェクト。1クレジットの API メーターはデビットしないため、残高0のプロジェクトでも残高を読み取り回復できます。成功したプロジェクトプリンシパルの後、認証済み /api JSON と問題応答には ScreenRig-Credits-Remaining、ScreenRig-Credits-Reset、ScreenRig-Credits-Included が全クレジットで含まれます。

SSE、ランタイム、コンテンツ、および認証されていないレスポンスはこれらを省略します。

現在のプロジェクト名を変更します。名前は1～60文字の印刷可能文字で、URLのようなテキストは含みません。

これを削除できるのはプロジェクトのオーナーか組織の管理者のみです。他の呼び出し元は forbidden で拒否されます。人物はプロジェクトのメンバーである必要があります。

エージェントは対象メンバーシップのプロジェクト権限を必要とし、責任者の人物（オーナーまたは組織管理者）として削除します。責任者がいないエージェントは削除できません。ただし、誰も参加を承認していない状態でプロジェクトを登録したエージェントは例外です。

現在の名前とリビジョン、非アーカイブのスクリーンがゼロ、クレジットなし、予約や負債が自身のウォレットにないこと、ライブ広告がないことも必要です。無料またはローンチ条件下でのマイナス残高はブロックしません。削除時に project_delete_writeoff 元帳エントリで帳消しにします。メンバー通知をキューに入れ、取り消し不能なトゥームストーンを使用します。

アプリケーションを新しい順に最大500件ずつ一覧表示。名前はラベルで一意である必要なし。IDで指定。next_cursor は最後の行の位置で、続きがあれば after として同じフィルターで次ページに渡す。最後のページは null。

CLI 生成の tar.gz を直接制限付き耐久ステージングにストリーム。メタデータはヘッダーに含まれ、アーカイブはサーバーで base64 包装や JSON 化されません。

API の前のプロキシは、約 100 s 以内に応答していないリクエストを終了するため、低速なアップリンク上の大きなアーカイブはここで失敗します。POST /api/applications/uploads は代わりにアーカイブをオブジェクトストアに直接送信します。

新しいアプリケーションを作成する、CLI で生成された tar.gz の直接アップロードを宣言します。応答はアーカイブのちょうど 1 回のオブジェクト PUT に対する署名付き承認であるため、バイトはオブジェクトストアに直接送られ、API を経由することはありません。API のプロキシは、約 100 s 以内に応答していないリクエストを終了します。

アーカイブを upload_url に PUT し、次に POST /api/applications/uploads/{id}/commit でコミットし、操作を待ちます。アプリケーション、そのリリース、受信操作は、POST /api/applications の後と同様に、この応答から存在します。24 時間以内にコミットされなかったアップロードは失敗し、リリースを一度も公開しなかったアプリケーションは削除されます。

同じ Idempotency-Key と本文は、新しく署名された URL で同じアップロードを返します。GET /api/capabilities は、これらのルートが提供される場所で features.application_direct_uploads を設定します。

広告スロットページを公開する可能性のあるバージョン管理されたプレイリストリスト。v1リストはフィルタリングせずにversion_requiredを持つ広告文書のページを拒否します。

ページはlistPlaylistsのように新しい順で、1ページあたり最大200件、8MiBのplaylist保存容量に達すると少なくなります。next_cursorは最後に返された行の位置で、さらに行がある場合はafterとして同じフィルターで次ページに渡します。最後のページではnext_cursorはnullです。library=trueを指定すると、代わりに組織のライブラリのプレイリストを一覧します（読み取り専用。スケジュールに組み込むか、そのテンプレートから作成できます）。

広告スロットページの結合の作成エントリ。最大16の広告スロットページ、少なくとも1つの表示されない通常ページ、および異なるページでの1つのスロット定義の再利用はサーバーチェックのままです。参照解決とDNSもサーバーチェックです。

Player ウェブアプリでフレーム化できない iframe ページを含む書き込みも保存されます。応答に警告（PlaylistWarning）が含まれ、ページごとに playlist.iframe_framing_refused イベントがプロジェクトのログに追加されます。

iframe の src、fallback_src、またはアプリケーションの params が、プレイリストを表示するスクリーンにないスクリーントークン（{screen.field.NAME} など、プリミティブスキーマにあるもの）を読み取る書き込みも、そのようなスクリーンを最初の20件挙げた screen_fact_missing 警告を返します。それらのスクリーンのマニフェストからはそのプリミティブが除外されます。

Google スライド、ドキュメント、スプレッドシートのリンク（共有、ウェブに公開、埋め込み）または Microsoft 365 の OneDrive や SharePoint の埋め込みリンクである iframe の src または fallback_src は、スクリーン向けに再構築されて保存されます。スライドはループし、リンクの delayms をページの長さに制限して進み、ドキュメント、スプレッドシート、Word、Excel は 5 分ごとに再読み込みされます。

src または fallback_src に貼り付けられた <iframe> 埋め込みコードは、その src が読み取られます。閲覧者にサインインを求めるファイルは document_not_shared (400) で拒否され、その errors[0].field はその src または fallback_src で、詳細には変更すべき共有設定が示されます。

デフォルトのリストはpairing_pendingとactiveのスクリーンを返します。state=archivedを渡すとアーカイブ済みスクリーンのみをリストします。tagを渡すと、そのタグを正確に含むスクリーンのみをリストし、タグなしスクリーンはフィルターがある場合は除外されます。

field を NAME:VALUE の形式でフィールドごとに1回ずつ渡すと、すべての値に一致するフィールドを持つスクリーンのみが一覧表示されます。near を LAT,LON,KM の形式で渡すと、地点から KM キロメートル以内にあるスクリーンのみが一覧表示されます。位置情報のないスクリーンは除外され、すべてのフィルターは state および tag と組み合わせて使えます。

folder にスクリーンフォルダーIDを渡すと、その直下のスクリーンのみを一覧します（サブフォルダーのスクリーンは含みません）。root を渡すと、どのフォルダーにも入っていないスクリーンを一覧します。

スクリーンは新しい順で、1ページあたり最大500件です。next_cursor は、さらに行が残っている間は、最後に返された行の位置です。次のページには、同じフィルターで after として渡してください。最後のページでは next_cursor は null です。スクリーンに限定された呼び出し元（docs/screen-scope.md）には、スコープ内のスクリーンのみが一覧表示されます。

プロジェクトを指定しないリクエストでは、呼び出し元がスクリーンに限定されているプロジェクトは除外されます。一覧に含めるには、プロジェクトを指定してください。

プロジェクト内のすべてのスクリーンフォルダーを名前順に最大1000件リストします。

フォルダーはスクリーンを整理し、対象として指定できます。キャンペーンの audience のリーフ {"folder": ID} はそのフォルダーとその中のすべてのフォルダーにあるスクリーンに一致し、フリートアクションのセレクター by:folder は同じスクリーンに作用し、フォルダーの default_playlist_id は、独自のプレイリストを持たないスクリーンが表示するプレイリストです。parent_id はプロジェクトのルートで null です。ツリーは parent_id から構築します。screens は各フォルダー直下のライブスクリーンの数です。

スクリーンのフォルダーは Screen.folder_id です。スクリーンに限定された呼び出し元（docs/screen-scope.md）には、スコープ内のフォルダーとその上位のフォルダーが一覧表示されます。上位のフォルダーは、ツリーにルートがあるように読み取り専用で、スクリーン数は含まれず、兄弟フォルダーは非表示です。プロジェクトを指定しないリクエストでは、呼び出し元がスクリーンに限定されているプロジェクトは除外されます。

プロジェクトのルート（parent_id が null または省略）または parent_id の中に、スクリーンフォルダーを1つ作成します。名前はトリムされ、制御文字なしの1～100のUnicode文字で、「.」や「..」ではなく、同じ親の下の兄弟フォルダー間で一意です（resource_conflict）。

組織が保持できるフォルダーは、すべてのプロジェクトを合わせて最大1000個（quota_exceeded）、ネストは最大10階層まで（invalid_request）です。default_playlist_id を設定する場合は、承認済みプレイリストを指定する必要があります（playlist_not_approved）。screen.folder_created を発行します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）がフォルダーを作成できるのは、スコープ内のフォルダーの内側のみです。プロジェクトルートやその他の親は outside_screen_scope です。保護されたフォルダー内にフォルダーを作成すると protected_change レビューとなり（202 pending_review）、2人目の承認者が決定します。

スクリーン（screen_ids）とフォルダー（folder_ids）を1つのフォルダー（folder_id）に、または folder_id が null の場合はプロジェクトのルートに移動します。最大1000個の ID を1つのリクエストで扱い、全件成功か全件失敗のどちらかです。すべての ID が存在する必要があります（not_found）。フォルダーは自身またはその内部のフォルダーに移動できず、移動後はすべてのフォルダーが10階層以内でなければなりません（invalid_request）。

すでに移動先にあるアイテムはそのままにし、移動した各スクリーンとフォルダーはリビジョンが進みます。移動したスクリーンは約15秒以内にプレイリストを再解決します。levels には、スクリーンが入る、または出るフォルダー audience を持つキャンペーンと、スクリーンが得る、または失うフォルダーのデフォルトプレイリストが示されます。screen.moved を発行します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、スコープ内のスクリーンとフォルダーを、スコープ内のフォルダーへ移動します。スコープ外のIDや移動先、プロジェクトルートがあると移動全体が拒否され（outside_screen_scope）、確認から書き込みまでの間にスクリーンがスコープから外れた場合も同様です。

保護されたフォルダーへの、またはそこからの移動は、protected_change レビューとなり（202 pending_review）、2人目の承認者が決定します。

ダッシュボードのスケジュールカレンダー向けに、対象のスクリーンが [from, to) の間に何を再生するかとその理由を返します。screen_id、folder_id（フォルダーとその内側のすべてのフォルダーにあるスクリーン）、tag、campaign_id（そのオーディエンスのスクリーン）のうち、ちょうど 1 つを指定します。

スタックの入力が同一のスクリーン（同じレベル、デフォルト、タイムゾーン、ディスプレイ数）は 1 つのグループとタイムラインを共有するため、大きな対象でも数十本のタイムラインで済みます。グループには最大 500 台のスクリーン、応答には最大 200 グループが含まれます（truncated）。

各グループは、優先度の高い順のスタック（テイクオーバー、スクリーンに届くキャンペーン、スクリーン自身のスケジュールエントリー、続いてデフォルトのプレイリストまたは最も近いフォルダーのもの）、各レベルの区間（対象のすべてのディスプレイで再生する、再生するディスプレイが一部のみの partial、outranked、または操作や Player だけが観測するデータ条件を待つ間の conditional）、各ディスプレイに表示される内容（on_screen。フルページの場合はメイン領域）、および競合（同じ優先度の 2 つのキャンペーンが同時に成立する場合、成立しているのに再生されないレベル）を持ちます。from と to は RFC 3339 の時刻で、to は from より後、間隔は最大 93 日です。分未満は切り捨てられます。

ルールは、スイープとすべてのPlayerが読み取るのと同じように、各グループのタイムゾーンで読み取られます。すべてのレベルが再生可能と判断されます。スクリーンに限定された呼び出し元（docs/screen-scope.md）は、スコープ内の screen_id または folder_id を送信する必要があります。タグ、campaign_id、対象なしは outside_screen_scope です。

スケジュールインポートが読む列と3つのサンプル行（スクリーンコード、スクリーンフォルダー、タグ）を含むシートを、CSV または format=xlsx を指定した場合は XLSX ワークブックとして返します。

スケジュール行のシートをプロジェクトに照らして読み取り、確定した場合に何が行われるかを返します。何も書き込みません。

各行には、対象（スクリーン ID、部屋コードなどのスクリーンフィールドの値、または名前によるスクリーン、folder:NAME、tag:NAME。複数の場合は ; または | で区切る）、コンテンツ（メディアファイル名、playlist:NAME、またはプレイリスト ID）、開始と終了（終了に日付だけを指定するとその日いっぱいで終了）を指定します。任意で timezone、days (Mon-Fri)、毎日の時間帯（daily_start、daily_end）、0から100の priority、名前、ディスプレイ番号も指定できます。

時刻は各スクリーン自身の時計で読み取られます。timezone 列で別のタイムゾーンから変換できます。

すべての行が検証され、エラーは列ごとに報告されます。不明または曖昧なスクリーン、フォルダー、タグ、存在しないまたは曖昧なファイル、スクリーンを満たせないファイル、無効または逆転した時刻、過去の終了、タイミングの指定がまったくない、タイムゾーンまたはデフォルトプレイリストのないスクリーン、同じ優先度でスクリーン上に同時に有効な2つの行、スクリーンが保持できる数（32）を超えるレベル、または組織がすべてのプロジェクトを合わせて保持できる数（100、共有レベルはそれぞれ1件に数えられます）を超えるキャンペーン。

コンテンツ、時刻、優先度、名前が一致する行は1つのレベルになります。1つのスクリーンはそのスクリーン自身のスケジュールのエントリになり、複数のスクリーン、フォルダー、タグは1つの共有レベル（キャンペーン）になり、スクリーン独自のレベルより優先されます。

応答には、確定が各レベルに行う処理（create、update、unchanged）とともにレベルが一覧表示されます。さらに、同じインポートの以前の実行で作成され、シートにはもうないレベル（removals）、スクリーンのスタックの確定後の状態（calendar）、確定に送信するフィンガープリントが含まれます。シートは JSON の行、CSV、または XLSX で、最大5,000行です。

スクリーンに限定された呼び出し元は利用できません（outside_screen_scope）。スケジュールインポートは Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。テンプレートはすべてのプランで利用できます。

プレビュー済みのインポートを確定します。同じシートと、そのプレビューが返したフィンガープリントを送信します。すべてのレベルが作成、更新、削除され、スクリーンのスケジュールと共有レベルが1つのトランザクションで書き込まれ、インポートイベント schedule.imported が追記されます。すべての行が適用されるか、まったく適用されないかのどちらかです。

シートのファイルに必要な1ファイルのプレイリストが最初に作成されます（どのスクリーンにも変更はありません）。行にエラーのあるシートは拒否されます（schedule_import_invalid）。プレビュー後にプロジェクトが変更された場合や、行の読み取り結果が変わった場合も拒否され（schedule_import_stale）、クライアントはもう一度プレビューします。

同じ名前で同じシートを再度インポートしても何も変わりません。変更された行はそのレベルを更新し、削除された行はそのレベルを削除します。ダッシュボードで承認できるユーザーと、エージェント用の書き込みアクセスを持つ認証情報が必要です。

確保済みキャンペーンを更新または削除するコミットは、承認できる人がコミットしない限り、reserved_item（403）を返し、何も書き込みません。

保護されたスクリーンに及ぶコミットは、インポートにレベルがなくても、保護されたスクリーンのインポートエントリを削除する場合や、対象が保護されたスクリーンに及ぶインポートキャンペーンを削除する場合に、protected_target で全体が拒否されます。

保護されたスクリーンフォルダーのあるプロジェクトでは、プレビューがシートではなくサービスで失敗するコミットは dependency_unavailable で応答し、何も書き込みません。少し待って同じリクエストをもう一度送信してください。シート、キャンペーン、スクリーンの検証エラーは、コミット時と同じように応答されます（invalid_request と上記のその他の問題）。

スクリーンに限定された呼び出し元は利用できません。スケジュールインポートは Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。テンプレートはすべてのプランで利用できます。

認証されたプロジェクトのブラウザリンクコードを1つ請求し、正確に1つの最初のpairing_pendingスクリーンと既存のブラウザプロビジョニング権限を原子操作で作成します。登録はプロジェクトのみです。レスポンスは安全なメタデータのみで、プロビジョニングトークン、フラグメントURL、クッキー、証明は含みません。

フリート全体で有効な6文字のPlayerペアリングセッションを1つ請求します。同一のIdempotency-Keyによる再試行は、クォータを再消費せずに元の結果を返します。

ダッシュボードセッションは、同じ本文、Idempotency-Key、予算、問題で現在のプロジェクトにクレームしますが、不明なコードまたはすでにクレーム済みのコードの not_found が CLI コマンドを示さない点が異なります。これは状態の変更であるため、ダッシュボードの変更ルールに従い、スタッフの書き込みモードがないシャドウセッションは拒否され、クレームが追加するイベントにはダッシュボードのユーザーが示されます。folder_id は、スクリーンが配置されるフォルダーを指定します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、スコープ内のフォルダーを送信する必要があり、ペアリングできるのは承認できる人としてのみです（outside_screen_scope、approver_required）。

ブラウザー専用の新しいスクリーンのプロビジョニング（任意）。常に pairing_pending スクリーンを1つ新しく作成します。同時にペアリングを待てるのは最大5台です（quota_exceeded）。正確な再試行は、同じフラグメントトークンを10分間再送します。6文字のペアリングが、引き続きデフォルトで唯一の復旧フローです。folder_id は、スクリーンが配置されるフォルダーを指定します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、スコープ内のフォルダーを送信する必要があります（そうでない場合は outside_screen_scope）。

選択されたフリートに1つのアクションを適用します。スクリーン数の上限はありません。ユニークなscreen_idsまたは作成順にアクティブなスクリーンにマッチするタグを選択します。解決された選択は変異前に固定され、制限されたチャンクに保存され、Idempotency-Keyの下で24時間保持されます。

各ステップは単一スクリーンの変更経路を使い、リビジョン、イベント、実行時シグナル、スクリーンごとの制限を保持します。レスポンスには1ページ分の結果が含まれ、マッチ数、成功数、失敗数はそのページを示します。HTTP 202 には合計、オフセット、next_cursorが含まれます。同じセレクター、アクション、Idempotency-Keyで続行し、next_cursorをafterとして渡します。

Retry-Afterが存在する場合は必ず反映します。結果が0件のページも含みます。応答にはIdempotency-Keyが含まれ、呼び出し元が省略した場合も生成されたキーを返します。継続時はこのキーを保持してください。HTTP 200 で選択が完了します。応答済みページは、各スクリーンの失敗も含めて正確に再現されます。中断されたステップは、効果を繰り返さずに再実行されます。

大きな操作は既存の組織ごとの600回/分の予算に対してペース配分されます（リロード、トースト、テイクオーバー、プレイリストスケジュール、再起動、ディスプレイおよびディスプレイスケジュール）。組織の予算枯渇は操作を停止し、フリートを拒否しません。スクリーンごとの枯渇はそのスクリーンのみ失敗します。

フォーマットを持つプレイリストを、形状の異なるウォールのスクリーンに結び付ける割り当て、テイクオーバー、または set_playlist_schedule ステップは、そのスクリーンのみ 409 playlist_format_mismatch で失敗します。割り当てとタグの変更にはメッセージ予算がありません。

ページ内のいずれかのスクリーンにないスクリーントークンを読み取る iframe の src またはアプリケーションの params を持つプレイリストの割り当ては、そのページに screen_fact_missing 警告を追加します（warnings、PlaylistWarning）。部分的な失敗は通常の結果です。1つのキーによるすべてのページと再試行は、1回の従量課金アクションです。

リクエストにはバイト数に上限のあるペイロードを使用します。トランスポートのペイロードより大きい選択にはタグを使用してください。不正な形式のセレクターまたはアクションは、スクリーンに触れる前に拒否されます。selector または action は、スクリーンに触れる前に拒否されます。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、screen_ids またはフォルダーで選択し、すべてスコープ内のスクリーンである必要があります。タグセレクター、スコープ外のスクリーン、不明なスクリーンがあると、何かが固定または提案される前にアクション全体が拒否されます（outside_screen_scope）。

保護されたスクリーンに及ぶ assign、takeover、takeover_clear、set_playlist_schedule、clear_playlist_schedule は、すべてのアクセスレベルで、2人目の承認者が決定するレビューになります（202 pending_review）。保護されたスクリーンの set_tags、add_tags、remove_tags は protected_target（409）です。

一時停止中のエントリ（下書き）を持つ set_playlist_schedule アクションはスケジュールの変更管理であり、Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。

指定プロジェクトのスクリーンにブラウザータブを表示します。要求、応答、アクセス、制限はPOST /api/tab-sharesと同じです。

プロジェクトのキャンペーンを優先順位順（最大100件）に一覧表示します。解決時にもこの順序で読み取られます。reserved はすべてのキャンペーンに含まれます。

スクリーンに限定された呼び出し元（docs/screen-scope.md）には、すべてのキャンペーンが表示されますが、editable が true になるのは、対象全体がスコープ内にあり、呼び出し元が再生内容を変更できる場合のみです（タグのリーフとルートの全スクリーンルールは該当しません。all ルールには含まれる子が1つ、any ルールにはすべての子が必要です）。

パスで指定されたプロジェクトの createCampaign。reserved が true の場合はキャンペーンを確保し、設定できるのは承認できる人だけです（エージェント、サービスクライアント、その他の場合は reserved_item）。campaign.reserved_changed が追加されます。

スクリーンに限定された呼び出し元（docs/screen-scope.md）がキャンペーンを作成できるのは、スコープ内の対象に対してのみです（folder と screen_id のリーフのみ。タグや全スクリーンは不可）。それ以外は outside_screen_scope となり、作成できるのは承認できる人としてのみです（approver_required）。

対象が保護されたスクリーンに及ぶキャンペーンは、すべてのアクセスレベルで protected_change レビューとなり、2人目の承認者が決定します（202 pending_review）。reserved が true の場合は保護フォルダー、新規キャンペーン（下書き）で paused が true の場合はスケジュールの変更管理であり、どちらも Enterprise プランに含まれます。プランにこの機能が含まれていないプロジェクトは feature_not_in_plan（402）で拒否されます。

プロジェクトの接続を新しい順に、1 ページ最大 200 件で一覧表示します。次のページには next_cursor を after として渡します。シークレット、キー、更新トークンは返されません。secret は、保持されているかどうかと、秘密ではないヒントを示します。読み取りに同意リンクが含まれることはありません。

このプロジェクトに、Microsoft または Google への接続を作成します。お客様自身の認証情報を使うモード own_app、または、完了する人向けの 1 回限りのリンク consent_url を返すモード screenrig_app です (createConnection を参照)。connection.created を追記します。同じ Idempotency-Key での同一の再試行は、同じ接続を返します。

プロジェクトの BI 接続を古い順に 1 ページ 200 件で一覧表示します。次のページには next_cursor を cursor として渡します。シークレットは返されず、secret には設定の有無と末尾 4 文字が示されます。

プロジェクトが所有する BI システムへの接続を追加します。Grafana の場合は、そのアドレス（公開ホスト上の http または https。パスのプレフィックスは任意）と、Viewer ロールのサービスアカウントトークンを指定します。トークンは封印され、返されることはありません。

Grafana renders dashboards for screens through its Image Renderer plugin or remote rendering service, so the customer installs one; run POST /api/bi-connections/{id}/test to check. For Power BI (kind powerbi): config.tenant_id and config.client_id of a Microsoft Entra app registration and its client secret value as secret.

Power BI 管理者は、アプリに対して開発者設定の Embed content in apps と Service principals can call Fabric public APIs を有効にする必要があります（管理ポータル、テナント設定）。アプリは、表示する各ワークスペースのメンバーまたは管理者である必要があり、本番ではレポートに Embedded、Fabric、または Premium の容量が必要です。

For Tableau (kind tableau): config.url (the https address of Tableau Server, or of your Tableau Cloud pod such as https://10ay.online.tableau.com), config.site (the site content URL, empty for the default site), config.client_id and config.secret_id of a connected app with direct trust, config.username (the Tableau user the screens views are shown as) and the secret value as secret.

応答の embed_origin を、接続アプリのドメイン許可リストに追加し、シークレットを有効にします。スクリーンのチケットを持つ人は、そのユーザーが見られるどのビューでも埋め込めるため、スクリーン用のダッシュボードだけを見られるユーザーを使ってください。Tableau Cloud、または Tableau Server 2023.3 以降。

サインインが必要な Web ページ (kind web) 用: サインインの向こうにダッシュボードを表示するサイトのサービスアカウントです。config.login_mode は、auto (config.login_url、config.username、secret としてのパスワード: レンダラーがサインインページを開いてフォームに入力します)、steps (config.login_url と config.steps。goto、fill、click、press、wait_for、wait_ms のステップからなるスクリプトで、値には {{username}}、{{password}}、{{otp}} を含められます)、または none (サインインなし: 接続は、与えたクッキーでページを表示します) のいずれかです。totp_secret は、アカウントの認証アプリの base32 キー、または otpauth:// アドレスです。サーバーがワンタイムコード (RFC 6238) を計算し、レンダラーにはコードだけを送ります。cookies は、サインインをスクリプト化できないサイト (電話で承認するシングルサインオン、デバイスチェックなど) のために、サインイン済みのブラウザーからエクスポートしたクッキーセットです。サーバーはセットを保持し、各キャプチャが返すクッキーで更新するため、サインインが必要になることはまれです。

パスワード、シード、クッキーは封印され、返されることはありません。読み取り専用のサービスアカウントを使ってください。パスワードは config.login_url と goto ステップにだけ入力されるため、それらを別のオリジンに移すには secret をもう一度指定する必要があります。サインインが 5 回続けて拒否されると、認証情報が変更されるまで、接続はサインインしなくなります。

ページレンダラーのないサーバーは bi_web_unavailable を返します。bi_connection.created を追記します。同じ Idempotency-Key での同一の再試行は、同じ応答を返します。

Lists the project's BI views, oldest first, 200 to a page; pass next_cursor back as cursor for the next. Each carries embed_url, the address an iframe primitive shows (content_fit fill); it is null where this server has no embed host.

接続の Grafana ダッシュボード、またはその 1 つのパネルのビューを追加します（url：接続のホスト上の /d/{uid}/... アドレス、または target）。あるいは Grafana の公開ダッシュボードリンクのビューを追加します（kind grafana と target.public_url。接続は不要）。

Put the answer's embed_url in an iframe primitive: the server renders the dashboard as a PNG through Grafana's /render API, refreshed every refresh_s (30 to 86400, default 300) and shared by every screen of the same size; the screen never talks to Grafana. A public dashboard plays live from Grafana, which must allow embedding.

埋め込みページは、画面のマニフェストが持つチケットだけを表示するため、ビューは自分のプロジェクトの画面でのみ再生されます。

For Power BI (kind powerbi): a report of a workspace the connection's app is a member of (url: an app.powerbi.com /groups/{workspace}/reports/{report} address, or target with workspace_id and report_id), with pages to show and rotate_s to rotate through them (pages listing two or more, or rotate_all_pages, need rotate_s of 10 to 3600; one report page needs none), and refresh_s of 0 (no refresh) or 60 to 86400 (default 300).

The page asks the server for a short-lived view-only embed token (GenerateToken, App owns data) and renews it before it expires; the screen never holds the client secret. A Power BI Publish to web link is a view without a connection (kind powerbi, target.public_url https://app.powerbi.com/view?r=...), framed as it is.

For Tableau (kind tableau): a view of the connection site (url: an address copied from Tableau, such as https://HOST/t/SITE/views/WORKBOOK/VIEW or Tableau Cloud https://HOST/#/site/SITE/views/WORKBOOK/VIEW, or Workbook/View; or target.view), optionally with target.rotate_sheets and rotate_s of 10 to 3600 to turn the workbook published sheets (rotate_s and rotate_sheets go together; rotate_sheets may be given as the whole target beside url), and refresh_s of 0 (no refresh) or 60 to 86400 (default 300).

The page asks the server for a five minute JWT with only the embed scope, signed with the connected app secret, and builds the Embedding API v3 tableau-viz from the Tableau host; the screen never holds the secret.

Tableau Public のビジュアライゼーションは、接続なしのビュー (kind tableau、target.public_url。https://public.tableau.com/views/WORKBOOK/VIEW として再構築されます) で、rotate_sheets も使えます。Web ページ (kind web) の場合: Web 接続のサイトの 1 ページ (url: 公開ホスト上の https アドレス。target は指定しません)。

エッジのブラウザーが、サインインした状態でページを開き、設定されていれば wait_for の要素を待ち、wait_ms ミリ秒 (最大 10000) 待ってから、設定されていれば CSS セレクターの clip を、なければページ全体を描画します。

画像は refresh_s (60 〜 86400、デフォルトは 300) ごとに描き直され、同じサイズのすべてのスクリーンで共有されます。描画されるのは、スクリーンがそのビューを表示している間だけです。キャプチャが失敗した場合は、最後の画像がスクリーンに残ります。サインイン済みのときだけ存在する要素を wait_for に設定すると、サインインページが表示されることはありません。bi_view.created を追記します。

プロジェクトのCAPアラートトリガーを最も古いものから最大20件まで一覧表示します。各トリガーには取り込み用URL、ユーザー名、最新アラートが含まれます。パスワードはここでは決して返されません。

CAPアラートトリガーを作成します：緊急通知システム（Everbridge、Rave、Alertus、IPAWSリレーおよびその他のCAP 1.2送信者）がアラートを投稿する1つの受信URLで、HTTP Basic認証情報を使用します。

回答はパスワードが表示される唯一の場所です（回転回答と共に）：送信システムにすぐに保存してください。targetはタグ（アラート到着時にそれを持つすべてのアクティブスクリーン）または最大500のscreen_idsです。

アラートはデフォルトプレイリストを持つすべてのターゲットスクリーンに対し、アラートの<expires>まで、そうでなければdefault_for_seconds（60～604800、デフォルト3600）まで適用します。POST /api/triggers/{id}/cap.を参照してください。組織は、すべてのプロジェクトを合わせて最大20のトリガーを持ちます（trigger_limit_reached）。trigger.createdを追加します。

同じ Idempotency-Key での正確な再試行には、パスワードを含む同じ応答が24時間返されます。セレクターが保護されたスクリーンに及ぶトリガーは protected_target（409）で、スクリーン保護の読み取りに失敗した場合は dependency_unavailable（500、同じリクエストを再試行）です。トリガーは、スクリーンに限定された呼び出し元は利用できません。

耐久性のあるプロジェクトイベントをシーケンス順に一覧表示

ページングは連続しています：返されたnext_cursorをafterとして渡し、ページが停止した正確な位置から続行します。next_cursorは最後に返されたイベントのカーソルで、新しいイベントがすでに存在し、履歴の終わりではnullです。limitはデフォルト50で1〜200を受け入れ、それ以外はinvalid_requestでlimitを指定するerrors[]メンバーを返します。

オフセットページングはサポートされていません。source=logは代わりにPlayerログをリストします：条件レポートは受信時間昇順で(runtime.reported)、screen_idと重大度でフィルタし、期間はデフォルトで過去24時間、最大31日です。

カーソルは不透明です：サーバーがプレーヤーログを保持する場所によりlg1_またはev1_です。ページが返したものを返してください。別種のカーソルはinvalid_requestでフィールド名付きで拒否されます。プレーヤーログ記録はシーケンスを持たず、GET /stream/projectに含まれず、Webhookに配信されません。

レコードはPlayerログキューが受け入れ、プロジェクトのイベント保持に保存されると承認されます。最後のカーソルとデフォルトウィンドウでポーリングが続きます。Playerログレコードはデフォルト（source=project）リストには含まれません。fromとtoはsourceがlogでない限りinvalid_requestで拒否されます。

プロジェクトリストはscreen_id、playlist_id、application_idを受け取り、1つのスクリーン、プレイリスト、またはアプリケーションのイベントを読み取ります。すべて認証情報のプロジェクトにスコープされます（idはどのイベントを読むかを示し、誰のかは示しません）：screen_idはそのスクリーンをリソースとするイベント、playlist_idはそのプレイリストをリソースとするイベントとdetails.playlist_id（それを取るスクリーン）を名前に持つイベント、application_idはそのアプリケーションをリソースとするイベントとapplication_idをリソースに持つイベント（リリースやキー/バリューエントリ）です。

種類のIDでない値はフィールド名を指定して invalid_request で拒否されます。playlist_id と application_id は source=log で拒否されます。ログはスクリーンにのみ属します。

両方のソースは resource_id、type、severity（最低限）を取り、それらを組み合わせ、IDフィルターとページングと組み合わせます。Playerログレコードは、resource がそのスクリーンである runtime.reported レコードです。したがって、そのスクリーンでない resource_id または runtime.reported を除外する type は空のページを返します。before（または order=desc）は最新を先にページングし、next_cursor は返された最も古い項目のカーソルで、before として渡されるとより古い項目に進みます。

fromなしの最新優先source=logページはデフォルトの24時間を超え、プロジェクトのイベント保持が保持する最古記録まで遡ります。1リクエストあたり最大31日間。最新優先source=logページはlimit未満または0件のレコードを含み、next_cursorを持つことがあります。nullは保持ログの終わりで終了します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、フィルターされたフィードを読み取ります。対象は、スコープ内のスクリーンのイベント、見ることができるスクリーンフォルダー（自身のフォルダー、その上位と内側のフォルダー。screen.moved は移動先がスコープ内にある場合のみ）のイベント、キャンペーン、プレイリスト、メディア、アプリケーション、カードのイベント、および playlist_change レビューです。

それ以外のイベントはすべて除外されるため、ページに含まれるイベントは limit より少なくなることがあり、next_cursor があっても0件になることさえあります。next_cursor でページ送りを続けてください。source=log にはスコープ内の screen_id が必要です。プロジェクト自体に関するイベントは送信されません。

呼び出しプロジェクトのプラン、独立した広告主/画面フラグとそのリビジョン、派生した実効能力セット、持っているプラン機能（plan_features）、上限（limits）。クライアントの主張を反映せず、不明なプランは禁止として失敗します。

呼び出しプロジェクトのソース認識残高スナップショット。すべてのミリクレジット額は標準的な10進文字列です。これはスナップショットであり支払い権限ではありません；カード、税金、現金引き出しレールが利用不可の間は rails_available は false です。

呼び出しプロジェクトの不変の投稿済みジャーナルエントリーに対する安定したカーソルページネーション。保留は投稿済みエントリーではありません。修正は元のイベントへのリンクで書き換えません。この表面には任意の付与や支払いの変更はありません。

呼び出し元プロジェクトの 1 UTC か月間の使用状況。提供および受信したバイト（課金されることはありません）、支払者のプランの無料ストレージを超えて課金されるストレージ（allowance.storage_bytes）、ならびに月あたり無料の 10,000件にカウントされる API リクエスト、課金対象のプロジェクトストリームイベント、Webhook 配信の試行。自ら支払うプロジェクトは独自のプールを読み取ります。

別の支払者が支払うプロジェクトは、その支払者の他のプロジェクトとプールを共有します。自身のシェアを読み取り、payer は支払者を示します。支払者のプール合計は支払者の請求読み取りに残ります。

呼び出し元の販売者のネットワーク全体、解決された ScreenRig サービス料金を含みます。販売者はその料金を変更できません。

呼び出し元の販売者のネットワークが存在しない場合は作成します。screens=trueが必要です。冪等性あり。繰り返しは同じネットワークを返します。

販売者のプロジェクトデフォルトレートを15秒の完了再生ごとに設定します。変更が承認済みキャンペーンの実効レートを変えると、そのキャンペーン全体が price_change_pending で一時停止します。マスクされた変更や無操作変更は影響しません。If-Match はネットワーク改訂を保持します。

呼び出し元の販売者がオプトインした在庫です。

再利用可能な販売者スロットを作成します。画像は5～30秒、動画はプラットフォームの最大120秒です。広告は常にミュートされます。

呼び出し中の広告主が現在所属するネットワークと付与された範囲および審査ポリシー。スクリーン数は保証されたインプレッション数ではありません。

1つの準備済み所有メディアリビジョンを不変のクリエイティブにバインドします。バイトのコピー、再アップロード、再生成は行いません。未知または準備できていないメディアは拒否されます。

ドラフトキャンペーンを作成します。ドラフトは資金を保持せず、予約もせず、配信も許可しません。アクティベーションには明示的に承認された見積もりが必要です。

呼び出し元の販売者に提出されたクリエイティブバージョンのレビュー。販売者は提出された正確なクリエイティブのみを見て、購入者のライブラリは見ません。

購入者単位のキャンペーンの支出と配信数。金額は小数の mcr 文字列です。販売者の収入、銀行状況、プロジェクト全体の使用状況は公開されません。

販売者範囲の総額、サービス料、純額を1つのウィンドウで、その配信証拠付きで示します。購入者のウォレットや他のネットワークは決して公開しません。請求可能な配信は、認可された完了再生証拠のみで確立されます。ウィンドウは最大92日で、それを超えると invalid_request です。

5000件以上の決済がある場合、レスポンスは切り捨てを設定し、合計とカウントはすべてをカバーし、行は最も古い5000件のみをリストします。

毎日の再生集計。

JSONは最大200行を返し、レート制限はありません。format=csv（またはAccept text/csvでapplication/jsonなし）はday_fromからday_toまでの一致する行をすべてCSVでストリームし、固定ヘッダー行（PlaybackAggregateCsv）付きです。day_toはデフォルトで今日、day_fromは30日前、最大366日、それ以外はinvalid_requestです。CSV形式のみplayback-export-org（1分あたり30）とplayback-export-ip（1分あたり60）の予算を消費します。

どちらの形式も、計測される API リクエスト1回です。レスポンスには Vary Accept が付きます。スクリーンに限定された呼び出し元（docs/screen-scope.md）は screen_id を送信する必要があり、それはスコープ内のスクリーンでなければなりません（そうでない場合は outside_screen_scope）。CSV形式にも同じルールが適用されます。

再生ごとの記録：呼び出しプロジェクトの受理されたplayback.media_started（またはレガシーplayback.video_started）ごとに1行、受理されたplayback.application_started（release_idセット、メディアフィールドは空）ごとに1行、最古順にreceived_atで、同順位は挿入順。from（含む）とto（除く）はreceived_atを境界とし、toはデフォルトで現在、fromはtoの24時間前、範囲は最大31日（そうでなければinvalid_request）。

最新の5秒はまだ返されません：有効な終了時刻は最大で現在時刻から5秒引いたもの（遅延解消）です。ライブテイルはカーソルの後ろでコミットされた行をスキップしません。screen_id、media_id、playlist_id（開始が表示されたplaylist）、タグ（再生受信時のスクリーンタグ）でフィルターします。

playlist_idページは制限行数未満、またはゼロの場合もあります。長期間他のプレイリストの再生がスキャンされた場合はnext_cursor。nullは範囲の終了を示します。

JSONは最大limit行（デフォルト200、最大1000）のページでnext_cursorを持ち、範囲の終わりでnullです。同じフィルターでカーソルとして返してください。order=desc（またはbefore）は同じ範囲内で最新を先にページングし、next_cursorは返された最古行のカーソルで範囲の開始でnull、before（排他）として同じフィルターで返します。order=ascとbeforeはinvalid_requestでorder名付きで拒否され、最新優先ページのカーソルはcursor名付きで拒否されます。

最新順ページは、制限行数未満、またはゼロの場合もあり、next_cursor を含みます。null は終了を示します。

後のページは、前のページで存在した行をスキップせず、繰り返しもしません。ただし、未確認レポート後にPlayerが再送した開始（同じplay_id、直後に受信）は後のページに再度現れることがあります。CSVストリームは範囲のカーソルから末尾までのすべての再生をCSV（PlaybackPlayCsv）で新しい順にリストします。format=csv（またはapplication/jsonなしのAccept text/csv）はCSVでストリームし、limitは拒否されます。

メータリングはリクエストごとです：各 JSON ページは API リクエストクレジットを1つ消費し、範囲全体の CSV ストリームは1つ消費します。すべての再生リクエスト（ページまたはストリーム）は playback-export-org（1分あたり30）と playback-export-ip（1分あたり60）の予算を消費します。

ストリームは各書き込みを15秒で区切り、クライアント切断で終了します。200ヘッダー後に失敗すると接続は中止されるため、正常終了まで読み取ったエクスポートは完了です。レスポンスは Vary Accept を含みます。再生はプランのイベント保持期間（出荷時は30日、プランベースは7日または90日）で保持されます。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は screen_id を送信する必要があり、それはスコープ内のスクリーンでなければなりません（そうでない場合は outside_screen_scope）。CSV形式にも同じルールが適用されます。

呼び出しプロジェクトのUTC日単位の再生合計。日別集計から読み込み：by=dayは日ごと1行（screen_idまたはmedia_idで1スクリーンまたは1メディアに絞り込み）、by=screenとby=mediaは最も多いスクリーンまたはメディアをランク付け（最大100）、by=screen_dayはトップスクリーンの日系列（最大10）。day_toは今日（UTC）デフォルト、day_fromは29日前。

日系列は最大366日（スクリーンまたはメディアに絞ると92日）、ランキングは最大92です。カウントにはプレイロールアップが存在する前に記録された開始も含まれます。

ロールアップは取り込み後最大約21分遅れます。truncated が true の場合は、ウィンドウのスライスが1回の読み取りに大きすぎてランキングが構築されたことを示します：各スライスの最良キーをカバーします。レート制限なし。1回のメーター付きAPIリクエスト。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は screen_id を送信する必要があり、それはスコープ内のスクリーンでなければなりません（そうでない場合は outside_screen_scope）。CSV形式にも同じルールが適用されます。