Jak połączyć ShipStation z Google Sheets - zapytanie o dane wysyłki za pomocą SQL

Połącz · ShipStation z Arkuszami Google

Pobierz dane z ShipStation do Arkusze Google

Pobierz aktywne wiersze z konta ShipStation do Arkuszy Google i odświeżaj je w dowolnym momencie. Bez przesyłania plików CSV, bez skryptów Apps Script i bez kopiowania wklejania. Za pierwszym razem zajmie to około dziesięciu minut, a plan darmowy to obejmuje.

Około 10 minut Nie potrzeba kodowania Poświadczenia pozostają z Tobą Dowolna przeglądarka, dowolne urządzenie

Co z tego wyjdzie?

Arkusz Google pokazujący na żywo wyniki zapytania SQL na Twoim koncie ShipStation, z przyciskiem pobierającym najnowsze wiersze po każdej zmianie danych. Na przykład:

Sprzedaż Zapisano na Dysku

PlikRedagowaćPoglądWstawFormatDaneNarzędziaRozszerzeniaPomoc

	A	B	C	D	E
1	customer_id	imię	nazwisko	kraj	całkowity
2	1042	Maria	Álvarez	USA	1,284.50
3	1043	Daniel	Okafor	USA	612.00
4	1047	Priya	Nair	USA	2,090.75
5	1051	Tomasz	Góra	USA	338.20
6	1056	Lucía	Ferreira	USA	1,455.00
7	1060	Kenji	Sato	USA	874.10
8

+ klienci Arkusz1 Na żywo z ShipStation

ShipStation przechowuje Twoje dane za pośrednictwem swojego API. Przeniesienie ich do Arkuszy Google zazwyczaj oznacza eksport pliku CSV z pulpitu ShipStation za każdym razem, gdy potrzebujesz nowych danych. Query Streams pomija ten problem: mały program pomocniczy o nazwie Agent uruchamia zapytanie w miejscu, w którym znajdują się Twoje dane, a dodatek do Arkuszy Google pyta go o żądane wiersze. Tylko wyniki przesyłane są szyfrowanym łączem, a Arkusze Google mogą być dostępne w dowolnym miejscu: w dowolnej przeglądarce na dowolnym urządzeniu.

Czego będziesz potrzebować

Konto Query Streams

Plan darmowy wystarczy do tego poradnika. Zarejestruj się na my.querystreams.com.

Agent na dowolnym komputerze stale włączonym

Mały program, który działa w tle i wywołuje ShipStation, gdy Arkusze Google o to proszą. Wymaga jedynie dostępu do internetu.

Twoje logowanie do ShipStation

Zalogujesz się do ShipStation raz i zezwolisz na dostęp do odczytu. Do strumieni zapytań nie wpisuje się żadnych haseł.

Podłącz w pięciu krokach

1. Utwórz swoje konto

   Przejdź do my.querystreams.com i zarejestruj się. Wybierz Bezpłatny plan. To prawdziwy plan, a nie wersja próbna, obejmujący podłączenie konta ShipStation i uruchamianie zapytań z Arkuszy Google.

2. Zainstaluj agenta na dowolnym komputerze stale włączonym

   Zaloguj się, otwórz Pobieraći zainstaluj Agenta na dowolnym komputerze lub serwerze z dostępem do internetu, który jest stale aktywny. Zajmie to minutę i od tego momentu uruchomi się automatycznie.

   Dlaczego mały program, a nie sterownik? Agent to pojedyncza instalacja dla systemów Windows, Mac lub Linux (około 85 MB w systemie Windows, nieco ponad 100 MB w systemach Mac i Linux), która działa cicho w tle. Nawiązuje jedno szyfrowane połączenie wychodzące do strumieni zapytań, tak jak robi to przeglądarka, więc nie otwierasz portu zapory sieciowej ani nie konfigurujesz sieci VPN. Twoje klucze pozostają na tym komputerze, a wiersze danych są przesyłane do Ciebie, gdziekolwiek jesteś, przez internet, jeśli zajdzie taka potrzeba. Jedyne, co musisz zrobić, to zainstalować dodatek.

   Strona pobierania pokazuje Twój klucz dostępuWklej to do agenta, gdy o to poprosi i poczekaj, aż odznaka zostanie odczytana Połączono ze strumieniami zapytańTo jest jedyna rzecz, którą robisz na samym Agencie.

   Pełne opisy przejść, jeśli ich potrzebujesz: Okna, Prochowiec, Linux.

