소스 파일
Relay 서비스에는 설문 조사의 데이터 추출 부분 중에 사용되는 소스 파일을 게시하는 기능이 포함되어 있습니다. 예를 들어 ios_messages.messages
에 대한 설문 조사는 메시지 데이터를 검색하기 위해 iOS 백업에서 sms.db
파일을 확인합니다. sms.db
파일 자체를 게시하는 소스 파일을 사용하면 추출된 데이터 및 관련 첨부 파일과 함께 반환됩니다.
소스 파일 게시 활성화
소스 파일 게시는 poll_payload
속성을 통해 또는 조직 전체 또는 키 수준 구성을 통해 구독별로 활성화할 수 있습니다. 모두 동일한 구성 키 사용: publish_source_files
소스 파일 게시가 활성화된 구독 만들기
curl https://ricloud-api.reincubate.com/subscriptions \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "session": "<session ID>", "source": "<child source ID>", "poll_payload": { "data_types": ["ios_messages.messages"], "publish_source_files": true } }'
조직 수준에서 소스 파일 게시 구성
curl https://ricloud-api.reincubate.com/organisation \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "config": { "publish_source_files": true } }'
위의 경우 조직 관리자 키가 필요합니다.
키 수준에서 소스 파일 게시 구성
curl https://ricloud-api.reincubate.com/key \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "config": { "publish_source_files": true } }'
조직 전체 구성은 키 수준 구성으로 재정의할 수 있으며, 이는 소스 파일이 프로덕션 사용에만 관심이 있는 경우에 유용할 수 있습니다. 마찬가지로 둘 다 폴 페이로드 매개변수로 재정의할 수 있으므로 소스 파일을 사례별로 게시해야 하는지 여부를 지정할 수 있습니다.
조직 또는 키 구성을 통해 기능을 활성화하면 변경된 동작이 기존 구독에 소급 적용됩니다.
소스 파일 결과 작업
소스 파일 게시가 활성화되면 API는 추출 프로세스의 일부로 수정된 모든 파일을 추적하고 스토리지 버킷에 게시하고 현재 설문 조사와 연결된 결과 개체를 생성합니다.
특정 데이터 세트와 관련된 소스 파일에 대한 참조는 데이터 결과 자체의 metadata
속성에 포함됩니다. 예를 들어:
{ "data": [{ "id": "a1b2c3d4", "data_type": "message", "conversation_id": "w6x7y8z9", "handle": "Pal", "type": "SMS", "text": "Hi, how’s it going?", "attachments": [{ "type": "image", "file_id": "a492be9a8dadabdc774286116232420224f14976", "file_path": "Library/SMS/Attachments/de/14/33A09D66-287E-4B64-A874-1A1234BD7E61/IMG_0006.PNG", "filename": "IMG_0006.PNG" }], "group_handles": [ "Pal", "renate@reincubate.com" ], "from_me": false, "deleted": false, "date": "2020-01-01T00:00:00.000000Z" }], "metadata": { "count": 1, "filters": null, "source_files": [{ "file_id": "3d0d7e5fb2ce288813306e4d4636395e047a3d28", "domain": "HomeDomain", "file_path": "Library/SMS/sms.db", "filename": "sms.db", "size": 123456, "date_last_modified": "2020-01-02T00:00:00.000000Z" }] } }
첨부 파일 결과와 마찬가지로 소스 파일 항목의 file_id
는 관련된 결과의 identifier
속성에 해당합니다. 따라서 스토리지 버킷에 기록된 파일의 이름이기도 합니다.