Enumerar elementos secundarios de la pila de versiones

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.version_stacks.index(
    account_id="a17fe10b-3d45-4fad-b695-fa92651520ec",
    version_stack_id="bbdfd455-6868-4519-b43c-11485e8e9ee3",
    include="media_links.original",
)

{
  "data": [
    {
      "type": "file",
      "created_at": "2023-09-25T19:18:29.614189Z",
      "file_size": 1137444,
      "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
      "media_type": "image/png",
      "name": "asset.png",
      "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
      "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
      "status": "created",
      "updated_at": "2024-02-07T16:44:41.986478Z",
      "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
      "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "adobe_version_id": "2",
      "creator": {
        "active": true,
        "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
        "email": "user_email@example.com",
        "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
        "name": "Jon Doe"
      },
      "media_links": {
        "high_quality": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN"
        },
        "original": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "inline_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=inline%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragSDFXDFh&1Key-Pair-Id=KKI497NESTHMN"
        },
        "thumbnail": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "url": "https://picture2.frame.io/image/s3://frameio-assets-development/image/cd58cb8e-24b3-4498-8d0f-9532fcd04d11/image_full.png?alg=HS256&sig=0_u7w_wz2MwQHOXp000ibbQSMRijujyaUu8V3YYPxu4&exp=1729857600"
        }
      },
      "metadata": [
        {
          "field_type": "select",
          "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
          "field_definition_name": "Fields definition name",
          "mutable": true,
          "value": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            }
          ],
          "field_options": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            },
            {
              "display_name": "Display name 2",
              "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
            }
          ]
        }
      ],
      "project": {
        "created_at": "2024-01-25T19:18:29.614189Z",
        "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
        "name": "My Project",
        "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
        "status": "active",
        "storage": 15000,
        "updated_at": "2024-02-07T16:44:41.986478Z",
        "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
        "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
        "description": "Project Description",
        "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
        "restricted": false,
        "owner": {
          "active": true,
          "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "email": "user_email@example.com",
          "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
          "name": "Jon Doe"
        }
      }
    }
  ],
  "links": {
    "next": "/v4/accounts/123/folders/123/version_stacks"
  },
  "total_count": 10
}

Enumere los elementos secundarios (archivos) de una pila de versiones determinada.

Utilice el parámetro de consulta include para incluir de forma selectiva propiedades adicionales en la respuesta.

Nota: Si se incluye media_links.original y el usuario no tiene permiso para descargar archivos en el proyecto correspondiente, este punto final responderá con un error 403 Forbidden. Si no se puede acceder al contenido porque este usuario requiere marcas de agua y no es compatible con los media_links solicitados, la solicitud se completará correctamente, pero los vínculos de medios no compatibles se establecerán en el valor null. Del mismo modo, si un vínculo de transcodificación solicitado no existe para un archivo concreto (por ejemplo, al incluir media_links.video_h264_180 en un archivo de imagen estática) o el proceso de transcodificación no ha finalizado (es decir, el status del archivo es “cargado” en lugar de “transcodificado”), el vínculo de medios también se establecerá en el valor null en la carga útil de la respuesta. En resumen, el cliente debe gestionar correctamente los vínculos de medios con el valor null.
Límites de frecuencia: 100 llamadas por 1,00 minutos por account_user

Enumere los elementos secundarios (archivos) de una pila de versiones determinada. <br/> Utilice el parámetro de consulta `include` para incluir de forma selectiva propiedades adicionales en la respuesta. <br/> Nota: Si se incluye `media_links.original` y el usuario no tiene permiso para descargar archivos en el proyecto correspondiente, este punto final responderá con un error `403 Forbidden`. Si no se puede acceder al contenido porque este usuario requiere marcas de agua y no es compatible con los media_links solicitados, la solicitud se completará correctamente, pero los vínculos de medios no compatibles se establecerán en el valor null. Del mismo modo, si un vínculo de transcodificación solicitado no existe para un archivo concreto (por ejemplo, al incluir `media_links.video_h264_180` en un archivo de imagen estática) o el proceso de transcodificación no ha finalizado (es decir, el `status` del archivo es "cargado" en lugar de "transcodificado"), el vínculo de medios también se establecerá en el valor null en la carga útil de la respuesta. En resumen, el cliente debe gestionar correctamente los vínculos de medios con el valor null. <br/>Límites de frecuencia: 100 llamadas por 1,00 minutos por account_user

Autenticación

AuthorizationBearer

Autenticación de portador de la forma Bearer <token>, donde token es tu token de autenticación.

Parámetros de ruta

account_idstringRequerido

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo adobe: (por ejemplo, adobe:<adobe_org_id>para una cuenta,adobe:<adobe_asset_id>para un proyecto o una carpeta,adobe:adobe:<adobe_asset_id>|<version> para un activo de archivo).

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo `adobe:` (por ejemplo, adobe:<adobe_org_id>` para una cuenta, `adobe:<adobe_asset_id>` para un proyecto o una carpeta, `adobe:`adobe:<adobe_asset_id>|<version>` para un activo de archivo).

version_stack_idstringRequerido

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo `adobe:` (por ejemplo, adobe:<adobe_org_id>` para una cuenta, `adobe:<adobe_asset_id>` para un proyecto o una carpeta, `adobe:`adobe:<adobe_asset_id>|<version>` para un activo de archivo).

Parámetros de consulta

includeenumOpcional

Compatibilidad con los valores del parámetro de consulta Include para puntos finales que devuelven archivos con vínculos de medios

afterstringOpcional

Parámetro de consulta Opaque Cursor para solicitudes que devuelven resultados paginados.

NOTA: Este valor se genera automáticamente y se incluye como parte de los vínculos de una respuesta anterior. No está diseñado para que sea legible por las personas.

page_sizeintegerOpcional1-100Valor predeterminado: 50

Parámetro de consulta Page size para solicitudes

include_total_countbooleanOpcionalValor predeterminado: false

Parámetro de consulta Page para incluir el recuento de todas las entidades

Encabezados de respuesta

x-ratelimit-limitinteger

Límite de frecuencia

x-ratelimit-remaininginteger

Límite de frecuencia restante

x-ratelimit-windowinteger

Periodo de límite de frecuencia en milisegundos

Respuesta

Aceptar

datalist of objects

Activos

linksobject

Vínculos a datos paginados

total_countinteger or nullOpcional

Recuento total

Errores

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Enumere los elementos secundarios (archivos) de una pila de versiones determinada.

Utilice el parámetro de consulta include para incluir de forma selectiva propiedades adicionales en la respuesta.