Python SDK 참조

설치

$pip install frameio

사용량

다음을 사용하여 클라이언트를 인스턴스화하고 사용합니다.

1from frameio import (
2 Frameio,
3 SelectDefinitionParamsFieldConfiguration,
4 SelectDefinitionParamsFieldConfigurationOptionsItem,
5)
6from frameio.metadata_fields import CreateFieldDefinitionParamsData_Select
7
8client = Frameio(
9 token="YOUR_TOKEN",
10)
11client.metadata_fields.metadata_field_definitions_create(
12 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 data=CreateFieldDefinitionParamsData_Select(
14 field_configuration=SelectDefinitionParamsFieldConfiguration(
15 enable_add_new=False,
16 options=[
17 SelectDefinitionParamsFieldConfigurationOptionsItem(
18 display_name="Option 1",
19 ),
20 SelectDefinitionParamsFieldConfigurationOptionsItem(
21 display_name="Option 2",
22 ),
23 ],
24 ),
25 name="Fields definition name",
26 ),
27)

비동기 클라이언트

또한 SDK는 API에 비차단 호출을 할 수 있도록 비동기 클라이언트도 함께 내보냅니다. 이 클라이언트에 전달할 Async httpx 클라이언트 클래스를 구성하는 경우(예: 이 클라이언트의 httpx_client 매개변수에 대해), httpx.Client() 대신 httpx.AsyncClient()를 사용해야 한다는 점에 유의하세요.

1import asyncio
2
3from frameio import (
4 AsyncFrameio,
5 SelectDefinitionParamsFieldConfiguration,
6 SelectDefinitionParamsFieldConfigurationOptionsItem,
7)
8from frameio.metadata_fields import CreateFieldDefinitionParamsData_Select
9
10client = AsyncFrameio(
11 token="YOUR_TOKEN",
12)
13
14
15async def main() -> None:
16 await client.metadata_fields.metadata_field_definitions_create(
17 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
18 data=CreateFieldDefinitionParamsData_Select(
19 field_configuration=SelectDefinitionParamsFieldConfiguration(
20 enable_add_new=False,
21 options=[
22 SelectDefinitionParamsFieldConfigurationOptionsItem(
23 display_name="Option 1",
24 ),
25 SelectDefinitionParamsFieldConfigurationOptionsItem(
26 display_name="Option 2",
27 ),
28 ],
29 ),
30 name="Fields definition name",
31 ),
32 )
33
34
35asyncio.run(main())

예외 처리

API가 실패 상태 코드(4xx 또는 5xx 응답)를 반환하면 다음 오류의 하위 클래스가 발생합니다.

1from frameio.core.api_error import ApiError
2
3try:
4 client.metadata_fields.metadata_field_definitions_create(...)
5except ApiError as e:
6 print(e.status_code)
7 print(e.body)

페이지 매김

페이지가 매겨진 요청은 SyncPager 또는 AsyncPager를 반환하며, 이는 기본 오브젝트에 대한 제너레이터로 사용할 수 있습니다.

1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.project_permissions.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 page_size=10,
10 include_total_count=False,
11)
12for item in response:
13 yield item
14# alternatively, you can paginate page-by-page
15for page in response.iter_pages():
16 yield page

고급

원시 응답 데이터에 액세스하기

SDK는 .with_raw_response 속성을 통해 헤더를 포함한 원시 응답 데이터에 대한 액세스를 제공합니다. .with_raw_response 속성은 .headers 및 .data 속성에 액세스하는 데 사용할 수 있는 “원시” 클라이언트를 반환합니다.

1from frameio import Frameio
2
3client = Frameio(
4 ...,
5)
6response = (
7 client.metadata_fields.with_raw_response.metadata_field_definitions_create(
8 ...
9 )
10)
11print(response.headers) # access the response headers
12print(response.data) # access the underlying object
13pager = client.project_permissions.index(...)
14print(pager.response.headers) # access the response headers for the first page
15for item in pager:
16 print(item) # access the underlying object(s)
17for page in pager.iter_pages():
18 print(page.response.headers) # access the response headers for each page
19 for item in page:
20 print(item) # access the underlying object(s)

재시도

SDK에는 지수 백오프 방식의 자동 재시도 기능이 구현되어 있습니다. 요청이 재시도 가능한 것으로 간주되고, 재시도 횟수가 구성된 재시도 제한(기본값: 2)을 초과하지 않는 한 요청이 재시도됩니다.

다음 HTTP 상태 코드 중 하나가 반환될 때 요청은 재시도 가능한 것으로 간주됩니다.

  • 408(시간 초과)
  • 429(너무 많은 요청)
  • 5XX(내부 서버 오류)


이 동작을 구성하려면 max_retries 요청 옵션을 사용하세요.

1client.metadata_fields.metadata_field_definitions_create(..., request_options={
2 "max_retries": 1
3})

시간 초과

SDK는 기본적으로 60초의 시간 초과 값을 사용합니다. 클라이언트 또는 요청 수준에서 timeout 옵션을 사용하여 이를 구성할 수 있습니다.

1from frameio import Frameio
2
3client = Frameio(
4 ...,
5 timeout=20.0,
6)
7
8
9# Override timeout for a specific method
10client.metadata_fields.metadata_field_definitions_create(..., request_options={
11 "timeout_in_seconds": 1
12})

사용자 지정 클라이언트

httpx 클라이언트를 재정의하여 특정 사용 사례에 맞게 사용자 지정할 수 있습니다. 일부 일반적인 사용 사례로는 프록시 및 전송 지원 등이 있습니다.

1import httpx
2from frameio import Frameio
3
4client = Frameio(
5 ...,
6 httpx_client=httpx.Client(
7 proxy="http://my.test.proxy.example.com",
8 transport=httpx.HTTPTransport(local_address="0.0.0.0"),
9 ),
10)

참조

계정 권한

지정된 계정의 사용자 역할을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.account_permissions.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 include_deactivated=True,
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12)
13for item in response:
14 yield item
15# alternatively, you can paginate page-by-page
16for page in response.iter_pages():
17 yield page

매개변수

account_id: Uuid —

include_deactivated: typing.Optional[bool] — 비활성화된 사용자를 응답에 포함하도록 지원합니다. 기본값은 false입니다.

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정

