VCVCMS API Corpus
비즈니스 레시피

연결된 채널 계정

OTA 설정과 숙소별 채널 계정 상태 및 매핑을 확인합니다.

비즈니스 질문

연결된 채널 계정이 있는 숙소는?

이 레시피가 필요한 이유

단순한 숙소 분류가 아니라 계정 중심으로 OTA 연동 상태, 숙소 매핑, 계정 상태를 파악해야 할 때 사용합니다.

추천 패턴

숙소 단위 작업에는 채널 계정을 직접 조회합니다. 플랫폼 전체 현황이 필요하면 권한이 허용하는 범위에서 연결된 계정 쿼리를 사용합니다.

query ReadChannelAccountsForAccommodation($accommodationId: ULID, $aggregateProperties: Boolean) {
  readChannelAccounts(accommodationId: $accommodationId, aggregateProperties: $aggregateProperties) {
    id
    status
    isBanned
    isShared
    countProperties
    channelId
    accommodationId
  }
}
query ReadConnectedChannelAccounts {
  readConnectedChannelAccounts {
    id
    status
    channelId
    accommodationId
  }
}

해석 참고

  • CONNECTED가 채널 계정이 정상 작동 중임을 나타내는 비즈니스 신호입니다.
  • credential 필드는 타입에 존재하지만 관리자 권한으로만 접근 가능하므로, 특수 데이터로 취급합니다.
  • 숙소 수(countProperties)는 계정 활용도를 빠르게 판단하는 지표입니다.

관련 자료