Listar tarefas derivadas da pasta | Frame.io API Documentation

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.folders.index(
    account_id="5c77ab31-41ee-432a-8013-5ec57eb95e6b",
    folder_id="2cf94114-e51a-44d7-809f-3582226192a1",
    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/folders"
  },
  "total_count": 10
}

Liste as tarefas derivadas na pasta especificada.

Use o parâmetro de consulta include para incluir seletivamente propriedades adicionais na resposta.

Observação: se você incluir media_links.original e o usuário não tiver permissão para baixar arquivos no projeto correspondente, este ponto de acesso responderá com um erro 403 Forbidden. Se o conteúdo estiver inacessível porque a marca d’água é obrigatória para esse usuário e não for compatível com os media_links solicitados, a solicitação será bem-sucedida, mas os links de mídia não compatíveis serão definidos como null. Da mesma forma, se um link de transcodificação solicitado não existir para um determinado arquivo (por exemplo, incluir media_links.video_h264_180 em um arquivo de imagem estática) ou se o processo de transcodificação ainda não tiver sido concluído (ou seja, o status do arquivo for “uploaded” em vez de “transcoded”), o link de mídia também será definido como null no conteúdo da resposta. Em resumo, o cliente deve tratar corretamente os links de mídia com valor null.
Limites de taxa: 100 chamadas por 1,00 minuto por account_user

Liste as tarefas derivadas na pasta especificada. <br/> Use o parâmetro de consulta include para incluir seletivamente propriedades adicionais na resposta. <br/> Observação: se você incluir media_links.original e o usuário não tiver permissão para baixar arquivos no projeto correspondente, este ponto de acesso responderá com um erro 403 Forbidden. Se o conteúdo estiver inacessível porque a marca d'água é obrigatória para esse usuário e não for compatível com os media_links solicitados, a solicitação será bem-sucedida, mas os links de mídia não compatíveis serão definidos como null. Da mesma forma, se um link de transcodificação solicitado não existir para um determinado arquivo (por exemplo, incluir media_links.video_h264_180 em um arquivo de imagem estática) ou se o processo de transcodificação ainda não tiver sido concluído (ou seja, o status do arquivo for "uploaded" em vez de "transcoded"), o link de mídia também será definido como null no conteúdo da resposta. Em resumo, o cliente deve tratar corretamente os links de mídia com valor null. <br/>Limites de taxa: 100 chamadas por 1,00 minuto por account_user

Autenticação

AuthorizationBearer

Autenticação bearer na forma Bearer <token>, onde token é seu token de autenticação.

Parâmetros de caminho

account_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com adobe: (por exemplo, adobe:<adobe_org_id> para uma conta, adobe:<adobe_asset_id> para um projeto ou pasta e adobe:<adobe_asset_id>|<version> para um arquivo).

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

folder_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

Parâmetros de consulta

includeenumOpcional

Valores compatíveis do parâmetro de consulta include para pontos de acesso que retornam arquivos com links de mídia

typestringOpcional

Filtro de tipo para tarefas derivadas da pasta

afterstringOpcional

Parâmetro de consulta Cursor opaco para solicitações que retornam resultados paginados.
OBSERVAÇÃO: este valor é gerado automaticamente e incluído como parte dos links de uma resposta anterior. Ele não foi projetado para ser legível por humanos.

page_sizeintegerOpcional1-500Padrão é 50

Parâmetro de consulta de tamanho da página para solicitações de lista de ativos

include_total_countbooleanOpcionalPadrão é false

Parâmetro de consulta de página para incluir a contagem de todas as entidades

Cabeçalhos de resposta

x-ratelimit-limitinteger

Limite de taxa

x-ratelimit-remaininginteger

Limite de taxa restante

x-ratelimit-windowinteger

Janela do limite de taxa em milissegundos

Resposta

datalist of objects

Ativos

linksobject

Links para dados paginados

total_countinteger or nullOpcional

Contagem total

Erros

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

Liste as tarefas derivadas na pasta especificada.

Use o parâmetro de consulta include para incluir seletivamente propriedades adicionais na resposta.