폴더 하위 항목 나열 | 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
}

지정된 폴더의 하위 항목을 나열합니다.

include 쿼리 매개변수를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다.

참고: media_links.original을 포함했는데 사용자가 해당 프로젝트에서 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 403 Forbidden 오류를 반환합니다. 사용자에게 워터마킹이 필요하지만 요청된 media_links에서 지원되지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청한 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 media_links.video_h264_180 포함), 트랜스코딩 프로세스가 완료되지 않은 경우 (즉, 파일의 status가 “transcoded”가 아닌 “uploaded”인 경우), 미디어 링크는 응답 페이로드에서 null로 설정됩니다. 즉, 클라이언트는 null 미디어 링크를 적절히 처리해야 합니다.
요청 제한: account_user당 1.00분당 100회 호출

지정된 폴더의 하위 항목을 나열합니다. <br/> `include` 쿼리 매개변수를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다. <br/> 참고: `media_links.original`을 포함했는데 사용자가 해당 프로젝트에서 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 `403 Forbidden` 오류를 반환합니다. 사용자에게 워터마킹이 필요하지만 요청된 media_links에서 지원되지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청한 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 `media_links.video_h264_180` 포함), 트랜스코딩 프로세스가 완료되지 않은 경우 (즉, 파일의 `status`가 "transcoded"가 아닌 "uploaded"인 경우), 미디어 링크는 응답 페이로드에서 null로 설정됩니다. 즉, 클라이언트는 null 미디어 링크를 적절히 처리해야 합니다. <br/>요청 제한: account_user당 1.00분당 100회 호출

인증

AuthorizationBearer

Bearer <token> 형식의 Bearer 인증. 여기서 token은 인증 토큰입니다.

경로 매개변수

account_idstring필수

Frame.io 또는 Adobe 엔터티 식별자입니다. 일반적으로 Frame.IO UUID입니다. 그러나 Workfront에 연결된 계정 및 프로젝트의 경우 Adobe 클라우드 스토리지에 상주하는 계정, 프로젝트, 폴더, 파일 및 버전 스택의 경우 Adobe에서 할당한 ID를 서로 바꿔 사용할 수도 있습니다. 이러한 ID는 접두사로 adobe:(예: 계정의 경우 adobe:<adobe_org_id>, 프로젝트나 폴더의 경우 adobe:<adobe_asset_id>, 파일 에셋의 경우 adobe:adobe:<adobe_asset_id>|<version>`)를 붙여야 합니다.

Frame.io 또는 Adobe 엔터티 식별자입니다. 일반적으로 Frame.IO UUID입니다. 그러나 Workfront에 연결된 계정 및 프로젝트의 경우 Adobe 클라우드 스토리지에 상주하는 계정, 프로젝트, 폴더, 파일 및 버전 스택의 경우 Adobe에서 할당한 ID를 서로 바꿔 사용할 수도 있습니다. 이러한 ID는 접두사로 `adobe:`(예: 계정의 경우 `adobe:<adobe_org_id>`, 프로젝트나 폴더의 경우 `adobe:<adobe_asset_id>`, 파일 에셋의 경우 `adobe:`adobe:<adobe_asset_id>|<version>`)를 붙여야 합니다.

folder_idstring필수

쿼리 매개변수

includeenum선택 사항

미디어 링크가 포함된 파일을 반환하는 엔드포인트에서 지원되는 include 쿼리 매개변수 값

typestring선택 사항

폴더 하위 항목 유형 필터

afterstring선택 사항

페이지네이션 결과를 반환하는 요청에 사용되는 불투명 커서 쿼리 매개변수입니다.

참고: 이 값은 자동으로 생성되어 이전 응답 링크의 일부로 포함됩니다. 사람이 직접 읽을 수 있도록 고안된 값은 아닙니다.

page_sizeinteger선택 사항1-500기본값 50

에셋 목록 요청의 페이지 크기 쿼리 매개변수

include_total_countboolean선택 사항기본값 false

모든 엔터티 개수를 포함하기 위한 페이지 쿼리 매개변수

응답 헤더

x-ratelimit-limitinteger

요청 제한

x-ratelimit-remaininginteger

남은 요청 제한

x-ratelimit-windowinteger

요청 제한 기간(밀리초)

응답

확인

datalist of objects

정보

linksobject

페이지네이션된 데이터 링크

total_countinteger or null선택 사항

총 개수

오류

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

지정된 폴더의 하위 항목을 나열합니다.

include 쿼리 매개변수를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다.