현재 사용자의 계정을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.accounts.index(
7 after="<opaque_cursor>",
8 page_size=10,
9 include_total_count=False,
10)
11for item in response:
12 yield item
13# alternatively, you can paginate page-by-page
14for page in response.iter_pages():
15 yield page

매개변수

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

쿼리 매개변수를 통해 필터링 기능을 사용하여 감사 로그를 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.accounts.auditlog_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 include="user",
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12 api_version="4.0",
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid

api_version: typing.Literal["4.0"]

include: typing.Optional[typing.Literal["user"]]

filters: typing.Optional[Filters]

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

인증

OAuth 2.0의 client_credentials 권한 부여를 사용하여 인증합니다. 이 흐름에는 사용자가 관여하지 않으며 새로 고침 토큰도 반환되지 않습니다. 액세스 토큰이 만료되면 SDK가 클라이언트 자격 증명을 사용하여 새 토큰을 자동으로 요청합니다. 비동기 사용 시에는 AsyncServerToServerAuth를 사용합니다.

usage
1from frameio import Frameio
2from frameio.auth import ServerToServerAuth
3
4auth = ServerToServerAuth(client_id="YOUR_CLIENT_ID", client_secret="YOUR_CLIENT_SECRET")
5client = Frameio(token=auth.get_token)

매개변수

client_id: str — Adobe IMS OAuth 클라이언트 ID입니다.

client_secret: str — Adobe IMS OAuth 클라이언트 시크릿입니다.

scopes: str — 공백으로 구분된 권한 목록입니다(OAuth 2.0 RFC 6749). 기본값은 openid AdobeID frame.s2s.all입니다.

ims_base_url: str — 스테이징 및 대안 환경을 위한 IMS 기본 URL입니다. 기본값은 프로덕션입니다.

http_client: typing.Optional[httpx.Client] — 선택 사항인 httpx입니다.프록시, TLS, 또는 연결 풀링을 위한 클라이언트입니다.

on_token_refreshed: typing.Optional[typing.Callable[[dict[str, Any]], None]] — 토큰을 가져올 때마다 실행되는 선택적 콜백입니다.

timeout: float — HTTP 요청 시간 초과(초 단위)입니다. 기본값은 30입니다.

max_retries: int — 일시적인 오류 발생 시 최대 재시도 횟수입니다. 기본값은 2입니다.

refresh_buffer: int — 사전 새로 고침을 트리거하기 위한 만료 전 초 단위 시간입니다. 기본값은 60입니다. 메서드get_token() -&gt; str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조(호출이 아님)를 SDK에 전달합니다. Frameio(token=auth.get_token). authenticate() -&gt; dict[str, Any] — 새 액세스 토큰을 명시적으로 가져옵니다. access_token, expires_in 등이 포함된 토큰 응답 사전을 반환합니다. revoke() -&gt; None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -&gt; dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -&gt; None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.

OAuth 2.0 authorization_code 권한 부여를 사용하여 인증합니다. 클라이언트 시크릿을 안전하게 저장할 수 있는 서버 측 애플리케이션에 이 방식을 사용하세요. 비동기 사용 시에는 AsyncWebAppAuth를 사용합니다.

usage
1import secrets
2from frameio import Frameio
3from frameio.auth import WebAppAuth
4
5auth = WebAppAuth(
6 client_id="YOUR_CLIENT_ID",
7 client_secret="YOUR_CLIENT_SECRET",
8 redirect_uri="https://myapp.com/callback",
9)
10url = auth.get_authorization_url(state=secrets.token_urlsafe(32))
11# redirect user to url ...
12auth.exchange_code(code="CODE_FROM_CALLBACK")
13client = Frameio(token=auth.get_token)

매개변수

client_id: str — Adobe IMS OAuth 클라이언트 ID입니다.

client_secret: str — Adobe IMS OAuth 클라이언트 시크릿입니다.

redirect_uri: str — 등록된 리디렉션 URI입니다.

scopes: str — 공백으로 구분된 권한 목록입니다(OAuth 2.0 RFC 6749).

ims_base_url: str — 스테이징 및 대안 환경을 위한 IMS 기본 URL입니다. 기본값은 프로덕션입니다.

http_client: typing.Optional[httpx.Client] — 선택 사항인 httpx입니다.프록시, TLS, 또는 연결 풀링을 위한 클라이언트입니다.

on_token_refreshed: typing.Optional[typing.Callable[[dict[str, Any]], None]] — 토큰 새로 고침 후마다 실행되는 선택적 콜백입니다.

timeout: float — HTTP 요청 시간 초과(초 단위)입니다. 기본값은 30입니다.

max_retries: int — 일시적인 오류 발생 시 최대 재시도 횟수입니다. 기본값은 2입니다.

refresh_buffer: int — 사전 새로 고침을 트리거하기 위한 만료 전 초 단위 시간입니다. 기본값은 60입니다. 메서드get_token() -&gt; str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조를 SDK에 전달합니다: Frameio(token=auth.get_token). get_authorization_url(state: str) -&gt; str — Adobe IMS 인증 URL을 빌드합니다. 반환될 불투명한 CSRF/상태 값을 전달합니다. exchange_code(code: str) -&gt; dict[str, Any] — 권한 부여 코드를 액세스 및 새로 고침 토큰으로 교환합니다. refresh() -&gt; dict[str, Any] — 수동으로 토큰 새로 고침을 트리거합니다. revoke() -&gt; None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -&gt; dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -&gt; None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.

authorization_code + PKCE(클라이언트 시크릿 없음)를 사용하여 인증합니다. 클라이언트 시크릿을 안전하게 저장할 수 없는 브라우저 기반 앱이나 네이티브 앱에 이 방식을 사용하세요. 비동기(async) 사용 시에는 AsyncSPAAuth를 사용합니다.

usage
1import secrets
2from frameio import Frameio
3from frameio.auth import SPAAuth
4
5auth = SPAAuth(client_id="YOUR_CLIENT_ID", redirect_uri="https://myapp.com/cb")
6result = auth.get_authorization_url(state=secrets.token_urlsafe(32))
7# redirect user to result.url, store result.code_verifier
8auth.exchange_code(code="CODE_FROM_CALLBACK", code_verifier=result.code_verifier)
9client = Frameio(token=auth.get_token)

