스프레드시트 내보내기

1. 어떤 도구를 선택할까요?

하는 일은 같습니다. 회사에서 이미 어느 계정을 사용하는지가 차이입니다.

	Google Sheets	Microsoft SharePoint
추가되는 항목	시트에 덧붙이는 행	목록 항목
제공할 정보	서비스 계정 키, 스프레드시트 ID	테넌트, 클라이언트 ID, 클라이언트 비밀 값, 사이트 ID, 목록 ID
열	고정된 순서의 8개 열	목록에 있는 열. 먼저 조회합니다.
설정 작업	서비스 계정을 만들고 시트를 공유	앱을 등록하고 사이트 하나의 권한 부여

2. Google Sheets: 모두가 잊는 공유 단계

서비스 계정도 자체 사용자이며, 전용 이메일 주소는 .iam.gserviceaccount.com으로 끝납니다. 키를 만드는 것만으로는 충분하지 않습니다. 해당 주소에 스프레드시트를 공유해야 합니다. 동료에게 공유할 때와 정확히 같습니다.

이 단계를 건너뛰면 모든 쓰기 요청이 403을 반환합니다. Google 자체 메시지는 이 점을 언급하지 않아 키를 확인하느라 반나절을 보내기도 하므로, 당사는 오류 메시지에 원인을 명시합니다.

더 편리하다면 전체 URL을 붙여 넣으세요

스프레드시트 ID는 /d/ 와 /edit사이의 부분입니다. 필드에 전체 주소를 붙여 넣으면 필요한 부분만 추출합니다.

값은 의도적으로 원시 형태로 기록합니다

“사용자 입력”으로 기록하지 않습니다. 그렇지 않으면 Google은 고객 ID인 00123 을 숫자로 읽어 앞의 0을 없애고, = 로 시작하는 값은 수식으로 바꾸기 때문입니다.

3. SharePoint: 쓰기 전에 열을 읽습니다

SharePoint는 목록에 없는 열을 지정한 항목을 거부합니다. 내부 열 이름은 목록을 만들 때 사용자가 정한 대로입니다. 고정된 열 집합을 가정하면 고객 두 명 중 한 명에게 실패하는 셈입니다.

따라서 한 시간에 한 번 목록의 열을 가져오고, 존재하며 읽기 전용이 아닌 열에만 씁니다. 기본 Title 열만 있는 목록에는 목표 이름만 기록하므로, 목표가 생길 때마다 실패하지 않습니다.

생성하면 사용할 수 있는 선택적 열: MPSession, MPChannel, MPUser, MPValue, MPCurrency, MPUrl, MPTime.

Microsoft가 권장하는 권한이 필요한 권한은 아닙니다

이 호출에 대해 Microsoft 문서는 Sites.ReadWrite.All 을 최소 권한으로 안내합니다. 이는 목록 하나를 채우는 연동에 테넌트의 모든 사이트에 대한 쓰기 권한을 부여합니다.

대신 Sites.Selected 를 사용하세요. 이 권한을 가진 앱은 기본적으로 아무 접근 권한도 없으며, 관리자가 정확히 한 사이트에 대한 쓰기 권한을 부여합니다. 두 권한을 모두 부여하면 제한이 사라집니다 . 좁은 범위의 권한은 앱에 다른 권한이 없을 때만 효과가 있습니다.

4. 행에 기록되는 내용

타임스탬프, 프로젝트, 세션, 고객 ID, 목표 이름, 가치, 통화 및 녹화를 재생하는 링크입니다. SharePoint에서는 존재하는 해당 열에 열 유형이 요구하는 형태로 같은 값을 기록합니다. 하이퍼링크 열에는 링크 객체를, 텍스트 열에는 같은 주소를 텍스트로 기록합니다.

빈 셀은 0이 아니라 “합의된 가치가 없음”을 뜻합니다

금전적 가치가 없는 목표는 셀을 비워 둡니다. 0을 쓰면 스프레드시트에서 실제로 존재하지 않았던 합계에 더해집니다.

고객 ID는 전송 시점에 조회합니다

목표가 발생하는 시점이 아닙니다. 식별은 보통 로그인할 때, 즉 흔히 목표 발생 이후 에 이루어집니다. 몇 초 뒤에 조회하면 이벤트 파이프라인의 부담도 줄고 이름을 찾을 가능성도 높아집니다.