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 계정을 지정하세요.

   브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 ShipStation. Need your ShipStation credentials first? Open the walkthrough, then fill in:

   Create your ShipStation credentials (about 5 minutes)

   Follow this with ShipStation open in another tab. Query Streams keeps what you create here so your Agent can use it, and only ever reads from ShipStation.

   Who can do this

   Account Owner (ShipStation lets only the Account Owner generate API keys)

   추천

   ShipStation V2 API key (Production Key)

   시작하기 전에

   • A ShipStation plan with API access: Standard, Accelerate, Premium or higher. Free and Starter plans have no API access.
   • The Account Owner’s ShipStation login, and access to the owner’s email inbox (the first time, ShipStation emails a verification link before it will create a key).
   • If your company uses ShipStation API (the developer product formerly called ShipEngine) instead of the ShipStation web app, your key is in the ShipStation API dashboard at https://api-portal.shipstation.com/ instead: switch to the Production environment and copy a production key, then go straight to the wizard. Keys that start with TEST_ are sandbox keys.
   • The Query Streams wizard open in another tab: Data Agents → Add connector → ShipStation.

   Steps

   1. Sign in to ShipStation as the Account Owner

      Open ShipStation in a new tab and sign in with the Account Owner’s login. Only the Account Owner can generate API keys, and ShipStation shows a new key only once, only to the person who generated it.

      Not the owner? Ask the owner to do steps 1 to 11 and paste the key into the Query Streams wizard themselves, or send it to you through a password manager. If you are unsure who the owner is, ShipStation support ([email protected]) can tell you.

   2. Open Settings

      Click the gear icon (Settings) in the dark toolbar at the top right of the screen, between the printer icon and the question-mark icon.

      Some accounts also reach the same settings area from the person icon → My Profile.

   3. Open API Settings

      In the left sidebar, expand Account (if it is collapsed) and click API Settings. The page title reads API Settings, with an API Keys box underneath. Once you are signed in, the link opens this page directly.

      If the page says your plan does not support API access, the account is on Free or Starter. Upgrade to Standard or higher under Account → Payment & Subscription first.

   4. Choose V2 API

      In the Select API Version dropdown, choose V2 API.

      The dropdown can open on V1 API. Query Streams uses ShipStation’s V2 API. A V1 key comes as an API Key plus a Secret Key, and it fails Test connection with Invalid API key.

   5. Check whether a V2 key already exists

      If the box shows a Generate API Key button, go to step 6. If it instead shows a Production Key row with a hidden key, a copy icon and a trash-can icon, the account already has its one allowed V2 key.

      If that existing key is saved somewhere safe (a password manager, or another tool’s setup you can copy from), use it and go straight to the wizard. If not, click the trash-can icon, then Delete Key in the Delete API Key popup. Deleting cannot be undone, and any other tool that uses the old key stops working until you give it the new one.

   6. Click Generate API Key

      Click Generate API Key on the right of the box. If a popup titled Generate API Key opens, skip to step 9. If a blue notice appears instead (“Email verification required. Click the verification link we sent to your user email address then retry.”), do steps 7 and 8.

      ShipStation asks for this email check before the account’s first key. New accounts must verify their email before they can generate keys at all.

   7. Click the verification link in your email

      Open the email ShipStation sent to the Account Owner’s address and click the verification link in it.

      No email after a few minutes? Check spam and promotions folders.

   8. Click Generate API Key again

      Go back to the API Settings tab, check that Select API Version still shows V2 API, and click Generate API Key again.

      The button resets once the email is verified. If the blue notice is still there, reload the page and choose V2 API again.

   9. Pick an expiration and click Generate

      In the Generate API Key popup, under Set key expiration, choose 12 months, 6 months or 3 months, then click Generate.

      The key stops working on that date, and your ShipStation sync stops with it. Choose 12 months and put a reminder in your calendar; ShipStation also emails a reminder before the key expires.

   10. Copy the API Key

       A popup titled API Key Created opens with a warning that this is the only time the key will be visible. Click the copy icon (two overlapping squares) to the right of API Key.

       Paste it straight into the Query Streams wizard (or a password manager), not into email or chat. If the popup also shows a Secret Key row, you created a V1 key: click Done, go back to step 4 and choose V2 API.

   11. Click Done

       Click Done. Back on API Settings, the key now shows hidden. ShipStation will not reveal it again; if it is lost, you delete it and generate a new one.

   Permissions to grant

   Resource	액세스	Used for
   V2 API key (Select API Version → V2 API)	Full account access. ShipStation has no read-only or limited keys.	Every shipstation.* table: shipments, labels and fulfillments (on by default), plus carriers, carrier_services, warehouses, products, batches, manifests, pickups, tags, users and webhooks. Query Streams only sends read requests.
   Plan: Standard, Accelerate, Premium or higher	필수의	Without it ShipStation answers with 402 and no table syncs. Free and Starter plans have no API access.
   Inventory API (Settings → Add-Ons)	Included on Standard and higher; an add-on on lower plans	inventory and inventory_locations tables. A key that only has the add-on (plan below Standard) still fails Test connection, because the test reads shipments.
   Account Owner	Required to generate the key	No table. ShipStation lets only the Account Owner create API keys.

   Paste into Query Streams

   ShipStation API 키

   The API Key you copied in step 10: one value, no secret. A key that starts with TEST_ is a sandbox key and shows only sandbox data. Query Streams stores the key for your Agent and only ever reads with it.

   Common problems

   Test connection shows a red result: Invalid API key.

   Why: A V1 key or its Secret Key was pasted, the value picked up extra spaces, or the key was deleted or has expired.

   Fix: Generate a V2 key (steps 4 to 11) and paste only the API Key value. Click Test connection until it says Connected.

   Test connection shows API error: PaymentRequired.

   Why: ShipStation answered 402: the account is on a plan below Standard (Free or Starter), or it has only the Inventory API add-on.

   Fix: Upgrade to Standard or higher under Account → Payment & Subscription, then click Test again with the same key.

   You cannot generate a key: Generate API Key keeps showing Email verification required, or the person setting up is not allowed to create keys.

   Why: Only the Account Owner can generate keys, and only after verifying their email address.

   Fix: Sign in as the Account Owner, click the link in ShipStation’s verification email, then click Generate API Key again.

   The connection worked for months, then ShipStation syncs stop and Test connection says Invalid API key.

   Why: The key reached its 3, 6 or 12 month expiration, or someone deleted it to make a new key for another tool (the account can hold only one V2 key).

   Fix: Generate a new V2 key, then in Data Agents edit the ShipStation connection, paste the new key into ShipStation API Key and click Test connection. Give the same new key to any other tool that used the old one.

   Tables are empty or show only test shipments, and syncs are slow.

   Why: A sandbox key (starts with TEST_) from the ShipStation API dashboard was used. Sandbox data is separate from your real shipments, and sandbox keys are limited to 20 requests per minute.

   Fix: Paste a Production key (no TEST_ prefix) and click Test connection.

   Some ShipStation tables are behind, and the Agent log shows TooManyRequests.

   Why: ShipStation allows 200 requests per minute per account, shared by every app connected to it. Another integration is using most of that budget.

   Fix: Nothing to change in Query Streams: the table tries again on its next scheduled sync. If it happens every day, ask ShipStation for a higher limit at [email protected].

   Limits to know

   • 200 requests per minute per ShipStation account by default, shared by every app and integration that uses the account; above it ShipStation answers 429 Too Many Requests. The Agent paces itself to a small share of this. Higher limits: email [email protected].
   • Sandbox keys (TEST_ prefix, ShipStation API customers only): 20 requests per minute, sandbox data only. ShipStation web app (platform) accounts have no sandbox, so every key reads live data.
   • API keys expire after 3, 6 or 12 months, chosen when you generate them. ShipStation emails a reminder before expiry.
   • One V2 key per account at a time; the same key can be used by several apps.
   • No API access on Free and Starter plans. Below Standard, V2 keys get 402 except for the Inventory API add-on’s inventory endpoints.
   • V1 API (legacy, deprecated) uses an API Key plus Secret Key pair at a different address, limited to 40 requests per minute per pair. Query Streams does not use V1.

   Steps verified 8 October 2026. Sources: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/authentication, 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 설정에서 찾을 수 있습니다.

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

   오픈 데이터 에이전트

   테스트에 실패했나요? Usually a missing permission, or a credential from the wrong ShipStation account. The walkthrough above lists the common problems and their fixes.

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

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

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

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

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

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

   예시 · SQL

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

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

   SQL을 모르시나요? 쿼리 스트림 포털에서 쿼리를 작성하세요. 쿼리 빌더 테이블과 열을 표시해 주므로 마우스 클릭만으로 원하는 정보를 얻을 수 있습니다. 비즈니스 플랜에서는 Nova에 "미국 고객을 보여주세요"와 같이 간단한 영어로 요청하면 Nova가 SQL 쿼리를 자동으로 작성해 줍니다. 쿼리를 저장하면 포털에서 한 번의 클릭으로 바로 사용할 수 있으며, Personal Core 플랜 이상부터는 추가 기능의 저장된 쿼리 목록에서도 확인할 수 있습니다.

좋은 다음 행보입니다

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

사람들이 묻는 질문

관련 가이드

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