매개변수

client_id: str — Adobe IMS OAuth 클라이언트 ID입니다.

redirect_uri: str — 등록된 리디렉션 URI입니다.

scopes: str — 공백으로 구분된 권한 목록입니다(OAuth 2.0 RFC 6749).

ims_base_url: str — 스테이징 및 대안 환경을 위한 IMS 기본 URL입니다. 기본값은 프로덕션입니다.

http_client: typing.Optional[httpx.Client] — 선택 사항인 httpx입니다.프록시, TLS, 또는 연결 풀링을 위한 클라이언트입니다.

on_token_refreshed: typing.Optional[typing.Callable[[dict[str, Any]], None]] — 토큰 새로 고침 후마다 실행되는 선택적 콜백입니다.

timeout: float — HTTP 요청 시간 초과(초 단위)입니다. 기본값은 30입니다.

max_retries: int — 일시적인 오류 발생 시 최대 재시도 횟수입니다. 기본값은 2입니다.

refresh_buffer: int — 사전 새로 고침을 트리거하기 위한 만료 전 초 단위 시간입니다. 기본값은 60입니다. 메서드get_token() -&gt; str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조를 SDK에 전달합니다: Frameio(token=auth.get_token). get_authorization_url(state: str) -&gt; AuthorizationUrlResult — PKCE 챌린지를 사용하여 Adobe IMS 인증 URL을 빌드합니다. urlcode_verifier 속성을 포함하는 AuthorizationUrlResult를 반환합니다. exchange_code(code: str, code_verifier: str) -&gt; dict[str, Any] — 권한 부여 코드 + PKCE 검증자(verifier)를 토큰으로 교환합니다. refresh() -&gt; dict[str, Any] — 수동으로 토큰 새로 고침을 트리거합니다. revoke() -&gt; None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -&gt; dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -&gt; None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.

SPAAuth.get_authorization_url()AsyncSPAAuth.get_authorization_url()에서 반환하는 고정 데이터 클래스(dataclass)입니다. 인증 URL 및 PKCE 코드 검증자를 보관합니다. 속성url: str — 사용자를 리디렉션할 전체 인증 URL입니다. code_verifier: str — 저장해 두었다가 exchange_code()에 전달할 PKCE 코드 검증자입니다.

인증 모듈에서 사용하는 모듈 수준 HTTP 클라이언트를 닫습니다. 애플리케이션 종료 시 연결을 해제하려면 동기 코드에서는 close_clients()를 호출하고, 비동기 코드에서는 await aclose_clients()를 호출합니다.

usage
1from frameio.auth import close_clients
2
3# During application shutdown
4close_clients()

인증 예외

모든 인증 예외는 FrameioAuthError에서 상속됩니다.

예외설명
FrameioAuthError모든 frameio.auth 오류에 대한 기본 예외입니다.
AuthenticationError토큰 교환 또는 새로 고침에 실패했습니다. error_codeerror_description 속성이 있습니다.
TokenExpiredError새로 고침 토큰이 만료되었습니다. 재인증이 필요합니다.
ConfigurationError필수 구성이 누락되었거나 유효하지 않습니다.
NetworkError네트워크 요청에 실패했습니다(시간 초과, 연결 오류 등).
RateLimitErrorAPI가 429를 반환했으며 재시도 횟수가 소진되었습니다. retry_after 속성이 있습니다.
PKCEErrorPKCE 확인에 실패했습니다.

컬렉션

프로젝트의 컬렉션 나열.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.collections.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator,project",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid

project_id: Uuid

include: typing.Optional[CollectionInclude]

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

컬렉션 세부 정보 표시.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.collections.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 collection_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator,project",
10)

매개변수

account_id: Uuid

collection_id: Uuid

include: typing.Optional[CollectionInclude]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

코멘트

파일의 단일 코멘트를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.comments.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 comment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="owner",
10)

매개변수

account_id: Uuid —

comment_id: Uuid —

include: typing.Optional[CommentsShowRequestInclude] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

에셋에서 코멘트를 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.comments.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 comment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

comment_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 에셋에 대한 코멘트를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.comments import UpdateCommentParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.comments.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 comment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 timestamp_as_timecode=True,
11 data=UpdateCommentParamsData(
12 annotation='[{"tool":"rect","color":"#F22237","size":8,"x":0.277726001863933,"y":0.12909555568499534,"w":0.3153168321877913,"h":0.5308131407269339,"ix":0.277726001863933,"iy":0.12909555568499534,"radius":8}]',
13 completed=False,
14 page=4,
15 text="This is great!",
16 ),
17)

매개변수

account_id: Uuid —

comment_id: Uuid —

data: UpdateCommentParamsData

timestamp_as_timecode: typing.Optional[bool] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 에셋에 대한 코멘트를 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.comments.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="owner",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid —

file_id: Uuid —

include: typing.Optional[CommentInclude] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일에 코멘트를 생성합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2from frameio.comments import CreateCommentParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.comments.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 timestamp_as_timecode=True,
11 data=CreateCommentParamsData(
12 annotation='[{"tool":"rect","color":"#F22237","size":8,"x":0.277726001863933,"y":0.12909555568499534,"w":0.3153168321877913,"h":0.5308131407269339,"ix":0.277726001863933,"iy":0.12909555568499534,"radius":8}]',
13 completed=False,
14 page=4,
15 text="This is great!",
16 timestamp="00:00:02:12",
17 ),
18)

매개변수

account_id: Uuid —

file_id: Uuid —

data: CreateCommentParamsData

timestamp_as_timecode: typing.Optional[bool] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

기존 코멘트의 첨부 파일 생성.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import AttachmentInput, Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.comments.create_attachment(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 comment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 data=AttachmentInput(
10 file_size=1024000,
11 media_type="image/png",
12 name="screenshot.png",
13 ),
14)

매개변수

account_id: Uuid

comment_id: Uuid

data: AttachmentInput

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

코멘트에서 첨부 파일 삭제.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.comments.delete_attachment(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 comment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 attachment_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10)

