메인 콘텐츠로 건너뛰기

​
하위 모듈

​
모듈 내용

이 모듈은 X API의 미디어 엔드포인트에 대한 접근을 제공하며, 모든 미디어 관련 기능의 주요 진입점 역할을 합니다.

​
class xdk.media.MediaClient

미디어 작업용 Client

​
매개변수

​
path.client
Client

​
__init__

​
매개변수

​
path.client
Client

​
append_upload

미디어 업로드에 데이터 추가 미디어 업로드 요청에 데이터를 추가합니다.

​
매개변수

​
path.id
Any
append 작업을 수행할 미디어의 식별자입니다.
​
body.body
AppendUploadRequest
요청 본문

​
create_metadata

미디어 메타데이터 생성 미디어 파일의 메타데이터를 생성합니다. body: 요청 본문 :returns: 응답 데이터 :rtype: CreateMetadataResponse

​
매개변수

​
body.body
CreateMetadataRequest

​
create_subtitles

미디어 자막 생성하기 지정된 미디어 파일의 자막을 생성합니다. body: 요청 본문 :returns: 응답 데이터 :rtype: CreateSubtitlesResponse

​
매개변수

​
body.body
CreateSubtitlesRequest

​
delete_subtitles

미디어 자막 삭제 특정 미디어 파일의 자막을 삭제합니다. body: 요청 본문 :returns: 응답 데이터 :rtype: DeleteSubtitlesResponse

​
매개변수

​
body.body
DeleteSubtitlesRequest

​
finalize_upload

미디어 업로드 마무리 미디어 업로드 요청을 마무리합니다.

​
매개변수

​
path.id
Any
업로드를 완료할 대상 미디어의 id입니다.

​
반환값

FinalizeUploadResponse - 응답 데이터

​
get_analytics

미디어 분석 조회 미디어에 대한 분석 데이터를 조회합니다.

​
Parameters

​
path.media_keys
List
쉼표로 구분된 Media Key 목록입니다. 한 요청당 최대 100개까지 허용됩니다.
​
path.end_time
str
YYYY-MM-DDTHH:mm:ssZ 형식의 UTC 타임스탬프로, 조회 구간의 종료 시점을 나타냅니다.
​
path.start_time
str
YYYY-MM-DDTHH:mm:ssZ 형식의 UTC 타임스탬프로, 조회 구간의 시작 시점을 나타냅니다.
​
path.granularity
str
검색 카운트 결과의 세분성 수준입니다.
​
path.media_analytics_fields
List or None
기본값:"None"
표시할 MediaAnalytics 필드의 쉼표로 구분된 목록입니다.

​
반환

GetAnalyticsResponse - 응답 데이터

​
get_by_key

미디어 키로 미디어 가져오기 미디어 키를 사용하여 특정 미디어 파일의 세부 정보를 조회합니다.

​
매개변수

​
path.media_key
Any
단일 Media Key입니다.
​
path.media_fields
List or None
기본값:"None"
표시할 미디어 필드를 쉼표로 구분한 목록입니다.

​
반환값

GetByKeyResponse - 응답 데이터

​
get_by_keys

미디어 키로 미디어 가져오기 미디어 키를 사용해 미디어 파일의 세부 정보를 조회합니다.

​
매개변수

​
path.media_keys
List
쉼표로 구분된 미디어 키 리스트입니다. 한 요청당 최대 100개까지 허용됩니다.
​
path.media_fields
List or None
기본값:"None"
표시할 미디어 필드의 쉼표로 구분된 리스트입니다.

​
반환

GetByKeysResponse - 응답 데이터

​
get_upload_status

미디어 업로드 상태 가져오기 ID로 미디어 업로드 상태를 조회합니다.

​
Parameters

​
path.media_id
Any
요청한 미디어 업로드 상태를 조회할 media id입니다.
​
path.command
str or None
기본값:"None"
미디어 업로드 요청에 사용할 command입니다.

​
반환

GetUploadStatusResponse - 응답 데이터

​
initialize_upload

미디어 업로드 초기화 미디어 업로드를 초기화합니다. body: 요청 본문 :returns: 응답 데이터 :rtype: InitializeUploadResponse

​
매개변수

​
body.body
InitializeUploadRequest

​
upload

미디어 업로드 게시물이나 기타 콘텐츠에서 사용하기 위한 미디어 파일을 업로드합니다. body: 요청 본문 :returns: 응답 데이터 :rtype: UploadResponse

​
매개변수

​
body.body
UploadRequest