ShipStation을 Google 스프레드시트에 연결하는 방법 - SQL로 배송 데이터 쿼리하기

ShipStation을 Google Sheets에 연결

다음에서 데이터를 가져오세요 ShipStation ~ 안으로 Google 스프레드시트

ShipStation 계정의 실시간 데이터를 Google Sheets로 가져와 언제든지 새로 고칠 수 있습니다. CSV 파일 업로드, Apps Script, 복사 붙여넣기 작업이 필요 없습니다. 처음 설정하는 데 약 10분 정도 소요되며, 무료 플랜에서 이용 가능합니다.

약 10분 코딩이 필요 없습니다 자격증명은 영구적으로 보관됩니다. 어떤 브라우저든, 어떤 기기든

당신이 최종적으로 얻게 될 것

ShipStation 계정에 대한 SQL 쿼리 결과를 실시간으로 보여주는 Google 스프레드시트입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 포함되어 있습니다. 예를 들어 다음과 같습니다.

영업 드라이브에 저장됨

파일편집하다보다끼워 넣다체재데이터도구확장 기능돕다

	A	B	C	D	E
1	customer_id	첫 번째 이름	성	국가	총
2	1042	마리아	알바레스	미국	1,284.50
3	1043	다니엘	오카포르	미국	612.00
4	1047	프리야	나이르	미국	2,090.75
5	1051	도마	산	미국	338.20
6	1056	루시아	페레이라	미국	1,455.00
7	1060	켄지	사토	미국	874.10
8

+ 고객 시트1 ShipStation에서 생중계

ShipStation은 API를 통해 데이터를 관리합니다. Google Sheets로 데이터를 가져오려면 일반적으로 최신 데이터가 필요할 때마다 ShipStation 대시보드에서 CSV 파일로 내보내야 합니다. 하지만 Query Streams를 사용하면 이 과정을 생략할 수 있습니다. Agent라는 작은 도우미 프로그램이 데이터가 저장된 위치에서 쿼리를 실행하고, Google Sheets 추가 기능이 필요한 행을 요청합니다. 암호화된 링크를 통해 결과만 전송되므로 Google Sheets는 어떤 기기의 어떤 브라우저에서든 접속할 수 있습니다.

필요한 것

Query Streams 계정

이 가이드를 이용하시려면 무료 플랜으로도 충분합니다. 지금 가입하세요. my.querystreams.com.

항상 켜져 있는 컴퓨터의 에이전트

백그라운드에서 실행되는 작은 프로그램으로, Google Sheets에서 요청할 때 ShipStation을 호출합니다. 인터넷 연결만 있으면 됩니다.

ShipStation 로그인 정보

ShipStation에 한 번 로그인하고 읽기 권한을 허용하면 됩니다. 쿼리 스트림에는 비밀번호를 입력할 필요가 없습니다.

5단계로 연결하세요

1. 계정을 만드세요

   가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니며, ShipStation 계정 연결 및 Google Sheets에서 쿼리 실행 기능을 포함합니다.

2. 항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.

   로그인, 열기 다운로드인터넷에 접속할 수 있는 상시 가동 컴퓨터 또는 서버에 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.

   드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘는 용량), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 키는 해당 컴퓨터에 보관되며, 데이터는 필요한 경우 인터넷을 통해 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.

   다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.

   자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.