매개변수

account_id: Uuid

comment_id: Uuid

attachment_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자 지정 작업

지정된 작업 영역의 작업 나열.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.custom_actions.actions_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid

workspace_id: Uuid

include: typing.Optional[typing.Literal["creator"]]

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자 지정 작업의 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.custom_actions.actions_show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 action_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator",
10)

매개변수

account_id: Uuid

action_id: Uuid

include: typing.Optional[typing.Literal["creator"]]

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

작업 영역에 사용자 지정 작업을 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.custom_actions import ActionCreateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.custom_actions.actions_create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=ActionCreateParamsData(
11 description="customizing our workflow",
12 event="my.event",
13 name="First Custom Action",
14 timeout=7,
15 url="https://example.com/custom-action",
16 ),
17)

매개변수

account_id: Uuid

workspace_id: Uuid

data: ActionCreateParamsData

request_options: typing.Optional[RequestOptions] — Request-specific configuration.

사용자 지정 작업의 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.custom_actions import ActionUpdateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.custom_actions.actions_update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 action_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=ActionUpdateParamsData(
11 active=True,
12 description="customizing our workflow",
13 event="my.event",
14 multi_asset=True,
15 name="First Custom Action",
16 timeout=7,
17 url="https://example.com/custom-action",
18 ),
19)

매개변수

account_id: Uuid

action_id: Uuid

data: ActionUpdateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자 지정 작업을 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.custom_actions.actions_delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 action_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

action_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

Files

지정된 폴더에 있는 파일을 나열합니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.files.list(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid

folder_id: Uuid

include: typing.Optional[FileWithMediaLinksInclude]

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

상위 폴더 아래에 새 파일을 만듭니다. 파일 생성(로컬 업로드)파일 생성(원격 업로드)이 이 엔드포인트를 대체했습니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2from frameio.files import FileCreateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileCreateParamsData(
11 file_size=1137444,
12 media_type="image/png",
13 name="asset.png",
14 ),
15)

매개변수

account_id: Uuid

folder_id: Uuid

data: FileCreateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일 세부 정보를 표시합니다.

응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.

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

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.files.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10)

매개변수

account_id: Uuid

file_id: Uuid

include: typing.Optional[FileWithMediaLinksInclude]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

ID로 파일을 삭제합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.files.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

file_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2from frameio.files import FileUpdateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileUpdateParamsData(
11 name="asset.png",
12 ),
13)

매개변수

account_id: Uuid

file_id: Uuid

data: FileUpdateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일을 복사합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2from frameio.files import FileCopyParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.copy(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 copy_metadata=True,
11 copy_comments="none",
12 data=FileCopyParamsData(
13 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
14 ),
15)

매개변수

account_id: Uuid

file_id: Uuid

copy_metadata: typing.Optional[bool] — Whether to copy metadata values along with the file

copy_comments: typing.Optional[FilesCopyRequestCopyComments] — Which comments to copy along with the file

data: typing.Optional[FileCopyParamsData]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

원격 업로드를 통해 상위 폴더 아래에 새 파일을 생성합니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2from frameio.files import FileCreateRemoteUploadParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.create_remote_upload(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileCreateRemoteUploadParamsData(
11 name="asset.png",
12 source_url="https://upload.wikimedia.org/wikipedia/commons/e/e1/White_Pixel_1x1.png",
13 ),
14)

매개변수

account_id: Uuid

folder_id: Uuid

data: FileCreateRemoteUploadParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일을 폴더 또는 version_stack으로 이동합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2from frameio.files import FileMoveParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.move(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileMoveParamsData(
11 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
12 ),
13)

매개변수

account_id: Uuid

file_id: Uuid

data: FileMoveParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

로컬 업로드를 통해 상위 폴더 아래에 새 파일을 생성합니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2from frameio.files import FileCreateLocalUploadParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.create_local_upload(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileCreateLocalUploadParamsData(
11 file_size=1137444,
12 name="asset.png",
13 ),
14)

매개변수

account_id: Uuid

folder_id: Uuid

data: FileCreateLocalUploadParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일 업로드 상태 세부 정보를 표시합니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.files.show_file_upload_status(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

file_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정에 구성된 저장 위치에서 파일을 가져옵니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2from frameio.files import FileImportParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.files.import_file(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FileImportParamsData(
11 key="uploads/08091b0f-a541-42f5-a059-5e8c4afecc12/original.png",
12 name="asset.png",
13 storage_location="123e4567-e89b-12d3-a456-426614174000",
14 ),
15)

매개변수

account_id: Uuid

folder_id: Uuid

data: FileImportParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

폴더 권한

지정된 폴더의 사용자 역할을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folder_permissions.folder_user_roles_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include_deactivated=True,
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid

folder_id: Uuid

include_deactivated: typing.Optional[bool] — 비활성화된 사용자를 응답에 포함하도록 지원합니다. 기본값은 false입니다.

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자가 이미 폴더에 추가된 경우 지정된 폴더의 사용자 역할을 업데이트합니다. 사용자가 폴더에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio, UpdateUserRolesParamsData
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folder_permissions.folder_user_roles_update(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=UpdateUserRolesParamsData(
11 role="editor",
12 ),
13)

매개변수

account_id: Uuid

folder_id: Uuid

user_id: Uuid

data: UpdateUserRolesParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 폴더에서 사용자를 제거합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folder_permissions.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10)

매개변수

account_id: Uuid

folder_id: Uuid

user_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

폴더

폴더 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folders.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator",
10)

매개변수

account_id: Uuid —

folder_id: Uuid —

include: typing.Optional[AssetInclude] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

ID로 폴더를 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folders.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

folder_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

폴더 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.folders import FolderUpdateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.folders.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FolderUpdateParamsData(
11 name="Folder name",
12 ),
13)

매개변수

account_id: Uuid —

folder_id: Uuid —

data: FolderUpdateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

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

응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.

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

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folders.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10 type="file,folder,version_stack",
11 after="<opaque_cursor>",
12 page_size=10,
13 include_total_count=False,
14)

매개변수

account_id: Uuid —

folder_id: Uuid —

include: typing.Optional[FileWithMediaLinksInclude] —

