Python SDK 참조
Python SDK 참조
설치
사용량
다음을 사용하여 클라이언트를 인스턴스화하고 사용합니다.
비동기 클라이언트
또한 SDK는 API에 비차단 호출을 할 수 있도록 비동기 클라이언트도 함께 내보냅니다. 이 클라이언트에 전달할 Async httpx 클라이언트 클래스를 구성하는 경우(예: 이 클라이언트의 httpx_client 매개변수에 대해), httpx.Client() 대신 httpx.AsyncClient()를 사용해야 한다는 점에 유의하세요.
예외 처리
API가 실패 상태 코드(4xx 또는 5xx 응답)를 반환하면 다음 오류의 하위 클래스가 발생합니다.
페이지 매김
페이지가 매겨진 요청은 SyncPager 또는 AsyncPager를 반환하며, 이는 기본 오브젝트에 대한 제너레이터로 사용할 수 있습니다.
고급
원시 응답 데이터에 액세스하기
SDK는 .with_raw_response 속성을 통해 헤더를 포함한 원시 응답 데이터에 대한 액세스를 제공합니다. .with_raw_response 속성은 .headers 및 .data 속성에 액세스하는 데 사용할 수 있는 “원시” 클라이언트를 반환합니다.
재시도
SDK에는 지수 백오프 방식의 자동 재시도 기능이 구현되어 있습니다. 요청이 재시도 가능한 것으로 간주되고, 재시도 횟수가 구성된 재시도 제한(기본값: 2)을 초과하지 않는 한 요청이 재시도됩니다.
다음 HTTP 상태 코드 중 하나가 반환될 때 요청은 재시도 가능한 것으로 간주됩니다.
- 408(시간 초과)
- 429(너무 많은 요청)
- 5XX(내부 서버 오류)
이 동작을 구성하려면 max_retries 요청 옵션을 사용하세요.
시간 초과
SDK는 기본적으로 60초의 시간 초과 값을 사용합니다. 클라이언트 또는 요청 수준에서 timeout 옵션을 사용하여 이를 구성할 수 있습니다.
사용자 지정 클라이언트
httpx 클라이언트를 재정의하여 특정 사용 사례에 맞게 사용자 지정할 수 있습니다. 일부 일반적인 사용 사례로는 프록시 및 전송 지원 등이 있습니다.
참조
계정 권한
client.account_permissions.index(...) -> AsyncPager[AccountUserRole, AccountUserRolesResponse]
지정된 계정의 사용자 역할을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
계정
client.accounts.index(...) -> AsyncPager[Account, AccountsResponse]
현재 사용자의 계정을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
after: typing.Optional[RequestAfterOpaqueCursor]
페이지가 매겨진 결과를 반환하는 요청에 사용되는 불투명한 커서 쿼리 매개변수입니다.
이 값은 자동으로 생성되며 이전 응답에서 링크의 일부로 포함됩니다. 사람이 읽을 수 있는 형태로 설계되지 않았습니다.
page_size: typing.Optional[RequestPageSize] —
include_total_count: typing.Optional[IncludeTotalCount] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.accounts.auditlog_index(...) -> AsyncPager[AuditLog, AuditLogsWithIncludesResponse]
쿼리 매개변수를 통해 필터링 기능을 사용하여 감사 로그를 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
인증
frameio.auth.ServerToServerAuth(*, client_id, client_secret, …)
OAuth 2.0의 client_credentials 권한 부여를 사용하여 인증합니다. 이 흐름에는 사용자가 관여하지 않으며 새로 고침 토큰도 반환되지 않습니다. 액세스 토큰이 만료되면 SDK가 클라이언트 자격 증명을 사용하여 새 토큰을 자동으로 요청합니다. 비동기 사용 시에는 AsyncServerToServerAuth를 사용합니다.
매개변수
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() -> str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조(호출이 아님)를 SDK에 전달합니다. Frameio(token=auth.get_token). authenticate() -> dict[str, Any] — 새 액세스 토큰을 명시적으로 가져옵니다. access_token, expires_in 등이 포함된 토큰 응답 사전을 반환합니다. revoke() -> None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -> dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -> None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.
frameio.auth.WebAppAuth(*, client_id, client_secret, redirect_uri, …)
OAuth 2.0 authorization_code 권한 부여를 사용하여 인증합니다. 클라이언트 시크릿을 안전하게 저장할 수 있는 서버 측 애플리케이션에 이 방식을 사용하세요. 비동기 사용 시에는 AsyncWebAppAuth를 사용합니다.
매개변수
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() -> str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조를 SDK에 전달합니다: Frameio(token=auth.get_token). get_authorization_url(state: str) -> str — Adobe IMS 인증 URL을 빌드합니다. 반환될 불투명한 CSRF/상태 값을 전달합니다. exchange_code(code: str) -> dict[str, Any] — 권한 부여 코드를 액세스 및 새로 고침 토큰으로 교환합니다. refresh() -> dict[str, Any] — 수동으로 토큰 새로 고침을 트리거합니다. revoke() -> None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -> dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -> None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.
frameio.auth.SPAAuth(*, client_id, redirect_uri, …)
authorization_code + PKCE(클라이언트 시크릿 없음)를 사용하여 인증합니다. 클라이언트 시크릿을 안전하게 저장할 수 없는 브라우저 기반 앱이나 네이티브 앱에 이 방식을 사용하세요. 비동기(async) 사용 시에는 AsyncSPAAuth를 사용합니다.
매개변수
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() -> str — 필요한 경우 새로 고침을 수행하며 유효한 액세스 토큰을 반환합니다. 이 메서드에 대한 참조를 SDK에 전달합니다: Frameio(token=auth.get_token). get_authorization_url(state: str) -> AuthorizationUrlResult — PKCE 챌린지를 사용하여 Adobe IMS 인증 URL을 빌드합니다. url 및 code_verifier 속성을 포함하는 AuthorizationUrlResult를 반환합니다. exchange_code(code: str, code_verifier: str) -> dict[str, Any] — 권한 부여 코드 + PKCE 검증자(verifier)를 토큰으로 교환합니다. refresh() -> dict[str, Any] — 수동으로 토큰 새로 고침을 트리거합니다. revoke() -> None — 서버 측에서 두 토큰 모두를 취소하고 로컬 상태를 지웁니다. export_tokens() -> dict[str, Any] — 지속성을 위해 현재 토큰 상태를 내보냅니다. import_tokens(data: dict[str, Any]) -> None — 이전에 내보낸 사전(dict)에서 토큰 상태를 복원합니다.
frameio.auth.AuthorizationUrlResult
SPAAuth.get_authorization_url() 및 AsyncSPAAuth.get_authorization_url()에서 반환하는 고정 데이터 클래스(dataclass)입니다. 인증 URL 및 PKCE 코드 검증자를 보관합니다. 속성url: str — 사용자를 리디렉션할 전체 인증 URL입니다. code_verifier: str — 저장해 두었다가 exchange_code()에 전달할 PKCE 코드 검증자입니다.
frameio.auth.close_clients() / aclose_clients()
인증 모듈에서 사용하는 모듈 수준 HTTP 클라이언트를 닫습니다. 애플리케이션 종료 시 연결을 해제하려면 동기 코드에서는 close_clients()를 호출하고, 비동기 코드에서는 await aclose_clients()를 호출합니다.
인증 예외
모든 인증 예외는 FrameioAuthError에서 상속됩니다.
컬렉션
client.collections.index(...) -> AsyncHttpResponse[CollectionsResponse]
프로젝트의 컬렉션 나열.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.collections.show(...) -> AsyncHttpResponse[CollectionResponse]
컬렉션 세부 정보 표시.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
collection_id: Uuid —
include: typing.Optional[CollectionInclude] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
코멘트
client.comments.show(...) -> AsyncHttpResponse[CommentWithIncludesResponse]
파일의 단일 코멘트를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
comment_id: Uuid —
include: typing.Optional[CommentsShowRequestInclude] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.comments.delete(...) -> AsyncHttpResponse[None]
에셋에서 코멘트를 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
comment_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.comments.update(...) -> AsyncHttpResponse[CommentResponse]
지정된 에셋에 대한 코멘트를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
comment_id: Uuid —
data: UpdateCommentParamsData
timestamp_as_timecode: typing.Optional[bool] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.comments.index(...) -> AsyncPager[CommentWithIncludes, CommentsWithIncludesResponse]
지정된 에셋에 대한 코멘트를 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.comments.create(...) -> AsyncHttpResponse[CommentResponse]
파일에 코멘트를 생성합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
data: CreateCommentParamsData
timestamp_as_timecode: typing.Optional[bool] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.comments.create_attachment(...) -> AsyncHttpResponse[CommentAttachmentResponse]
기존 코멘트의 첨부 파일 생성.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
comment_id: Uuid —
data: AttachmentInput
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.comments.delete_attachment(...) -> AsyncHttpResponse[None]
코멘트에서 첨부 파일 삭제.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
comment_id: Uuid —
attachment_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
사용자 지정 작업
client.custom_actions.actions_index(...) -> AsyncHttpResponse[ActionsWithIncludesResponse]
지정된 작업 영역의 작업 나열.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.custom_actions.actions_show(...) -> AsyncHttpResponse[ActionWithIncludesResponse]
사용자 지정 작업의 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
action_id: Uuid —
include: typing.Optional[typing.Literal["creator"]] —
request_options: typing.Optional[RequestOptions] — Request-specific configuration.
client.custom_actions.actions_create(...) -> AsyncHttpResponse[ActionCreateResponse]
작업 영역에 사용자 지정 작업을 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
data: ActionCreateParamsData
request_options: typing.Optional[RequestOptions] — Request-specific configuration.
client.custom_actions.actions_update(...) -> AsyncHttpResponse[ActionResponse]
사용자 지정 작업의 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
action_id: Uuid —
data: ActionUpdateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.custom_actions.actions_delete(...) -> AsyncHttpResponse[None]
사용자 지정 작업을 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
action_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
Files
client.files.list(...) -> AsyncHttpResponse[AssetsWithIncludesResponse]
지정된 폴더에 있는 파일을 나열합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
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] — 요청별 구성입니다.
client.files.create(...) -> AsyncHttpResponse[FileWithUploadUrlsResponse]
상위 폴더 아래에 새 파일을 만듭니다. 파일 생성(로컬 업로드)과 파일 생성(원격 업로드)이 이 엔드포인트를 대체했습니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FileCreateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.show(...) -> AsyncHttpResponse[FileWithIncludesResponse]
파일 세부 정보를 표시합니다.
응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.
media_links.original을 포함했는데 사용자에게 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 403 Forbidden 오류로 응답합니다. 이 사용자에 대해 워터마크가 요구되지만 요청된 media_links에서 이를 지원하지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청된 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 media_links.video_h264_180 포함) 트랜스코딩 프로세스가 완료되지 않은 경우(즉, 파일의 상태가 “transcoded”가 아닌 “uploaded”인 경우), 응답 페이로드의 링크 역시 null로 설정됩니다. 즉, 클라이언트는 null로 처리된 미디어 링크를 원활하게 처리할 수 있어야 합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
include: typing.Optional[FileWithMediaLinksInclude] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.delete(...) -> AsyncHttpResponse[None]
ID로 파일을 삭제합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.update(...) -> AsyncHttpResponse[FileResponse]
파일 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
data: FileUpdateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.copy(...) -> AsyncHttpResponse[FileCopyResponse]
파일을 복사합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.files.create_remote_upload(...) -> AsyncHttpResponse[FileRemoteUploadResponse]
원격 업로드를 통해 상위 폴더 아래에 새 파일을 생성합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FileCreateRemoteUploadParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.move(...) -> AsyncHttpResponse[FileResponse]
파일을 폴더 또는 version_stack으로 이동합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
data: FileMoveParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.create_local_upload(...) -> AsyncHttpResponse[FileWithUploadUrlsResponse]
로컬 업로드를 통해 상위 폴더 아래에 새 파일을 생성합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FileCreateLocalUploadParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.show_file_upload_status(...) -> AsyncHttpResponse[FileUploadStatusResponse]
파일 업로드 상태 세부 정보를 표시합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.files.import_file(...) -> AsyncHttpResponse[FileResponse]
계정에 구성된 저장 위치에서 파일을 가져옵니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FileImportParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
폴더 권한
client.folder_permissions.folder_user_roles_index(...) -> AsyncHttpResponse[UserRolesResponse]
지정된 폴더의 사용자 역할을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.folder_permissions.folder_user_roles_update(...) -> AsyncHttpResponse[UpdateUserRolesResponse]
사용자가 이미 폴더에 추가된 경우 지정된 폴더의 사용자 역할을 업데이트합니다. 사용자가 폴더에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
user_id: Uuid —
data: UpdateUserRolesParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.folder_permissions.delete(...) -> AsyncHttpResponse[None]
지정된 폴더에서 사용자를 제거합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
user_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
폴더
client.folders.show(...) -> AsyncHttpResponse[FolderWithIncludesResponse]
폴더 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
include: typing.Optional[AssetInclude] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.folders.delete(...) -> AsyncHttpResponse[None]
ID로 폴더를 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.folders.update(...) -> AsyncHttpResponse[FolderResponse]
폴더 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FolderUpdateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.folders.index(...) -> AsyncHttpResponse[AssetsWithIncludesResponse]
지정된 폴더의 하위 항목을 나열합니다.
응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.
media_links.original을 포함했는데 사용자에게 해당 프로젝트에서 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 403 Forbidden 오류로 응답합니다. 이 사용자에 대해 워터마크가 요구되지만 요청된 media_links에서 이를 지원하지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청된 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 media_links.video_h264_180 포함) 트랜스코딩 프로세스가 완료되지 않은 경우(즉, 파일의 상태가 “transcoded”가 아닌 “uploaded”인 경우), 응답 페이로드의 미디어 링크 역시 null로 설정됩니다. 즉, 클라이언트는 null로 처리된 미디어 링크를 원활하게 처리할 수 있어야 합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.folders.copy(...) -> AsyncHttpResponse[FolderCopyResponse]
폴더를 복사합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
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] — 요청별 구성입니다.
client.folders.list(...) -> AsyncHttpResponse[FoldersWithIncludesResponse]
지정된 폴더의 하위 폴더들을 나열합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
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] — 요청별 구성입니다.
client.folders.create(...) -> AsyncHttpResponse[FolderResponse]
제공된 folder_id 경로 매개변수 내에 새 폴더를 생성합니다.
속도 제한: account_user당 1초당 3회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FolderCreateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.folders.move(...) -> AsyncHttpResponse[FolderResponse]
폴더를 다른 폴더로 이동합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: FolderMoveParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
그룹
client.groups.index(...) -> AsyncHttpResponse[GroupsWithIncludesResponse]
계정의 그룹을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.groups.show(...) -> AsyncHttpResponse[GroupWithIncludesResponse]
그룹 세부 정보 표시.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
group_id: Uuid —
include: typing.Optional[typing.Literal["creator"]] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.groups.create(...) -> AsyncHttpResponse[GroupResponse]
현재 계정의 그룹을 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
data: CreateGroupParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.groups.update(...) -> AsyncHttpResponse[GroupResponse]
그룹 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
group_id: Uuid —
data: UpdateGroupParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
메타데이터
client.metadata.bulk_update(...) -> AsyncHttpResponse[None]
여러 파일에 걸쳐 메타데이터 값을 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
data: BulkUpdateMetadataParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.metadata.show(...) -> AsyncHttpResponse[MetadataResponse]
파일의 메타데이터를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
file_id: Uuid —
show_null: typing.Optional[bool] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
메타데이터 필드
client.metadata_fields.metadata_field_definitions_delete(...) -> AsyncHttpResponse[None]
계정 수준의 사용자 지정 필드 정의를 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
field_definition_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.metadata_fields.metadata_field_definitions_update(...) -> AsyncHttpResponse[FieldDefinitionResponse]
계정 수준의 사용자 지정 필드 정의를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
field_definition_id: Uuid —
data: typing.Optional[UpdateFieldDefinitionParamsData]
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.metadata_fields.metadata_field_definitions_index(...) -> AsyncHttpResponse[FieldDefinitionsWithIncludesResponse]
계정 수준의 필드 정의를 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.metadata_fields.metadata_field_definitions_create(...) -> AsyncHttpResponse[FieldDefinitionResponse]
계정 수준의 필드 정의를 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
data: typing.Optional[CreateFieldDefinitionParamsData]
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
프로젝트 권한
client.project_permissions.index(...) -> AsyncPager[UserRole, UserRolesResponse]
지정된 프로젝트에 대한 사용자 역할을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.project_permissions.delete(...) -> AsyncHttpResponse[None]
지정된 프로젝트에서 사용자를 제거합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
user_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.project_permissions.project_user_roles_update(...) -> AsyncHttpResponse[UpdateUserRolesResponse]
사용자가 이미 프로젝트에 추가된 경우 지정된 프로젝트에 대한 사용자 역할을 업데이트합니다. 사용자가 프로젝트에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
user_id: Uuid —
data: UpdateUserRolesParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
프로젝트
client.projects.show(...) -> AsyncHttpResponse[ProjectWithIncludesResponse]
프로젝트 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
include: typing.Optional[typing.Literal["owner"]] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.projects.delete(...) -> AsyncHttpResponse[None]
프로젝트를 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.projects.update(...) -> AsyncHttpResponse[ProjectResponse]
프로젝트 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
project_id: Uuid —
data: ProjectUpdateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.projects.index(...) -> AsyncPager[ProjectWithIncludes, ProjectsWithIncludesResponse]
지정된 작업 영역의 프로젝트를 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.projects.create(...) -> AsyncHttpResponse[ProjectResponse]
지정된 작업 영역에 프로젝트를 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
data: ProjectParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.projects.account_projects_index(...) -> AsyncPager[ProjectWithIncludes, ProjectsWithIncludesResponse]
인증된 사용자가 지정된 계정 내에서 액세스할 수 있는 모든 프로젝트 나열.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.projects.invited_projects_index(...) -> AsyncPager[ProjectWithIncludes, ProjectsWithIncludesResponse]
지정된 계정 내에서 현재 사용자가 초대되었지만 작업 영역 레벨 액세스 권한은 없는 프로젝트를 나열합니다. 사용자가 팀/작업 영역 권한 없이 프로젝트별 공동 작업자 액세스 권한을 갖는 프로젝트입니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
검색
client.search.search(...) -> AsyncHttpResponse[SearchResponse]
계정 내의 에셋, 폴더, 프로젝트를 검색합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
공유
업로드
frameio.upload.FrameioUploader(에셋, 파일, …)
client.files.create_local_upload(…)가 반환한 사전 서명된 URL을 사용하여 로컬 파일을 Frame.io에 업로드합니다. FrameioUploader는 FileWithUploadUrls 응답에서 upload_urls, file_size, media_type을 읽고 청크 분할된 다중 스레드 S3 업로드를 수행하는 얇은 래퍼입니다.
매개변수
asset: FileWithUploadUrls — client.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() -> None — 파일을 업로드합니다. 완료될 때까지 차단되거나 오류 시 예외를 발생시킵니다.
사용자
client.users.show() -> AsyncHttpResponse[ProfileResponse]
베어러 토큰과 연결된 사용자의 세부 정보를 확인합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
버전 스택
client.version_stacks.index(...) -> AsyncHttpResponse[AssetsWithIncludesResponse]
지정된 버전 스택의 하위 항목(파일)들을 나열합니다.
응답에 추가 속성을 선택적으로 포함하려면 include 쿼리 매개변수를 사용하세요.
media_links.original을 포함했는데 사용자에게 해당 프로젝트에서 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 403 Forbidden 오류로 응답합니다. 이 사용자에 대해 워터마크가 요구되지만 요청된 media_links에서 이를 지원하지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청된 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 media_links.video_h264_180 포함) 트랜스코딩 프로세스가 완료되지 않은 경우(즉, 파일의 상태가 “transcoded”가 아닌 “uploaded”인 경우), 응답 페이로드의 미디어 링크 역시 null로 설정됩니다. 즉, 클라이언트는 null로 처리된 미디어 링크를 원활하게 처리할 수 있어야 합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.version_stacks.show(...) -> AsyncHttpResponse[VersionStackWithIncludesResponse]
버전 스택의 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
version_stack_id: Uuid —
include: typing.Optional[VersionStacksShowRequestInclude] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.version_stacks.copy(...) -> AsyncHttpResponse[VersionStackCopyResponse]
버전 스택을 복사합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
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] — 요청별 구성입니다.
client.version_stacks.list(...) -> AsyncHttpResponse[VersionStacksWithIncludesResponse]
지정된 폴더의 버전 스택을 나열합니다.
속도 제한: account_user당 1초당 5회 호출
매개변수
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] — 요청별 구성입니다.
client.version_stacks.create(...) -> AsyncHttpResponse[VersionStackWithIncludesResponse]
상위 폴더 아래에 새 버전 스택을 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
folder_id: Uuid —
data: VersionStackCreateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.version_stacks.move(...) -> AsyncHttpResponse[VersionStackResponse]
버전 스택을 다른 폴더로 이동합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
version_stack_id: Uuid —
data: VersionStackMoveParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
Webhook
client.webhooks.index(...) -> AsyncPager[WebhookWithIncludes, WebhooksWithIncludesResponse]
지정된 작업 영역의 웹훅을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.webhooks.create(...) -> AsyncHttpResponse[WebhookCreateResponse]
시크릿이 포함된 단일 웹훅을 생성합니다.
유효한 이벤트:
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회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
data: WebhookCreateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.webhooks.show(...) -> AsyncHttpResponse[WebhookWithIncludesResponse]
웹훅 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
webhook_id: Uuid —
include: typing.Optional[typing.Literal[“creator”]] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.webhooks.delete(...) -> AsyncHttpResponse[None]
웹훅을 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
webhook_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.webhooks.update(...) -> AsyncHttpResponse[WebhookResponse]
웹훅 세부 정보를 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
webhook_id: Uuid —
data: WebhookUpdateParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
작업 공간 권한
client.workspace_permissions.index(...) -> AsyncPager[UserRole, UserRolesResponse]
지정된 작업 영역의 사용자 역할을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.workspace_permissions.workspace_user_roles_delete(...) -> AsyncHttpResponse[None]
지정된 작업 영역에서 사용자를 제거합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
user_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.workspace_permissions.workspace_user_roles_update(...) -> AsyncHttpResponse[UpdateUserRolesResponse]
사용자가 이미 작업 영역에 추가된 경우 지정된 작업 영역에 대한 사용자 역할을 업데이트합니다. 사용자가 작업 영역에 추가되지 않은 경우 해당 사용자는 지정된 역할로 추가됩니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid—
user_id: Uuid —
data: UpdateUserRolesParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
Workspaces
client.workspaces.show(...) -> AsyncHttpResponse[WorkspaceWithIncludesResponse]
작업 영역 세부 정보를 표시합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
include: typing.Optional[typing.Literal[“creator”]] —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.workspaces.delete(...) -> AsyncHttpResponse[None]
계정에서 작업 영역을 삭제합니다.
요청 제한: account_user당 1.00분당 60회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.workspaces.update(...) -> AsyncHttpResponse[WorkspaceResponse]
작업 영역을 업데이트합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
workspace_id: Uuid —
data: WorkspaceParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
client.workspaces.index(...) -> AsyncPager[WorkspaceWithIncludes, WorkspacesWithIncludesResponse]
지정된 계정의 작업 영역을 나열합니다.
요청 제한: account_user당 1.00분당 100회 호출
매개변수
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] — 요청별 구성입니다.
client.workspaces.create(...) -> AsyncHttpResponse[WorkspaceResponse]
계정에서 작업 영역을 생성합니다.
요청 제한: account_user당 1.00분당 10회 호출
매개변수
account_id: Uuid —
data: WorkspaceParamsData
request_options: typing.Optional[RequestOptions] — 요청별 구성입니다.
PyPI
PyPI에서 보기