3. ShipStation 계정을 지정하세요.

   브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 ShipStationShipStation 계정 정보가 먼저 필요하신가요? 안내를 열고 다음 정보를 입력하세요.

   ShipStation 계정 정보를 생성하세요 (약 5분)

   ShipStation을 다른 탭에서 열어둔 상태로 다음 단계를 진행하세요. Query Streams는 여기서 생성한 데이터를 에이전트가 사용할 수 있도록 저장하며, ShipStation에서만 데이터를 읽어옵니다.

   누가 이것을 할 수 있을까요?

   계정 소유자 (ShipStation에서는 계정 소유자만 API 키를 생성할 수 있습니다.)

   추천

   ShipStation V2 API 키(프로덕션 키)

   시작하기 전에

   • API 접근이 가능한 ShipStation 플랜: Standard, Accelerate, Premium 이상. 무료 및 Starter 플랜은 API 접근이 불가능합니다.
   • 계정 소유자의 ShipStation 로그인 정보와 소유자의 이메일 사서함 접근 권한이 필요합니다(ShipStation은 처음 키를 생성하기 전에 인증 링크를 이메일로 발송합니다).
   • 귀사에서 ShipStation 웹 앱 대신 ShipStation API(이전 명칭: ShipEngine 개발자 제품)를 사용하는 경우, 키는 https://api-portal.shipstation.com/ 에 있는 ShipStation API 대시보드에서 확인할 수 있습니다. 프로덕션 환경으로 전환하여 프로덕션 키를 복사한 다음 마법사를 바로 진행하세요. TEST_로 시작하는 키는 샌드박스 키입니다.
   • 쿼리 스트림 마법사가 새 탭에서 열립니다. 데이터 에이전트 → 커넥터 추가 → ShipStation을 선택합니다.

   단계

   1. ShipStation에 계정 소유자로 로그인하세요.

      ShipStation을 새 탭에서 열고 계정 소유자의 로그인 정보로 로그인하세요. API 키는 계정 소유자만 생성할 수 있으며, ShipStation은 새 키를 생성한 사람에게만 한 번만 표시합니다.

      소유자가 아니신가요? 소유자에게 1단계부터 11단계까지 완료하고 키를 쿼리 스트림 마법사에 직접 붙여넣도록 요청하거나, 암호 관리자를 통해 키를 보내달라고 요청하세요. 소유자가 누구인지 확실하지 않은 경우 ShipStation 지원팀([email protected])에 문의하시면 안내해 드립니다.

   2. 설정 열기

      화면 오른쪽 상단의 어두운 도구 모음에서 프린터 아이콘과 물음표 아이콘 사이에 있는 톱니바퀴 아이콘(설정)을 클릭합니다.

      일부 계정은 사람 아이콘 → 내 프로필을 통해서도 동일한 설정 영역에 접근할 수 있습니다.

   3. API 설정 열기

      왼쪽 사이드바에서 계정(접혀있는 경우)을 펼치고 API 설정을 클릭합니다. 페이지 제목은 API 설정이고 그 아래에 API 키 상자가 있습니다. 로그인한 상태에서 이 링크를 클릭하면 해당 페이지가 바로 열립니다.

      페이지에 "사용 중인 요금제가 API 접근을 지원하지 않습니다"라는 메시지가 표시되면, 해당 계정은 무료 또는 스타터 요금제입니다. 먼저 계정 → 결제 및 구독에서 스탠다드 또는 그 이상의 요금제로 업그레이드하세요.

   4. V2 API를 선택하세요

      API 버전 선택 드롭다운 메뉴에서 V2 API를 선택하세요.

      드롭다운 메뉴는 V1 API에서 열릴 수 있습니다. Query Streams는 ShipStation의 V2 API를 사용합니다. V1 키는 API 키와 비밀 키로 구성되며, "유효하지 않은 API 키"로 인해 연결 테스트에 실패합니다.

   5. V2 키가 이미 존재하는지 확인하십시오.

      상자에 'API 키 생성' 버튼이 표시되면 6단계로 이동하세요. 만약 숨겨진 키, 복사 아이콘, 휴지통 아이콘이 있는 '프로덕션 키' 행이 표시되면 해당 계정에는 이미 허용된 V2 키가 하나 있습니다.

      기존 키가 안전한 곳(암호 관리자 또는 복사할 수 있는 다른 도구의 설정)에 저장되어 있다면 해당 키를 사용하여 마법사를 바로 진행하세요. 그렇지 않은 경우, 휴지통 아이콘을 클릭한 다음 'API 키 삭제' 팝업에서 '키 삭제'를 클릭하세요. 삭제는 되돌릴 수 없으며, 이전 키를 사용하는 다른 도구는 새 키를 입력하기 전까지 작동을 멈춥니다.

   6. API 키 생성 버튼을 클릭하세요

      상자 오른쪽에 있는 'API 키 생성'을 클릭하세요. 'API 키 생성'이라는 제목의 팝업 창이 열리면 9단계로 건너뛰세요. 대신 파란색 알림("이메일 인증이 필요합니다. 사용자 이메일 주소로 전송된 인증 링크를 클릭한 후 다시 시도하세요.")이 표시되면 7단계와 8단계를 수행하세요.

      ShipStation은 계정의 첫 번째 제품 키를 발급하기 전에 이메일 인증을 요청합니다. 신규 계정은 제품 키를 생성하기 전에 반드시 이메일 인증을 완료해야 합니다.

   7. 이메일에 있는 인증 링크를 클릭하세요.

      ShipStation에서 계정 소유자의 이메일 주소로 보낸 이메일을 열고 이메일에 있는 인증 링크를 클릭하세요.

      몇 분 후에도 이메일이 오지 않았나요? 스팸 및 프로모션 폴더를 확인해 보세요.

   8. API 키 생성 버튼을 다시 클릭하세요

      API 설정 탭으로 돌아가서 'API 버전 선택'에 여전히 V2 API가 표시되는지 확인하고 'API 키 생성'을 다시 클릭하세요.

      이메일 인증이 완료되면 버튼이 초기화됩니다. 파란색 알림이 계속 표시되면 페이지를 새로고침하고 V2 API를 다시 선택하세요.

   9. 만료일을 선택하고 생성을 클릭하세요.

      API 키 생성 팝업에서 '키 만료 설정' 아래에 12개월, 6개월 또는 3개월을 선택한 다음 '생성'을 클릭합니다.

      해당 날짜가 되면 키가 더 이상 작동하지 않으며, ShipStation 동기화도 함께 중지됩니다. 12개월을 선택하고 캘린더에 알림을 설정하세요. ShipStation은 키 만료 전에 이메일로도 알림을 보내드립니다.

   10. API 키를 복사하세요

       'API 키 생성됨'이라는 제목의 팝업 창이 열리고, API 키는 이 시점에만 표시된다는 경고 메시지가 나타납니다. API 키 오른쪽에 있는 복사 아이콘(겹쳐진 두 개의 사각형)을 클릭하세요.

       이메일이나 채팅이 아닌 쿼리 스트림 마법사(또는 암호 관리자)에 직접 붙여넣으세요. 팝업 창에 비밀 키 행이 표시되면 V1 키를 생성한 것입니다. 완료를 클릭하고 4단계로 돌아가 V2 API를 선택하세요.

   11. 완료를 클릭하세요

       완료를 클릭하세요. API 설정으로 돌아가면 이제 키가 숨겨져 표시됩니다. ShipStation은 키를 다시 표시하지 않습니다. 키를 분실한 경우 삭제하고 새 키를 생성해야 합니다.

   부여할 권한

   의지	액세스	사용 용도
   V2 API 키 (API 버전 선택 → V2 API)	계정에 대한 모든 접근 권한이 있습니다. ShipStation은 읽기 전용 또는 제한된 키를 제공하지 않습니다.	모든 shipstation.* 테이블: 배송, 라벨 및 이행(기본적으로 활성화됨), 운송업체, 운송업체 서비스, 창고, 제품, 배치, 매니페스트, 픽업, 태그, 사용자 및 웹훅. 쿼리 스트림은 읽기 요청만 전송합니다.
   플랜: 스탠다드, 액셀러레이트, 프리미엄 또는 그 이상	필수의	API가 없으면 ShipStation은 402 오류를 반환하고 테이블 동기화가 이루어지지 않습니다. 무료 및 스타터 플랜은 API에 접근할 수 없습니다.
   인벤토리 API (설정 → 추가 기능)	스탠다드 이상 요금제에는 기본으로 포함되어 있으며, 하위 요금제에서는 추가 옵션입니다.	inventory 및 inventory_locations 테이블. 추가 기능(Standard 미만 플랜)만 있는 키도 테스트 연결에 실패하는데, 이는 테스트가 출하 정보를 읽기 때문입니다.
   계정 소유자	키를 생성하는 데 필요합니다	테이블이 없습니다. ShipStation에서는 계정 소유자만 API 키를 생성할 수 있습니다.

   쿼리 스트림에 붙여넣기

   ShipStation API 키

   10단계에서 복사한 API 키는 값 하나만 있고 비밀 키는 없습니다. TEST_로 시작하는 키는 샌드박스 키이며 샌드박스 데이터만 표시합니다. Query Streams는 에이전트용 키를 저장하고 해당 키를 사용하여 읽기 작업만 수행합니다.

   흔히 발생하는 문제

   연결 테스트 결과에 빨간색 오류 메시지가 표시됩니다. "유효하지 않은 API 키입니다."

   왜: V1 키 또는 해당 비밀 키가 붙여넣어졌거나, 값에 불필요한 공백이 포함되었거나, 키가 삭제되었거나 만료되었습니다.

   고치다: V2 키를 생성하고(4~11단계 참조) API 키 값만 붙여넣으세요. 연결됨 표시가 나타날 때까지 연결 테스트를 클릭하세요.

   연결 테스트 시 API 오류 '결제 필요'가 표시됩니다.

   왜: ShipStation은 402 오류에 대해 다음과 같이 답변했습니다. 해당 계정은 Standard보다 낮은 요금제(무료 또는 Starter)를 사용 중이거나 Inventory API 추가 기능만 설치되어 있습니다.

   고치다: 계정 → 결제 및 구독에서 스탠다드 이상으로 업그레이드한 다음, 동일한 키를 사용하여 다시 테스트를 클릭하세요.

   API 키를 생성할 수 없습니다. 'API 키 생성' 시 이메일 인증이 필요하거나, 설정 담당자에게 키 생성 권한이 없다는 메시지가 계속 표시됩니다.

   왜: 계정 소유자만 키를 생성할 수 있으며, 이메일 주소 인증을 완료한 후에만 가능합니다.

   고치다: 계정 소유자로 로그인한 다음 ShipStation에서 보낸 인증 이메일의 링크를 클릭하고 다시 API 키 생성 버튼을 클릭하세요.

   몇 달 동안 연결이 잘 작동했는데, 그 후 ShipStation 동기화가 중단되고 연결 테스트 시 '잘못된 API 키'라는 메시지가 나타납니다.

   왜: 키가 3개월, 6개월 또는 12개월 만료되었거나, 누군가가 다른 도구용 새 키를 만들기 위해 키를 삭제했습니다(계정에는 V2 키를 하나만 보유할 수 있습니다).

   고치다: 새로운 V2 키를 생성한 다음, 데이터 에이전트에서 ShipStation 연결을 편집하고 ShipStation API 키 필드에 새 키를 붙여넣은 후 연결 테스트를 클릭합니다. 이전 키를 사용했던 다른 도구에도 동일한 새 키를 입력하세요.

   테이블이 비어 있거나 테스트 배송만 표시되고 동기화 속도가 느립니다.

   왜: ShipStation API 대시보드에서 발급받은 샌드박스 키(TEST_로 시작)를 사용했습니다. 샌드박스 데이터는 실제 배송 데이터와 분리되어 있으며, 샌드박스 키 하나당 분당 20회 요청으로 제한됩니다.

   고치다: 프로덕션 키(TEST_ 접두사 없음)를 붙여넣고 연결 테스트를 클릭하세요.

   일부 ShipStation 테이블의 처리 속도가 느리고 에이전트 로그에 TooManyRequests 오류가 표시됩니다.

   왜: ShipStation은 계정당 분당 200건의 요청을 허용하며, 이는 연결된 모든 앱에서 공유됩니다. 다른 연동 기능으로 인해 해당 예산의 대부분이 소진되었습니다.

   고치다: 쿼리 스트림에서 변경할 사항은 없습니다. 테이블은 다음 예약된 동기화 시 다시 시도합니다. 만약 매일 이런 현상이 발생한다면, ShipStation에 [email protected]으로 문의하여 더 높은 제한을 요청하십시오.

   알아야 할 한계

   • ShipStation 계정당 기본적으로 분당 200건의 요청이 허용되며, 해당 계정을 사용하는 모든 앱과 통합 서비스에서 공유됩니다. 이 한도를 초과하면 ShipStation에서 "요청 과다" 오류 메시지(429)가 표시됩니다. 에이전트는 이 한도 내에서 처리 속도를 조절합니다. 요청 한도가 더 높은 경우 [email protected]으로 문의해 주세요.
   • 샌드박스 키(TEST_ 접두사, ShipStation API 고객 전용): 분당 20회 요청, 샌드박스 데이터만 사용 가능. ShipStation 웹 앱(플랫폼) 계정은 샌드박스를 제공하지 않으므로 모든 키로 실시간 데이터를 읽을 수 있습니다.
   • API 키는 생성 시 선택한 3개월, 6개월 또는 12개월 후에 만료됩니다. ShipStation은 만료 전에 이메일로 알림을 보냅니다.
   • 계정당 V2 키는 한 번에 하나만 사용할 수 있으며, 동일한 키를 여러 앱에서 사용할 수 있습니다.
   • 무료 및 스타터 플랜에서는 API에 접근할 수 없습니다. 스탠다드 플랜 미만에서는 V2 키를 사용할 경우 인벤토리 API 추가 기능의 인벤토리 엔드포인트를 제외하고는 402 오류가 발생합니다.
   • V1 API(레거시, 더 이상 사용되지 않음)는 서로 다른 주소에 있는 API 키와 비밀 키 쌍을 사용하며, 쌍당 분당 40회 요청으로 제한됩니다. Query Streams는 V1을 사용하지 않습니다.

   2026년 10월 8일 검증 완료. 출처: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/인증, docs.shipstation.com/getting-started, docs.shipstation.com/rate-limits, docs.shipstation.com/sandbox, docs.shipstation.com/products-and-plans, docs.shipstation.com/plans/shipstation-free-starter, docs.shipstation.com/plans/shipstation-standard-premium, docs.shipstation.com/apis/shipengine/docs/guides/auth, docs.shipstation.com/apis/shipengine/docs/guides/rate-limits, docs.shipstation.com/apis/shipstation-v1/docs/start-here/…, nango.dev/docs/integrations/all/shipstation-v2/connect.

   연결 이름

   나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.

   ShipStation API 키

   ShipStation API 키는 ShipStation 설정 > 계정 > API 설정에서 찾을 수 있습니다.

   클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.

   오픈 데이터 에이전트

   테스트에 실패했나요? 일반적으로 권한이 누락되었거나 잘못된 ShipStation 계정의 자격 증명을 사용했기 때문입니다. 위의 안내에는 해당 내용이 나와 있습니다. 일반적인 문제 그리고 그 해결책들.