type: typing.Optional[ChildrenType] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

폴더를 복사합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.folders import FolderCopyParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.folders.copy(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 copy_metadata=True,
11 data=FolderCopyParamsData(
12 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
13 ),
14)

매개변수

account_id: Uuid —

folder_id: Uuid —

copy_metadata: typing.Optional[bool] — Whether to copy metadata values along with the folder

data: typing.Optional[FolderCopyParamsData]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

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

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.folders.list(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid —

folder_id: Uuid —

include: typing.Optional[AssetInclude] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

제공된 folder_id 경로 매개변수 내에 새 폴더를 생성합니다.

속도 제한: account_user당 1초당 3회 호출

usage
1from frameio import Frameio
2from frameio.folders import FolderCreateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.folders.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FolderCreateParamsData(
11 name="Folder name",
12 ),
13)

매개변수

account_id: Uuid —

folder_id: Uuid —

data: FolderCreateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

폴더를 다른 폴더로 이동합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.folders import FolderMoveParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.folders.move(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=FolderMoveParamsData(
11 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
12 ),
13)

매개변수

account_id: Uuid —

folder_id: Uuid —

data: FolderMoveParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

그룹

계정의 그룹을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.groups.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 include="creator",
9 sort="creator_asc",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid

include: typing.Optional[typing.Literal["creator"]]

sort: typing.Optional[GroupsIndexRequestSort] — 쿼리 매개변수after로 그룹 정렬: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

그룹 세부 정보 표시.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.groups.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 group_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="creator",
10)

매개변수

account_id: Uuid

group_id: Uuid

include: typing.Optional[typing.Literal["creator"]]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

현재 계정의 그룹을 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.groups import CreateGroupParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.groups.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 data=CreateGroupParamsData(
10 emoji="smile",
11 name="group-1",
12 ),
13)

매개변수

account_id: Uuid

data: CreateGroupParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

그룹 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.groups import UpdateGroupParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.groups.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 group_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=UpdateGroupParamsData(
11 emoji="smile",
12 name="group-1",
13 ),
14)

매개변수

account_id: Uuid

group_id: Uuid

data: UpdateGroupParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

메타데이터

여러 파일에 걸쳐 메타데이터 값을 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.metadata import (
3 BulkUpdateMetadataParamsData,
4 BulkUpdateMetadataParamsDataValuesItem,
5)
6
7client = Frameio(
8 token="YOUR_TOKEN",
9)
10client.metadata.bulk_update(
11 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
12 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 data=BulkUpdateMetadataParamsData(
14 file_ids=[
15 "09b31c2a-04de-464a-a593-643a36ef0d98",
16 "b967fc36-4e18-4b48-a3ab-c790100e2baa",
17 ],
18 values=[
19 BulkUpdateMetadataParamsDataValuesItem(
20 field_definition_id="ff41ce50-269b-4624-8306-aac10e28ab94",
21 value=[
22 {
23 "id": "e60f47b4-cf8e-4273-96d5-3258a830a0aa",
24 "type": "user",
25 },
26 {
27 "id": "24eeaf7e-ce27-4555-bc77-cce39900626d",
28 "type": "account_user_group",
29 },
30 ],
31 )
32 ],
33 ),
34)

매개변수

account_id: Uuid

project_id: Uuid

data: BulkUpdateMetadataParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

파일의 메타데이터를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.metadata.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 file_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 show_null=True,
10)

매개변수

account_id: Uuid

file_id: Uuid

show_null: typing.Optional[bool]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

메타데이터 필드

계정 수준의 사용자 지정 필드 정의를 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.metadata_fields.metadata_field_definitions_delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 field_definition_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

field_definition_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정 수준의 사용자 지정 필드 정의를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import (
2 Frameio,
3 UpdateSelectDefinitionParamsFieldConfiguration,
4 UpdateSelectDefinitionParamsFieldConfigurationOptionsItem,
5)
6from frameio.metadata_fields import UpdateFieldDefinitionParamsData_Select
7
8client = Frameio(
9 token="YOUR_TOKEN",
10)
11client.metadata_fields.metadata_field_definitions_update(
12 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 field_definition_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
14 data=UpdateFieldDefinitionParamsData_Select(
15 field_configuration=UpdateSelectDefinitionParamsFieldConfiguration(
16 enable_add_new=False,
17 options=[
18 UpdateSelectDefinitionParamsFieldConfigurationOptionsItem(
19 display_name="Option 1",
20 ),
21 UpdateSelectDefinitionParamsFieldConfigurationOptionsItem(
22 display_name="Option 2",
23 ),
24 ],
25 ),
26 name="Updated-Field-Name",
27 ),
28)

매개변수

account_id: Uuid —

field_definition_id: Uuid —

data: typing.Optional[UpdateFieldDefinitionParamsData]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정 수준의 필드 정의를 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.metadata_fields.metadata_field_definitions_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 after="<opaque_cursor>",
9 page_size=10,
10 include_total_count=False,
11)

매개변수

account_id: Uuid —

include: typing.Optional[typing.Literal[“creator”]] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정 수준의 필드 정의를 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import (
2 Frameio,
3 SelectDefinitionParamsFieldConfiguration,
4 SelectDefinitionParamsFieldConfigurationOptionsItem,
5)
6from frameio.metadata_fields import CreateFieldDefinitionParamsData_Select
7
8client = Frameio(
9 token="YOUR_TOKEN",
10)
11client.metadata_fields.metadata_field_definitions_create(
12 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 data=CreateFieldDefinitionParamsData_Select(
14 field_configuration=SelectDefinitionParamsFieldConfiguration(
15 enable_add_new=False,
16 options=[
17 SelectDefinitionParamsFieldConfigurationOptionsItem(
18 display_name="Option 1",
19 ),
20 SelectDefinitionParamsFieldConfigurationOptionsItem(
21 display_name="Option 2",
22 ),
23 ],
24 ),
25 name="Fields definition name",
26 ),
27)

매개변수

account_id: Uuid —

data: typing.Optional[CreateFieldDefinitionParamsData]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

프로젝트 권한

지정된 프로젝트에 대한 사용자 역할을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.project_permissions.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include_deactivated=True,
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid —

