ActivityClient

​

하위 모듈

• xdk.activity.client 모듈
  • ActivityClient
    • ActivityClient.__init__()
    • ActivityClient.create_subscription()
    • ActivityClient.delete_subscription()
    • ActivityClient.get_subscriptions()
    • ActivityClient.stream()
    • ActivityClient.update_subscription()
• xdk.activity.models 모듈
  • CreateSubscriptionRequest
    • CreateSubscriptionRequest.model_config
  • CreateSubscriptionResponse
    • CreateSubscriptionResponse.model_config
  • DeleteSubscriptionResponse
    • DeleteSubscriptionResponse.model_config
  • GetSubscriptionsResponse
    • GetSubscriptionsResponse.model_config
  • StreamResponse
    • StreamResponse.model_config
  • UpdateSubscriptionRequest
    • UpdateSubscriptionRequest.model_config
  • UpdateSubscriptionResponse
    • UpdateSubscriptionResponse.model_config

​

모듈 내용

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

​

class xdk.activity.ActivityClient

activity 작업용 스트리밍 Client

​

매개변수

path.client · Client

​

__init__

​

매개변수

path.client · Client

​

create_subscription

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

​

매개변수

body.body · CreateSubscriptionRequest

​

delete_subscription

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

​

매개변수

path.subscription_id · Any

삭제할 구독의 ID입니다.

​

반환 값

DeleteSubscriptionResponse - 응답 데이터

​

get_subscriptions

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

​

반환값

GetSubscriptionsResponse

​

stream

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

​

매개변수

path.backfill_minutes · int or None · 기본값: "None"

요청된 백필 시간(분)입니다.

path.start_time · str or None · 기본값: "None"

YYYY-MM-DDTHH:mm:ssZ. 게시물 레이블이 제공될 가장 이른 UTC 타임스탬프입니다.

path.end_time · str or None · 기본값: "None"

YYYY-MM-DDTHH:mm:ssZ. 게시물 레이블이 제공될 가장 늦은 UTC 타임스탬프입니다.

path.stream_config · StreamConfig

재시도 동작, 타임아웃, 콜백을 사용자 지정하기 위한 선택적 StreamConfig입니다.

​

update_subscription

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

​

매개변수

path.subscription_id · Any

업데이트할 구독의 ID입니다.

body.body · UpdateSubscriptionRequest

요청 본문