4. See your data in Query Builder 선택 과목

   You can look at your ShipStation account before Google Sheets is involved at all. Open 쿼리 빌더 in the portal and pick the connection you just made. The 스키마 tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 실행 and the rows appear under 결과. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Google Sheets에 쿼리 스트림 추가

   아무 구글 시트나 열고, 다음으로 이동하세요. 확장 프로그램 → 추가 기능 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 설치하다또는 바로 설치하세요. Google Workspace Marketplace에서 Query Streams를 검색하세요.구글에서 추가 기능을 허용할지 묻는 메시지가 나타날 것입니다. 이는 정상적인 절차입니다.

   이후에는 여는 모든 Google Sheets에서 오른쪽 사이드 패널에 쿼리 스트림 아이콘이 표시되며, 해당 아이콘은 다음 항목 아래에도 나열됩니다. 확장 기능별도의 로그인 절차가 없습니다. 이미 사용 중인 Google 계정을 자동으로 인식하므로, Query Streams 계정에 등록된 이메일 주소와 동일한 이메일 주소를 사용해야 합니다.

6. 첫 번째 테이블을 가져오세요

   시트 오른쪽 측면 패널에서 "쿼리 스트림" 아이콘을 클릭하거나 (아래에서 찾을 수 있습니다) 확장 기능). 선택하다 쿼리 스트리머 그리고 방금 연결한 연결을 선택하세요.

   실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. 선박역.배송 테이블:

   예시 · SQL

   SELECT shipment_id, shipment_status, ship_date, carrier_id FROM shipstation.shipments ORDER BY created_at DESC LIMIT 100;

   아래에 목적지 정보 행이 표시될 탭을 선택한 다음 클릭하세요. 쿼리 실행행들이 해당 탭에 1~2초 안에 나타납니다. 데이터가 변경될 때마다 '쿼리 실행'을 다시 클릭하면 탭이 즉시 업데이트됩니다.

   SQL을 모르시나요? Build it in 쿼리 빌더 first and paste it here, or pick it from Saved Queries if you saved it.

좋은 다음 행보입니다

• 쿼리를 저장하세요 포털에 저장되므로 Google Sheets 또는 Excel에서 한 번의 클릭으로 다시 실행할 수 있습니다.
• 필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
• 결과를 공유하세요 동료와 함께 있을 때, 그들은 당신의 자격 증명이 아니라 행 목록만 봅니다.

사람들이 묻는 질문

관련 가이드

• ShipStation에서 Microsoft Excel로
• Stripe에서 Google Sheets로
• HubSpot에서 Google Sheets로
• Shopify에서 Google Sheets로
• Google 스프레드시트용 파워 쿼리
• 모든 가이드