3. Skieruj go na swoje konto ShipStation

   Wróć do przeglądarki i otwórz Agenci danych (pod Dane (w górnym menu). Twój agent jest tam wymieniony. Kliknij Dodaj złącze i wybierz ShipStationPotrzebujesz najpierw danych logowania do ShipStation? Otwórz przewodnik i wypełnij:

   Utwórz swoje dane uwierzytelniające ShipStation (około 5 minut)

   Następnie otwórz ShipStation w innej karcie. Strumienie zapytań przechowują to, co tutaj utworzysz, aby Twój agent mógł z tego korzystać, i odczytują tylko dane z ShipStation.

   Kto może to zrobić?

   Właściciel konta (ShipStation pozwala generować klucze API tylko właścicielowi konta)

   Zalecony

   Klucz API ShipStation V2 (klucz produkcyjny)

   Zanim zaczniesz

   • Plan ShipStation z dostępem do API: Standard, Accelerate, Premium lub wyższy. Plany Free i Starter nie mają dostępu do API.
   • Logowanie właściciela konta w ShipStation i dostęp do skrzynki odbiorczej właściciela (za pierwszym razem ShipStation wysyła wiadomość e-mail z linkiem weryfikacyjnym przed utworzeniem klucza).
   • Jeśli Twoja firma korzysta z ShipStation API (produktu deweloperskiego, dawniej ShipEngine) zamiast aplikacji internetowej ShipStation, Twój klucz znajduje się w panelu ShipStation API pod adresem https://api-portal.shipstation.com/: przejdź do środowiska produkcyjnego i skopiuj klucz produkcyjny, a następnie przejdź bezpośrednio do kreatora. Klucze rozpoczynające się od TEST_ to klucze sandbox.
   • Kreator strumieni zapytań zostanie otwarty w innej karcie: Agenci danych → Dodaj łącznik → ShipStation.

   Kroki

   1. Zaloguj się do ShipStation jako właściciel konta

      Otwórz ShipStation w nowej karcie i zaloguj się, używając loginu właściciela konta. Tylko właściciel konta może generować klucze API, a ShipStation wyświetla nowy klucz tylko raz, wyłącznie osobie, która go wygenerowała.

      Nie jesteś właścicielem? Poproś właściciela, aby wykonał kroki od 1 do 11 i wkleił klucz do kreatora Query Streams lub przesłał go Tobie za pośrednictwem menedżera haseł. Jeśli nie masz pewności, kto jest właścicielem, skontaktuj się z działem wsparcia ShipStation ([email protected]).

   2. Otwórz ustawienia

      Kliknij ikonę koła zębatego (Ustawienia) na ciemnym pasku narzędzi w prawym górnym rogu ekranu, między ikoną drukarki i ikoną znaku zapytania.

      W przypadku niektórych kont dostęp do tego samego obszaru ustawień można uzyskać poprzez ikonę osoby → Mój profil.

   3. Otwórz ustawienia API

      Na pasku bocznym po lewej stronie rozwiń sekcję „Konto” (jeśli jest zwinięta) i kliknij „Ustawienia API”. Tytuł strony brzmi „Ustawienia API”, a pod spodem znajduje się pole „Klucze API”. Po zalogowaniu link otwiera bezpośrednio tę stronę.

      Jeśli na stronie jest napisane, że Twój plan nie obsługuje dostępu do API, konto jest na poziomie Free lub Starter. Najpierw zaktualizuj do wersji Standard lub wyższej w sekcji Konto → Płatności i subskrypcja.

   4. Wybierz API V2

      Z listy rozwijanej Wybierz wersję API wybierz API V2.

      Menu rozwijane można otworzyć w API V1. Query Streams korzysta z API V2 ShipStation. Klucz V1 składa się z klucza API i klucza tajnego, a test połączenia z nieprawidłowym kluczem API kończy się niepowodzeniem.

   5. Sprawdź, czy klucz V2 już istnieje

      Jeśli w polu znajduje się przycisk Generuj klucz API, przejdź do kroku 6. Jeśli zamiast tego wyświetla się wiersz Klucz produkcyjny z ukrytym kluczem, ikoną kopiowania i ikoną kosza na śmieci, konto ma już jeden dozwolony klucz V2.

      Jeśli istniejący klucz jest zapisany w bezpiecznym miejscu (menedżerze haseł lub w konfiguracji innego narzędzia, z którego możesz skopiować klucz), użyj go i przejdź bezpośrednio do kreatora. W przeciwnym razie kliknij ikonę kosza na śmieci, a następnie Usuń klucz w wyskakującym okienku Usuń klucz API. Usunięcia nie można cofnąć, a wszystkie inne narzędzia korzystające ze starego klucza przestaną działać, dopóki nie podasz im nowego.

   6. Kliknij Wygeneruj klucz API

      Kliknij „Wygeneruj klucz API” po prawej stronie pola. Jeśli otworzy się okno dialogowe „Wygeneruj klucz API”, przejdź do kroku 9. Jeśli zamiast tego pojawi się niebieski komunikat („Wymagana weryfikacja adresu e-mail. Kliknij link weryfikacyjny, który wysłaliśmy na Twój adres e-mail użytkownika, a następnie spróbuj ponownie.”), wykonaj kroki 7 i 8.

      ShipStation prosi o sprawdzenie adresu e-mail przed wysłaniem pierwszego klucza do konta. Nowe konta muszą zweryfikować swój adres e-mail, zanim będą mogły wygenerować klucze.

   7. Kliknij link weryfikacyjny w swojej wiadomości e-mail

      Otwórz wiadomość e-mail wysłaną przez ShipStation na adres właściciela konta i kliknij zawarty w niej link weryfikacyjny.

      Po kilku minutach nie ma maila? Sprawdź foldery ze spamem i promocjami.

   8. Kliknij ponownie „Wygeneruj klucz API”

      Wróć do zakładki Ustawienia API, sprawdź, czy w polu Wybierz wersję API nadal wyświetla się API V2, i kliknij ponownie Wygeneruj klucz API.

      Przycisk resetuje się po weryfikacji adresu e-mail. Jeśli niebieski komunikat nadal się wyświetla, odśwież stronę i ponownie wybierz API V2.

   9. Wybierz datę wygaśnięcia i kliknij Generuj

      W oknie dialogowym Generuj klucz API w obszarze Ustaw okres ważności klucza wybierz 12 miesięcy, 6 miesięcy lub 3 miesiące, a następnie kliknij przycisk Generuj.

      Klucz przestaje działać w tym dniu, a synchronizacja z ShipStation zostaje przerwana. Wybierz 12 miesięcy i ustaw przypomnienie w kalendarzu. ShipStation wyśle również przypomnienie e-mailem przed wygaśnięciem klucza.

   10. Skopiuj klucz API

       Otworzy się okno podręczne zatytułowane „Klucz API został utworzony” z ostrzeżeniem, że klucz będzie widoczny tylko w tym momencie. Kliknij ikonę kopiowania (dwa nakładające się kwadraty) po prawej stronie klucza API.

       Wklej go bezpośrednio do kreatora strumieni zapytań (lub menedżera haseł), a nie do e-maila ani czatu. Jeśli w wyskakującym okienku pojawi się również wiersz klucza tajnego, utworzyłeś klucz V1: kliknij Gotowe, wróć do kroku 4 i wybierz API V2.

   11. Kliknij Gotowe

       Kliknij Gotowe. Wróć do Ustawień API, a klucz będzie teraz ukryty. ShipStation nie będzie go ponownie wyświetlać; jeśli zostanie zgubiony, usuniesz go i wygenerujesz nowy.

   Uprawnienia do udzielenia

   Ratunek	Dostęp	Używany do
   Klucz API V2 (Wybierz wersję API → API V2)	Pełny dostęp do konta. ShipStation nie ma kluczy tylko do odczytu ani kluczy z ograniczeniami.	Każda tabela shipstation.*: przesyłki, etykiety i realizacje (domyślnie włączone), a także przewoźnicy, usługi przewoźnika, magazyny, produkty, partie, manifesty, odbiory, tagi, użytkownicy i webhooki. Strumienie zapytań wysyłają tylko żądania odczytu.
   Plan: Standardowy, Przyspieszony, Premium lub wyższy	Wymagany	Bez niego ShipStation odpowiada błędem 402 i nie synchronizuje tabel. Plany darmowy i startowy nie mają dostępu do API.
   API inwentarza (Ustawienia → Dodatki)	W zestawie w planie Standard i wyższym; dodatek w tańszych planach	Tabele inventory i inventory_locations. Klucz, który ma tylko dodatek (plan poniżej Standardu), nadal nie daje połączenia testowego, ponieważ test odczytuje przesyłki.
   Właściciel konta	Wymagane do wygenerowania klucza	Brak tabeli. ShipStation pozwala tylko właścicielowi konta na tworzenie kluczy API.

   Wklej do strumieni zapytań

   Klucz API ShipStation

   Klucz API skopiowany w kroku 10: jedna wartość, bez klucza tajnego. Klucz zaczynający się od TEST_ to klucz sandbox i wyświetla tylko dane sandbox. Query Streams przechowuje klucz dla Twojego agenta i tylko go odczytuje.

   Typowe problemy

   Połączenie testowe pokazuje wynik na czerwono: Nieprawidłowy klucz API.

   Dlaczego: Wklejono klucz V1 lub jego klucz tajny, wartość zawierała dodatkowe spacje, klucz został usunięty lub wygasł.

   Naprawić: Wygeneruj klucz V2 (kroki 4–11) i wklej tylko wartość klucza API. Klikaj „Testuj połączenie”, aż pojawi się komunikat „Połączono”.

   Połączenie testowe pokazuje błąd API: PaymentRequired.

   Dlaczego: ShipStation odpowiedział(a) na pytanie 402: konto jest objęte planem niższym niż Standard (bezpłatny lub startowy) lub ma tylko dodatek Inventory API.

   Naprawić: Zaktualizuj do wersji Standardowej lub wyższej w Konto → Płatności i subskrypcja, a następnie kliknij ponownie Testuj, używając tego samego klucza.

   Nie można wygenerować klucza: w oknie Generuj klucz API ciągle pojawia się komunikat, że wymagane jest potwierdzenie adresu e-mail lub osoba konfigurująca nie ma uprawnień do tworzenia kluczy.

   Dlaczego: Klucze może generować wyłącznie właściciel konta, po sprawdzeniu swojego adresu e-mail.

   Naprawić: Zaloguj się jako właściciel konta, kliknij link w e-mailu weryfikacyjnym od ShipStation, a następnie kliknij ponownie opcję Wygeneruj klucz API.

   Połączenie działało przez kilka miesięcy, po czym synchronizacja ShipStation została zatrzymana, a komunikat o połączeniu testowym to Nieprawidłowy klucz API.

   Dlaczego: Klucz osiągnął ważność po 3, 6 lub 12 miesiącach lub ktoś go usunął, aby utworzyć nowy klucz do innego narzędzia (konto może przechowywać tylko jeden klucz V2).

   Naprawić: Wygeneruj nowy klucz V2, a następnie w Data Agents edytuj połączenie ShipStation, wklej nowy klucz w polu Klucz API ShipStation i kliknij Testuj połączenie. Podaj ten sam nowy klucz każdemu innemu narzędziu, które używało starego.

   Tabele są puste lub pokazują jedynie przesyłki testowe, a synchronizacja jest powolna.

   Dlaczego: Wykorzystano klucz sandbox (zaczynający się od TEST_) z pulpitu API ShipStation. Dane sandbox są oddzielone od rzeczywistych przesyłek, a liczba żądań kluczy sandbox jest ograniczona do 20 na minutę.

   Naprawić: Wklej klucz produkcyjny (bez prefiksu TEST_) i kliknij Testuj połączenie.

   Niektóre tabele ShipStation są opóźnione, a dziennik agenta pokazuje TooManyRequests.

   Dlaczego: ShipStation pozwala na 200 żądań na minutę na konto, współdzielonych przez wszystkie połączone z nim aplikacje. Inna integracja wykorzystuje większość tego budżetu.

   Naprawić: W strumieniach zapytań nic nie trzeba zmieniać: tabela próbuje ponownie przy następnej zaplanowanej synchronizacji. Jeśli dzieje się tak codziennie, poproś ShipStation o wyższy limit, pisząc na adres [email protected].

   Granice, które należy znać

   • Domyślnie 200 żądań na minutę na konto ShipStation, współdzielonych przez każdą aplikację i integrację korzystającą z konta; powyżej tej wartości ShipStation odpowiada na 429 żądań za dużo. Agent ogranicza się do niewielkiej części tej liczby. Wyższe limity: prosimy o kontakt mailowy pod adresem [email protected].
   • Klucze sandbox (prefiks TEST_, tylko dla klientów API ShipStation): 20 żądań na minutę, tylko dane sandbox. Konta aplikacji internetowej ShipStation (platforma) nie mają sandboxa, więc każdy klucz odczytuje dane na żywo.
   • Klucze API wygasają po 3, 6 lub 12 miesiącach, wybieranych podczas generowania. ShipStation wysyła przypomnienie e-mailem przed wygaśnięciem.
   • Jeden klucz V2 na konto na raz; ten sam klucz może być używany przez wiele aplikacji.
   • Brak dostępu do API w planach Free i Starter. Poniżej planu Standard klucze V2 otrzymują 402, z wyjątkiem punktów końcowych inwentaryzacji dodatku Inventory API.
   • API V1 (starsze, wycofane) używa pary kluczy API i kluczy tajnych pod innym adresem, z ograniczeniem do 40 żądań na minutę na parę. Query Streams nie używa V1.

   Kroki zweryfikowano 8 października 2026 r. Źródła: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/uwierzytelnianie, docs.shipstation.com/rozpoczęcie-pracy, docs.shipstation.com/limity-prędkości, docs.shipstation.com/sandbox, docs.shipstation.com/produkty-i-plany, 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.

   Nazwa połączenia

   Jakąkolwiek nazwę, którą później rozpoznasz, np. Baza danych sprzedaży.

   Klucz API ShipStation

   Klucz API ShipStation znajdziesz w ShipStation w Ustawieniach, Koncie, Ustawieniach API.

   Kliknij Połączenie testowe. Kiedy to czyta Połączony, kliknij ZapiszPołączenie zostanie nawiązane z Twoim agentem w ciągu kilku sekund.

   Otwarte Agenci Danych

   Test nieudany? Zazwyczaj brak uprawnień lub poświadczenia z niewłaściwego konta ShipStation. Powyższy opis przedstawia typowe problemy i ich rozwiązania.

4. See your data in Query Builder Fakultatywny

   You can look at your ShipStation account before Google Sheets is involved at all. Open Kreator zapytań in the portal and pick the connection you just made. The Schemat 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 Bieg and the rows appear under Wyniki. 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. Dodawanie strumieni zapytań do Arkuszy Google

   Otwórz dowolną Arkusz Google i przejdź do Rozszerzenia → Dodatki → Pobierz dodatki, wyszukaj Strumienie zapytańi kliknij Zainstaluj. Lub zainstaluj go bezpośrednio z Strumienie zapytań w sklepie Google WorkspaceGoogle poprosi Cię o zezwolenie na instalację dodatku, jest to normalne.

   Następnie jest on dostępny w każdym otwartym Arkuszu Google: ikona strumieni zapytań w panelu bocznym po prawej stronie, również wymieniona pod RozszerzeniaNie ma osobnego logowania. Rozpoznaje konto Google, którego już używasz, więc adres e-mail musi być adresem przypisanym do Twojego konta Query Streams.

6. Przyciągnij swój pierwszy stolik

   Kliknij ikonę Strumienie zapytań w panelu bocznym po prawej stronie arkusza (lub znajdź ją pod Rozszerzenia). Wybierać Streamer zapytań i wybierz połączenie, które właśnie utworzyłeś.

   Wpisz zapytanie, które chcesz uruchomić. To zapytanie pobiera kilka kolumn z shipstation.shipments tabela:

   Przykład · SQL

   WYBIERZ identyfikator_przesyłki, status_przesyłki, datę_wysyłki, identyfikator_przewoźnika Z shipstation.shipments ZAMÓW WEDŁUG created_at MNIEJSZY LIMIT 100;

   Pod Arkusz docelowy wybierz zakładkę, na której mają znaleźć się wiersze, a następnie kliknij Uruchom zapytanieWiersze trafiają na tę kartę w ciągu sekundy lub dwóch. Kliknij ponownie „Uruchom zapytanie” za każdym razem, gdy dane ulegną zmianie, a karta zostanie zaktualizowana.

   Nie znasz SQL? Build it in Kreator zapytań first and paste it here, or pick it from Saved Queries if you saved it.

Dobre następne ruchy

• Zapisz zapytanie w portalu, dzięki czemu możesz go ponownie uruchomić jednym kliknięciem z Arkuszy Google lub Excela.
• Dodaj filtr np. zakres dat, dzięki czemu na to samo zapytanie można odpowiedzieć „w tym miesiącu” bez konieczności edycji.
• Udostępnij wyniki z kolegą. Widzą wiersze, a nie twoje dane uwierzytelniające.

Pytania, które zadają ludzie

Powiązane przewodniki

• ShipStation do Microsoft Excel
• Stripe do Arkuszy Google
• HubSpot do Arkuszy Google
• Shopify do Arkuszy Google
• Power Query dla Arkuszy Google
• Wszystkie przewodniki