Rozpoczynanie korzystania z usług porównywania cen

Wykonywanie podstawowych operacji za pomocą interfejsu API to dobry sposób na rozpoczęcie korzystania z niego.

Wymagania wstępne

Zanim zaczniesz, wykonaj te czynności:

  • Sprawdź, czy masz aktywne konto CSS Center.
  • Zarejestruj dewelopera interfejsu API.
  • Sprawdź, czy konfiguracja uprawnień jest prawidłowa.
  • Sprawdź, czy interfejs CSS API jest włączony.
  • Sprawdź, czy masz zainstalowane biblioteki klienta dla swojego środowiska.

Więcej informacji znajdziesz w krótkim wprowadzeniu.

Włączanie interfejsu CSS API

Aby zarejestrować się jako deweloper i korzystać z interfejsu CSS API, musisz połączyć konto CSS Center i projekt Google Cloud za pomocą metody rejestracji dewelopera w ten sposób:

Połącz CSS Center z projektem Google Cloud: połączenie zostanie nawiązane automatycznie, ponieważ wywołujący ma dostęp do projektu Google Cloud na podstawie tokena dostępu lub klucza API i jest autoryzowanym użytkownikiem konta CSS Center.

Rejestrowanie programisty interfejsu API

Dodaj użytkownika interfejsu API do konta CSS Center: jeśli użytkownik już istnieje, otrzyma nowy typ dostępu „Deweloper interfejsu API”. W przypadku nowego użytkownika otrzyma on e-maila z zaproszeniem do CSS Center.

Po rejestracji możesz sprawdzić jej stan za pomocą GetDeveloperRegistration lub wyrejestrować urządzenie za pomocą UnregisterGCP. Możesz użyć tego wywołania rejestracji:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Po pomyślnym uruchomieniu żądania otrzymasz odpowiedź:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Produkty w usłudze porównywania cen

Podobnie jak w przypadku interfejsu API Products, interfejs CSS API rozróżnia CssProductInput i ListCssProduct. Wstaw produkt z kodem InsertCssProductInput.

Gdy nasze systemy wewnętrzne przetworzą produkt (może to potrwać kilka minut), pobierz go za pomocą polecenia ListCssProducts.

Identyfikuj produkty za pomocą symbolu raw_provided_id. Zalecamy używanie identyfikatora, który jest już używany w Twoim systemie. Możesz też utworzyć go za pomocą jednej z tych metod:

  • Unikalne identyfikatory globalne (GUID)
  • Unikalne identyfikatory uniwersalne (UUID)
  • Połączone unikalne atrybuty produktu (np. marka_model_kolor_rozmiar)

Więcej informacji znajdziesz w artykule Wstawianie, wyświetlanie, aktualizowanie i usuwanie produktu.

Podstawowe operacje

Oto kilka podstawowych próśb, które możesz wypróbować.

  1. Wstaw produkt testowy za pomocą InsertCssProductInput. Aby uzyskać pomoc dotyczącą atrybutów do wysłania, zapoznaj się z tym przykładowym kodem.

  2. Wyświetl wszystkie produkty za pomocą ListCssProducts. Pamiętaj, że między wstawieniem produktu a jego pojawieniem się w informacjach o produkcie występuje niewielkie opóźnienie. Jeśli nie widzisz go od razu, spróbuj ponownie po kilku sekundach.

  3. Zaktualizuj pojedynczy produkt za pomocą UpdateCssProductInput, korzystając z cssproductinput.name. Musisz przesłać tylko atrybuty, które mają zostać zaktualizowane. Przykład znajdziesz w przykładowym kodzie.

  4. Usuń produkt testowy za pomocą polecenia DeleteCssProductInpu, podając raw_provided_id.

Ograniczenia

Wstawianie lub usuwanie pojedynczego produktu może trwać długo. Aby zwiększyć wydajność, użyj funkcji Async. Umożliwia to równoległe wywoływanie interfejsu API.

Wyświetlanie listy kont i nadawanie im etykiet

Zarządzanie etykietami w interfejsie CSS API umożliwia automatyczne porządkowanie kont klientów Merchant Center za pomocą niestandardowych tagów. Ta funkcja pomaga skutecznie kategoryzować klientów (np. według typu lub strategii), co ułatwia organizację i usprawnia działania. Za pomocą interfejsu API możesz wykonywać te funkcje związane z etykietami: