API de Revisiones

Las revisiones del proyecto (docs/reviews.md): los cambios de listas de reproducción y de pantallas propuestos con acceso Proponer, las escrituras de campañas, carpetas de pantallas y movimientos que alcanzan una pantalla protegida (kind protected_change, docs/screen-scope.md) y, para una red publicitaria, las creatividades que enviaron los compradores (kind ad_creative).

Las más nuevas primero, como máximo límite (por defecto 50, máximo 100) por página; pase next_cursor como cursor con los mismos filtros. state pendiente (el predeterminado), decidido (cualquier otro estado) o todo; kind limita a un tipo.

Una sesión del panel lee todos los tipos; un portador lee los tipos que cubren sus capacidades (listas de reproducción para playlist_change, pantallas para screen_change y protected_change, publicidad para ad_creative), y un tipo que no puede leer es una página vacía. pending_count cuenta las revisiones pendientes de todos los tipos que ve el llamador.

Un llamador limitado a pantallas ve solo las revisiones screen_change y protected_change cuyo alcance completo está dentro del suyo (una revisión que selecciona pantallas por etiqueta nunca lo está) y las revisiones playlist_change; las revisiones ad_creative se le ocultan, y pending_count cuenta lo que ve.

Una revisión. Un cambio de lista de reproducción añade preview: la lista de reproducción en vivo y la propuesta en la forma guardada (pages con resolved_media); live es null para una creación. Un portador que no puede leer el tipo de la revisión (véase listReviews) recibe not_found, igual que un llamador limitado a pantallas para una revisión cuyo alcance no está dentro del suyo.

El proyecto al que pertenece una revisión, para el enlace de correo electrónico: una persona conectada que es miembro de ese proyecto obtiene su id y nombre y cambia a él (PUT /api/session/project) antes de leer la revisión. Cualquier otro recibe not_found. Funciona con cualquier proyecto que la sesión haya seleccionado.

Aprueba una revisión pendiente como persona que puede aprobar (el propietario del proyecto o un miembro con can_approve; de lo contrario approver_required). La bandera se lee de nuevo dentro de la transacción de decisión, así que una persona cuya aprobación fue desactivada mientras tanto no decide nada (approver_required). Las sesiones sombra del personal no pueden decidir.

Una actualización de lista de reproducción se aplica con la revisión base como If-Match; cuando la lista en vivo avanza, la revisión se vuelve obsoleta y la llamada responde review_stale.

Una creación o actualización cuyo tag, carpeta o todos los selectores ahora reproducirían medios que no resolvieron cuando se propusieron, que la revisión no nombra y que la versión en vivo aún no reproduce, también se vuelve obsoleta (review_stale).

Un cambio de pantalla reproduce su solicitud almacenada (una etiqueta se resuelve ahora): la llamada aplica pantallas por unos segundos y el resto continúa en segundo plano mientras screen_change.result.applying es verdadero.

Un cambio de pantalla esperando una revisión pendiente de lista de reproducción responde review_blocked nombrándola; uno cuya lista de reproducción no tiene versión aprobada responde playlist_not_approved. include_dependents también aprueba, en orden, los cambios de pantalla que esperan esta revisión de lista de reproducción. Los eventos del cambio aplicado llevan a la persona como actor y al agente que propone como agente.

La respuesta incluye warnings (PlaylistWarning): screen_fact_missing cuando el cambio aprobado pone en pantallas que no lo tienen páginas cuyo src de iframe o params de aplicación leen un token de pantalla. Una revisión decidida es review_not_pending; repetir la misma decisión la reproduce.

Una revisión marcada como protegida (una protected_change, o una screen_change que alcanzó una pantalla protegida) la decide un aprobador distinto del proponente y de la persona responsable del agente proponente: de lo contrario second_approver_required (403), y también cuando no se puede rastrear al proponente hasta una persona (docs/screen-scope.md).

Un aprobador limitado a pantallas decide solo una revisión cuyo alcance completo está dentro del suyo (outside_screen_scope, 403). Esta solicitud aplica una protected_change, como la persona que aprueba, en la revisión contra la que se propuso; una campaña o carpeta que cambió o desapareció desde entonces, o pantallas que se movieron, dejan la revisión obsoleta (review_stale, 409).

Un dependiente que no se puede aprobar informa los mismos códigos en dependents[].problem.

Rechaza una revisión pendiente con una razón que lee el proponente. Solo aprobador, igual que approveReview; un aprobador limitado a pantallas decide solo una revisión dentro de su alcance (outside_screen_scope), y ninguna persona limitada a pantallas decide una creatividad publicitaria. No cambia nada en pantalla; una creación de lista de reproducción rechazada sigue sin aprobar.

Pide cambios al proponente con una nota que este lee; el proponente propone de nuevo. Solo aprobador, igual que approveReview. Para una creatividad publicitaria, el comprador lee la nota en la creatividad. Un aprobador con alcance está limitado como en rejectReview.

Retira una revisión pendiente de lista de reproducción, de pantalla o protected_change. Un portador retira solo lo que propuso su propio agente o cliente de servicio (de lo contrario forbidden); una persona retira como aprobador o como persona responsable del proponente; una persona limitada a pantallas retira solo una revisión dentro de su alcance (outside_screen_scope).

Una creación de lista de reproducción retirada sigue sin aprobar.