project_id: Uuid —

include_deactivated: typing.Optional[bool] — 비활성화된 사용자를 응답에 포함하도록 지원합니다. 기본값은 false입니다.

after: typing.Optional[RequestAfterOpaqueCursor]

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

참고: 이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 프로젝트에서 사용자를 제거합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.project_permissions.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10)

매개변수

account_id: Uuid —

project_id: Uuid —

user_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자가 이미 프로젝트에 추가된 경우 지정된 프로젝트에 대한 사용자 역할을 업데이트합니다. 사용자가 프로젝트에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio, UpdateUserRolesParamsData
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.project_permissions.project_user_roles_update(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=UpdateUserRolesParamsData(
11 role="editor",
12 ),
13)

매개변수

account_id: Uuid —

project_id: Uuid —

user_id: Uuid —

data: UpdateUserRolesParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

프로젝트

프로젝트 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.projects.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

project_id: Uuid

include: typing.Optional[typing.Literal["owner"]]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

프로젝트를 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.projects.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

project_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

프로젝트 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.projects import ProjectUpdateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.projects.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=ProjectUpdateParamsData(
11 name="Project Name",
12 restricted=True,
13 status="active",
14 ),
15)

매개변수

account_id: Uuid

project_id: Uuid

data: ProjectUpdateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 작업 영역의 프로젝트를 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.projects.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12)
13for item in response:
14 yield item
15# alternatively, you can paginate page-by-page
16for page in response.iter_pages():
17 yield page

매개변수

account_id: Uuid

workspace_id: Uuid

include: typing.Optional[typing.Literal["owner"]]

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 작업 영역에 프로젝트를 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.projects import ProjectParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.projects.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=ProjectParamsData(
11 name="Project Name",
12 restricted=True,
13 ),
14)

매개변수

account_id: Uuid

workspace_id: Uuid

data: ProjectParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

인증된 사용자가 지정된 계정 내에서 액세스할 수 있는 모든 프로젝트 나열.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.projects.account_projects_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 include="owner",
9 sort="name_asc",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid

include: typing.Optional[typing.Literal["owner"]]

sort: typing.Optional[AccountProjectsIndexRequestSort] — Sort projects by query params

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 계정 내에서 현재 사용자가 초대되었지만 작업 영역 레벨 액세스 권한은 없는 프로젝트를 나열합니다. 사용자가 팀/작업 영역 권한 없이 프로젝트별 공동 작업자 액세스 권한을 갖는 프로젝트입니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.projects.invited_projects_index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 include="owner",
9 sort="name_asc",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid

include: typing.Optional[typing.Literal["owner"]]

sort: typing.Optional[InvitedProjectsIndexRequestSort] — Sort projects by query params

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

검색

계정 내의 에셋, 폴더, 프로젝트를 검색합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2from frameio.search import SearchParamsFilters
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.search.search(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 engine="nlp",
10 query="red car driving on highway",
11 filters=SearchParamsFilters(
12 files_and_version_stacks=True,
13 folders=False,
14 projects=False,
15 ),
16 after="<opaque_cursor>",
17 page_size=10,
18 include_total_count=False,
19)

매개변수

account_id: Uuid

engine: SearchParamsEngine — 사용할 검색 엔진입니다. 사용 가능한 엔진: lexical, nlp. 쿼리: str — 검색 쿼리 텍스트

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

filters: typing.Optional[SearchParamsFilters] — 반환되는 결과 유형을 제어하는 필터

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

공유

단일 공유를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.shares.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

share_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

공유를 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.shares.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid

share_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

공유를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1import datetime
2
3from frameio import Frameio
4from frameio.shares import UpdateShareParamsData
5
6client = Frameio(
7 token="YOUR_TOKEN",
8)
9client.shares.update(
10 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
11 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
12 data=UpdateShareParamsData(
13 access="public",
14 description="A descriptive summary of the share",
15 downloading_enabled=True,
16 expiration=datetime.datetime.fromisoformat(
17 "2026-01-22 17:04:53+00:00",
18 ),
19 name="Share Name",
20 passphrase="as!dfj39sd(*",
21 ),
22)

매개변수

account_id: Uuid

share_id: Uuid

data: UpdateShareParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

공유 검토자를 나열합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.shares.list_reviewers(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12)
13for item in response:
14 yield item
15# alternatively, you can paginate page-by-page
16for page in response.iter_pages():
17 yield page

매개변수

account_id: Uuid

share_id: Uuid

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

다음 세 가지 식별자 유형을 사용하여 보안 공유에 검토자를 추가합니다. adobe_user_id, email, user_id.

요청에는 식별자 유형 매개변수가 하나만 포함될 수 있습니다.

email은 공유가 속한 계정에 Frame 계정 멤버가 없는 경우에도 해당 공유에 검토자를 추가할 수 있는 유일한 식별자입니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.shares import (
3 AddReviewersToShareParamsData,
4 AddReviewersToShareParamsDataReviewers,
5)
6
7client = Frameio(
8 token="YOUR_TOKEN",
9)
10client.shares.add_reviewers(
11 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
12 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 data=AddReviewersToShareParamsData(
14 message="Please join my share!",
15 reviewers=AddReviewersToShareParamsDataReviewers(
16 emails=["email1@domain.com", "email2@domain.com"],
17 ),
18 ),
19)

매개변수

account_id: Uuid

share_id: Uuid

data: AddReviewersToShareParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

다음 세 가지 식별자 유형을 사용하여 보안 공유에서 검토자를 제거합니다. adobe_user_id, email, user_id.

요청에는 식별자 유형 매개변수가 하나만 포함될 수 있습니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.shares import (
3 RemoveReviewerParamsData,
4 RemoveReviewerParamsDataReviewers,
5)
6
7client = Frameio(
8 token="YOUR_TOKEN",
9)
10client.shares.remove_reviewers(
11 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
12 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
13 data=RemoveReviewerParamsData(
14 reviewers=RemoveReviewerParamsDataReviewers(
15 adobe_user_ids=[
16 "2A3C1A3D66C621B20A494021@176719f5667c82b4499999.e"
17 ],
18 ),
19 ),
20)

매개변수

account_id: Uuid

