실행 데이터 조회

Platform.api.loadMyPlayData()

실행 중인 콘텐츠의 현재 사용자와 관련된 실행 데이터를 조회한다. 실행 데이터 목록은 저장일시 최근 순으로 정렬되며 offset과 limit 값을 이용하여 구간별로 조회할 수 있다.

구문

Platform.api.loadMyPlayData(options, [mock])

매개변수

  • options: {Object} 필수.
    • type: {String} [선택] 옵션. 데이터 구분. 있으면 해당 구분 값인 것만 조회.
    • offset: {Integer} [선택]. 전체 목록 중 건너뛸 건수. 기본값 0.
    • limit: {Integer} [선택]. 가져올 최대 건수. 1~100. 기본값 10.
  • mock
    개발시 응답으로 받을 값. 서비스에 배포된 후에는 무시된다.
    • 성공 또는 실패값. 아래 반환값 참조.

반환 값

응답 객체로 이행하는 Promise 객체.

성공 시

  • result: {String} "SUCCESS"
  • data: {Object}
    • totalCount: {Number} 실행 데이터 전체 건수
    • query: {Object} 요청 정보
      • type: {String} 데이터 구분
      • offset: {Number} 건너뛸 수
      • limit: {Number} 최대 가져온 수
    • playData: {Array<Object>} 실행 데이터 목록.
      • rowNo: {Number} 전체 데이터 중 순번. 1부터
      • saveTime: {String} 저장된 일시를 의미하는 "yyyy-MM-dd'T'HH:mm:ss" 형식의 문자열
      • type: {String} 데이터 구분
      • data: {String} 데이터

실패 시

  • result: {String} "FAIL"
  • message: {String} 오류 내용
  • help: {String} 도움말. 없을 수 있음.

예제

Platform.api.loadPlayData({
      type: 'ENV',
      offset: 10,
      limit: 10
   })
   .then(function(resposne) {
      if (response.result != 'SUCCESS') {
         alert(response.message || '조회에 실패하였습니다.');
         return;
      }

      var data = response.data;
      console.log('전체 %d건 중 %d건이 조회되었습니다.', data.totalCount, data.playData.length);
   });

2023. 6. 1 오후 2:18:33 편집