> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ActivityClient

<div id="submodules">
  ## 하위 모듈
</div>

* [xdk.activity.client 모듈](/ko/xdks/python/reference/xdk.activity.client)
  * [`ActivityClient`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient)
    * [`ActivityClient.__init__()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.__init__)
    * [`ActivityClient.create_subscription()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.create_subscription)
    * [`ActivityClient.delete_subscription()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.delete_subscription)
    * [`ActivityClient.get_subscriptions()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.get_subscriptions)
    * [`ActivityClient.stream()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.stream)
    * [`ActivityClient.update_subscription()`](/ko/xdks/python/reference/xdk.activity.client#xdk.activity.client.ActivityClient.update_subscription)
* [xdk.activity.models 모듈](/ko/xdks/python/reference/xdk.activity.models)
  * [`CreateSubscriptionRequest`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.CreateSubscriptionRequest)
    * [`CreateSubscriptionRequest.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.CreateSubscriptionRequest.model_config)
  * [`CreateSubscriptionResponse`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.CreateSubscriptionResponse)
    * [`CreateSubscriptionResponse.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.CreateSubscriptionResponse.model_config)
  * [`DeleteSubscriptionResponse`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.DeleteSubscriptionResponse)
    * [`DeleteSubscriptionResponse.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.DeleteSubscriptionResponse.model_config)
  * [`GetSubscriptionsResponse`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.GetSubscriptionsResponse)
    * [`GetSubscriptionsResponse.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.GetSubscriptionsResponse.model_config)
  * [`StreamResponse`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.StreamResponse)
    * [`StreamResponse.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.StreamResponse.model_config)
  * [`UpdateSubscriptionRequest`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.UpdateSubscriptionRequest)
    * [`UpdateSubscriptionRequest.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.UpdateSubscriptionRequest.model_config)
  * [`UpdateSubscriptionResponse`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.UpdateSubscriptionResponse)
    * [`UpdateSubscriptionResponse.model_config`](/ko/xdks/python/reference/xdk.activity.models#xdk.activity.models.UpdateSubscriptionResponse.model_config)

<div id="module-contents">
  ## 모듈 내용
</div>

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

<div id="class-xdkactivityactivityclient">
  ### `class xdk.activity.ActivityClient`
</div>

activity 작업용 스트리밍 Client

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.client" type="Client" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.client" type="Client" />

<div id="create_subscription">
  ### `create_subscription`
</div>

X activity 구독 생성
X activity 이벤트에 대한 구독을 생성합니다
body: 요청 본문
:returns: 응답 데이터
:rtype: CreateSubscriptionResponse

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="body.body" type="CreateSubscriptionRequest" />

<div id="delete_subscription">
  ### `delete_subscription`
</div>

X 활동 구독을 삭제합니다
X 활동 이벤트용 구독을 삭제합니다

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.subscription_id" type="Any">
  삭제할 구독의 ID입니다.
</ParamField>

<div id="returns">
  #### 반환 값
</div>

`DeleteSubscriptionResponse` - 응답 데이터

<div id="get_subscriptions">
  ### `get_subscriptions`
</div>

X 활동 구독 정보를 가져옵니다
XAA에 대한 활성 구독 리스트를 가져옵니다
:returns: 응답 데이터
:rtype: GetSubscriptionsResponse

#### 반환값

`GetSubscriptionsResponse`

<div id="stream">
  ### `stream`
</div>

Activity Stream (스트리밍)
X Activity 스트림
이 엔드포인트는 데이터를 실시간 스트리밍 방식으로 제공합니다.
각 항목은 스트림에서 전달되는 단일 데이터 포인트를 나타냅니다.
연결은 지수 백오프(exponential backoff) 재시도 로직으로 자동 관리됩니다.
스트림이 끊어지면 SDK가 별도의 Client 개입 없이 자동으로 재연결합니다.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.backfill_minutes" type="int or None" default="None">
  요청된 백필 시간(분)입니다.
</ParamField>

<ParamField path="path.start_time" type="str or None" default="None">
  YYYY-MM-DDTHH:mm:ssZ. 게시물 레이블이 제공될 가장 이른 UTC 타임스탬프입니다.
</ParamField>

<ParamField path="path.end_time" type="str or None" default="None">
  YYYY-MM-DDTHH:mm:ssZ. 게시물 레이블이 제공될 가장 늦은 UTC 타임스탬프입니다.
</ParamField>

<ParamField path="path.stream_config" type="StreamConfig">
  재시도 동작, 타임아웃, 콜백을 사용자 지정하기 위한 선택적 StreamConfig입니다.
</ParamField>

<div id="update_subscription">
  ### `update_subscription`
</div>

X 활동 구독 업데이트
X 활동 이벤트 구독을 업데이트합니다.

<div id="parameters">
  #### 매개변수
</div>

<ParamField path="path.subscription_id" type="Any">
  업데이트할 구독의 ID입니다.
</ParamField>

<ParamField path="body.body" type="UpdateSubscriptionRequest">
  요청 본문
</ParamField>