share_id: Uuid

data: RemoveReviewerParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

현재 공유 내에 있는 에셋을 해당 공유에서 제거합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.shares.remove_asset(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 asset_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10)

매개변수

account_id: Uuid

share_id: Uuid

asset_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

새로운 에셋을 공유에 추가합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.shares import AddAssetParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.shares.add_asset(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 share_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=AddAssetParamsData(
11 asset_id="0cc1cb59-1d7c-4176-8532-afe099897318",
12 ),
13)

매개변수

account_id: Uuid

share_id: Uuid

data: AddAssetParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

프로젝트의 공유를 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.shares.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12)
13for item in response:
14 yield item
15# alternatively, you can paginate page-by-page
16for page in response.iter_pages():
17 yield page

매개변수

account_id: Uuid

project_id: Uuid

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

공유를 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1import datetime
2
3from frameio import Frameio
4from frameio.shares import CreateShareParamsData_Asset
5
6client = Frameio(
7 token="YOUR_TOKEN",
8)
9client.shares.create(
10 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
11 project_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
12 data=CreateShareParamsData_Asset(
13 access="public",
14 asset_ids=[
15 "12eb1446-5736-4f93-85fc-3b636f156211",
16 "f23a3b3e-7b1f-4655-b91a-acf0566e5bb9",
17 ],
18 downloading_enabled=True,
19 expiration=datetime.datetime.fromisoformat(
20 "2026-01-22 17:04:53+00:00",
21 ),
22 name="Share Name",
23 passphrase="as!dfj39sd(*",
24 ),
25)

매개변수

account_id: Uuid

project_id: Uuid

data: CreateShareParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

업로드

client.files.create_local_upload(…)가 반환한 사전 서명된 URL을 사용하여 로컬 파일을 Frame.io에 업로드합니다. FrameioUploaderFileWithUploadUrls 응답에서 upload_urls, file_size, media_type을 읽고 청크 분할된 다중 스레드 S3 업로드를 수행하는 얇은 래퍼입니다.

usage
1from frameio import Frameio
2from frameio.files import FileCreateLocalUploadParamsData
3from frameio.upload import FrameioUploader
4
5client = Frameio(
6 token="YOUR_TOKEN",
7)
8response = client.files.create_local_upload(
9 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
11 data=FileCreateLocalUploadParamsData(
12 file_size=1137444,
13 name="asset.png",
14 ),
15)
16with open("asset.png", "rb") as f:
17 FrameioUploader(response.data, f).upload()

매개변수

asset: FileWithUploadUrlsclient.files.create_local_upload(…)에서 반환된 FileWithUploadUrls 인스턴스입니다.

file: typing.BinaryIO — 바이너리 읽기 모드("rb")로 열린 파일과 같은 오브젝트입니다.

max_workers: int — 기본 업로더에 패스스루되는 스레드 풀 동시성입니다. 기본값은 5입니다.

headers: typing.Optional[typing.Dict[str, str]] — 모든 S3 PUT 요청에 병합되는 추가 헤더입니다. Frame.io에서 요구하는 {"x-amz-acl": "private"}가 기본값입니다.

max_retries: int — 청크당 재시도 횟수입니다. 기본값은 3입니다.

on_progress: typing.Optional[typing.Callable[[int, int], None]] — 각 청크 후에 (bytes_uploaded_so_far, total_bytes)와 함께 호출되는 선택적 콜백입니다. 메서드 upload() -&gt; None — 파일을 업로드합니다. 완료될 때까지 차단되거나 오류 시 예외를 발생시킵니다.

사용자

베어러 토큰과 연결된 사용자의 세부 정보를 확인합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.users.show()

매개변수

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

버전 스택

지정된 버전 스택의 하위 항목(파일)들을 나열합니다.

응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.

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

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.version_stacks.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 version_stack_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid —

version_stack_id: Uuid —

include: typing.Optional[FileWithMediaLinksInclude] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

버전 스택의 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.version_stacks.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 version_stack_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10)

매개변수

account_id: Uuid —

version_stack_id: Uuid —

include: typing.Optional[VersionStacksShowRequestInclude] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

버전 스택을 복사합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.version_stacks import VersionStackCopyParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.version_stacks.copy(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 version_stack_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 copy_metadata=True,
11 data=VersionStackCopyParamsData(
12 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
13 ),
14)

매개변수

account_id: Uuid —

version_stack_id: Uuid —

copy_metadata: typing.Optional[bool] — Whether to copy metadata values along with the version stack

data: typing.Optional[VersionStackCopyParamsData]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 폴더의 버전 스택을 나열합니다.

속도 제한: account_user당 1초당 5회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.version_stacks.list(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include="media_links",
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)

매개변수

account_id: Uuid —

folder_id: Uuid —

include: typing.Optional[FileWithMediaLinksInclude] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

상위 폴더 아래에 새 버전 스택을 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.version_stacks import VersionStackCreateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.version_stacks.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 folder_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=VersionStackCreateParamsData(
11 file_ids=[
12 "dd2a3cdd-fc90-41bd-a7b8-8a0447aec6d4",
13 "79fed48a-8372-496e-8dcb-5e959b9b9fcf",
14 ],
15 ),
16)

매개변수

account_id: Uuid —

folder_id: Uuid —

data: VersionStackCreateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

버전 스택을 다른 폴더로 이동합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.version_stacks import VersionStackMoveParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.version_stacks.move(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 version_stack_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=VersionStackMoveParamsData(
11 parent_id="2e426fe0-f965-4594-8b2b-b4dff1dc00ec",
12 ),
13)

매개변수

account_id: Uuid —

version_stack_id: Uuid —

data: VersionStackMoveParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

Webhook

지정된 작업 영역의 웹훅을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.webhooks.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 after="<opaque_cursor>",
10 page_size=10,
11 include_total_count=False,
12)
13for item in response:
14 yield item
15# alternatively, you can paginate page-by-page
16for page in response.iter_pages():
17 yield page

매개변수

account_id: Uuid —

workspace_id: Uuid —

include: typing.Optional[typing.Literal[“creator”]] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

시크릿이 포함된 단일 웹훅을 생성합니다.

유효한 이벤트:

file.created, file.deleted, file.ready, file.updated, file.upload.completed, file.versioned, file.copied, folder.created, folder.deleted, folder.updated, folder.copied, comment.completed, comment.created, comment.deleted, comment.uncompleted, comment.updated, customfield.created, customfield.updated, customfield.deleted, metadata.value.updated, project.created, project.deleted, project.updated, collection.created, collection.updated, collection.deleted, share.created, share.updated, share.deleted, share.viewed.

요청 제한: 계정당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.webhooks import WebhookCreateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.webhooks.create(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=WebhookCreateParamsData(
11 events=[
12 "file.created",
13 "file.deleted",
14 "file.ready",
15 "file.updated",
16 "file.upload.completed",
17 "file.versioned",
18 "file.copied",
19 "folder.created",
20 "folder.deleted",
21 "folder.updated",
22 "folder.copied",
23 "comment.completed",
24 "comment.created",
25 "comment.deleted",
26 "comment.uncompleted",
27 "comment.updated",
28 "customfield.created",
29 "customfield.updated",
30 "customfield.deleted",
31 "metadata.value.updated",
32 "project.created",
33 "project.deleted",
34 "project.updated",
35 "collection.created",
36 "collection.updated",
37 "collection.deleted",
38 "share.created",
39 "share.updated",
40 "share.deleted",
41 "share.viewed",
42 ],
43 name="New Webhook",
44 url="https://url.example.com",
45 ),
46)

매개변수

account_id: Uuid —

workspace_id: Uuid —

data: WebhookCreateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

웹훅 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.webhooks.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 webhook_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

webhook_id: Uuid —

include: typing.Optional[typing.Literal[“creator”]] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

웹훅을 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.webhooks.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 webhook_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

webhook_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

웹훅 세부 정보를 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio
2from frameio.webhooks import WebhookUpdateParamsData
3
4client = Frameio(
5 token="YOUR_TOKEN",
6)
7client.webhooks.update(
8 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 webhook_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=WebhookUpdateParamsData(
11 active=True,
12 events=[
13 "file.created",
14 "file.deleted",
15 "file.ready",
16 "file.updated",
17 "file.upload.completed",
18 "file.versioned",
19 "file.copied",
20 "folder.created",
21 "folder.deleted",
22 "folder.updated",
23 "folder.copied",
24 "comment.completed",
25 "comment.created",
26 "comment.deleted",
27 "comment.uncompleted",
28 "comment.updated",
29 "customfield.created",
30 "customfield.updated",
31 "customfield.deleted",
32 "metadata.value.updated",
33 "project.created",
34 "project.deleted",
35 "project.updated",
36 "collection.created",
37 "collection.updated",
38 "collection.deleted",
39 "share.created",
40 "share.updated",
41 "share.deleted",
42 "share.viewed",
43 ],
44 name="Updated Webhook",
45 url="https://url.example.com",
46 ),
47)

매개변수

account_id: Uuid —

webhook_id: Uuid —

data: WebhookUpdateParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

작업 공간 권한

지정된 작업 영역의 사용자 역할을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.workspace_permissions.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 include_deactivated=True,
10 after="<opaque_cursor>",
11 page_size=10,
12 include_total_count=False,
13)
14for item in response:
15 yield item
16# alternatively, you can paginate page-by-page
17for page in response.iter_pages():
18 yield page

매개변수

account_id: Uuid

workspace_id: Uuid

includ_deactivated: typing.Optional[bool] — 비활성화된 사용자를 응답에 포함하도록 지원합니다. 기본값은 false입니다.

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize]

include_total_count: typing.Optional[IncludeTotalCount]

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 작업 영역에서 사용자를 제거합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspace_permissions.workspace_user_roles_delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10)

매개변수

account_id: Uuid

workspace_id: Uuid

user_id: Uuid

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

사용자가 이미 작업 영역에 추가된 경우 지정된 작업 영역에 대한 사용자 역할을 업데이트합니다. 사용자가 작업 영역에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio, UpdateUserRolesParamsData
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspace_permissions.workspace_user_roles_update(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 user_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
10 data=UpdateUserRolesParamsData(
11 role="editor",
12 ),
13)

매개변수

account_id: Uuid

workspace_id: Uuid

user_id: Uuid

data: UpdateUserRolesParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

Workspaces

작업 영역 세부 정보를 표시합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspaces.show(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

workspace_id: Uuid —

include: typing.Optional[typing.Literal[“creator”]] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정에서 작업 영역을 삭제합니다.

요청 제한: account_user당 1.00분당 60회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspaces.delete(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9)

매개변수

account_id: Uuid —

workspace_id: Uuid —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

작업 영역을 업데이트합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio, WorkspaceParamsData
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspaces.update(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 workspace_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
9 data=WorkspaceParamsData(
10 name="My Workspace",
11 ),
12)

매개변수

account_id: Uuid —

workspace_id: Uuid —

data: WorkspaceParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

지정된 계정의 작업 영역을 나열합니다.

요청 제한: account_user당 1.00분당 100회 호출

usage
1from frameio import Frameio
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6response = client.workspaces.index(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 after="<opaque_cursor>",
9 page_size=10,
10 include_total_count=False,
11)
12for item in response:
13 yield item
14# alternatively, you can paginate page-by-page
15for page in response.iter_pages():
16 yield page

매개변수

account_id: Uuid —

workspace_id: Uuid —

include: typing.Optional[typing.Literal[“owner”]] —

after: typing.Optional[RequestAfterOpaqueCursor]

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

이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.

page_size: typing.Optional[RequestPageSize] —

include_total_count: typing.Optional[IncludeTotalCount] —

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.

계정에서 작업 영역을 생성합니다.

요청 제한: account_user당 1.00분당 10회 호출

usage
1from frameio import Frameio, WorkspaceParamsData
2
3client = Frameio(
4 token="YOUR_TOKEN",
5)
6client.workspaces.create(
7 account_id="b2702c44-c6da-4bb6-8bbd-be6e547ccf1b",
8 data=WorkspaceParamsData(
9 name="My Workspace",
10 ),
11)

매개변수

account_id: Uuid —

data: WorkspaceParamsData

request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.


PyPI

PyPI에서 보기