Sprawdzone metody

Dokument ten zawiera wytyczne dotyczące sprawdzonych metod. Więcej informacji znajdziesz we wskazówkach dotyczących skuteczności.

Kiedy używać interfejsu API

Aby wysyłać żądania automatycznie

Niezależnie od tego, czy wolisz zautomatyzować każdy etap swojego przepływu pracy, czy utworzyć punkt przecięcia swojego systemu ERP (Enterprise Resource Planning), interfejs Content API umożliwia wysyłanie aktualizacji natychmiast po zmianie asortymentu.

Aby otrzymać natychmiastową opinię

W Content API odpowiadasz na każde żądanie od razu, a nie e-mailem z podsumowaniem już po przetworzeniu plików danych. W przypadku dużych żądań zbiorczych spodziewany jest czas oczekiwania od 5 do 10 sekund.

Aby często zmieniać dane produktów

Dzięki Content API możesz wiele razy dziennie wprowadzać stopniowe aktualizacje w szybko zmieniającym się asortymencie produktów, natomiast wysyłanie całego pliku danych za każdym razem nie jest możliwe. Jeśli aktualizacje są dostępne pojedynczo, wysyłaj je pojedynczo, nie czekaj, aż pojawi się kilka aktualizacji, aby utworzyć je zbiorczo. Podobnie jeśli aktualizacje są dostępne w partiach, wysyłaj je partiami, ale nie dziel ich na osobne żądania.

Zarządzanie kilkoma subkontami

Nowo utworzone konta Merchant Center to pojedyncze konta z własnym zestawem danych produktów. W większości przypadków się to sprawdza, ale w miarę rozwoju konta może się okazać, że będzie Ci potrzebny bardziej złożony system zarządzania. W takim przypadku rozważ użycie multikonta klientów lub multikonta klientów. Zarządzanie kontem MCA na poziomie interfejsu API może być prowadzone za pomocą usługi Konta i umożliwia automatyczne dodawanie subkont i zarządzanie nimi. Więcej informacji na temat uzyskiwania konta multikonta klientów znajdziesz tutaj.

Jak korzystać z interfejsu API

Nie używaj interfejsu API, ponieważ używasz plików danych

Jeśli korzystasz z zasobu products, unikaj codziennego aktualizowania całego pliku danych o produktach. Zamiast tego zaktualizuj tylko te produkty, których dane faktycznie uległy zmianie. Wysyłanie całego pliku danych za pomocą zasobu products pochłania więcej czasu i zasobów zarówno dla Google, jak i dla Ciebie.

Nie używaj interfejsu API do regularnego pobierania przesłanych informacji o produktach.

Jeśli odpowiadasz za utrzymanie informacji o produkcie na określonym koncie Merchant Center, nie wysyłaj regularnie próśb o informacje o produktach z interfejsu Content API za pomocą metod products.get lub products.list. W przypadku klientów przesyłających informacje metody te mogą pomóc w debugowaniu problemów przy projektowaniu rozwiązań wykorzystujących Content API. Nie są one jednak przeznaczone do regularnego pobierania informacji o produktach przez takich klientów. Musisz mieć inne źródło informacji o produktach, np. bazę danych o produktach dostępnych lokalnie, które produkty w Merchant Center powinny odzwierciedlać zawartość tego źródła.

Do przesyłania produktów nie używaj jednocześnie plików danych i Content API

Jeśli rozważasz przejście na interfejs API do przesyłania produktów, sprawdź, czy nie korzystasz już z plików danych do przesyłania produktów. Jeśli nadal będziesz przesyłać produkty w obu medium, mogą wystąpić nieoczekiwane wyniki.

Czy mogę bezpiecznie korzystać z interfejsu API i plików danych?

Możesz zarządzać plikami danych, korzystając z usługi Datafeed Service interfejsu API. Ułatwia to zarządzanie plikami danych na dużą skalę, ale pamiętaj, że nie należy wstawiać ani aktualizować produktów za pomocą interfejsu API jednocześnie z plikami danych, ponieważ może to spowodować nieoczekiwane wyniki.

Oto kilka innych przykładów dopuszczalnych sposobów wspólnego używania plików danych i interfejsu API:

  • Wysyłanie przez interfejs API żądań tylko do odczytu (get lub list): niektórzy sprzedawcy chcą korzystać z interfejsu API do pobierania informacji i aktualizacji stanu produktów. Jest to akceptowalne, ponieważ informacje o produktach są aktualizowane tylko na podstawie plików danych.

  • korzystanie z interfejsu API do zarządzania subkontami (usługa konta) lub ustawieniami podatków i dostawy na poziomie konta (Accounttax i Shippingsettings Service); Te funkcje nie są dostępne w Datafeeds, więc nie ma konfliktu z zarządzaniem tymi funkcjami za pomocą interfejsu API.

Jak przejść z plików danych na korzystanie tylko z interfejsu API lub odwrotnie?

Jeśli obecnie używasz plików danych i chcesz przejść na używanie interfejsu API tylko do aktualizowania produktów, musisz ponownie przesłać dane produktów za pomocą tego interfejsu. Gdy używasz usługi produktów do aktualizacji danego produktu, interfejs API przejmuje kontrolę nad informacjami o produkcie. Usunięcie produktu z pliku danych lub usunięcie samego pliku danych nie spowoduje już usunięcia informacji o produkcie z konta Merchant Center. Jeśli chcesz usunąć produkt z pliku danych lub samego pliku danych, upewnij się, że nie ma żadnych aktualizacji pliku danych. W przeciwnym razie plik danych ponownie przejmie prawo własności, a usunięcie produktu z pliku danych spowoduje usunięcie produktu.

Jeśli obecnie do informacji o produktach używasz interfejsu API i chcesz używać plików danych jako podstawowego źródła informacji o produktach, wystarczy, że dodasz nowy plik danych do swojego konta Merchant Center, a on przejmie prawo własności do wymienionych produktów. Jeśli chcesz usunąć produkty, które chcesz usunąć przed wygaśnięciem, które zostały przesłane wyłącznie za pomocą interfejsu API, musisz usunąć je w Merchant Center lub za pomocą interfejsu API.

Jak za pomocą interfejsu Content API for Shopping kierować produkty na wiele krajów?

Aby kierować reklamy i bezpłatne informacje o produktach przesłanych za pomocą Content API na wiele krajów, skonfiguruj dodatkowe kraje w podstawowym pliku danych Content API w Merchant Center lub dodaj te kraje za pomocą pola shipping w zasobie products.

Poniżej znajdziesz przykład zmiany ustawień podstawowego pliku danych Content API.

Więcej informacji znajdziesz w artykule Kierowanie reklam produktowych i bezpłatnych informacji w wielu krajach.

Sprawdź, czy biblioteki klienta są aktualne

Jeśli do interakcji z interfejsem Content API używasz biblioteki klienta Google, pamiętaj, aby używać menedżera pakietów dla wybranego języka programowania i upewnić się, że wersja biblioteki jest aktualna. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym wybranego języka w sekcji Przykłady i biblioteki.

Użyj atrybutów miejsca docelowe, aby kontrolować, które produkty pojawiają się w różnych programach zakupowych

Content API automatycznie wprowadza domyślne ustawienia pliku danych Content API zgodnie z konfiguracją w Merchant Center. Za pomocą atrybutów produktu includedDestinations lub excludedDestinations możesz kontrolować udział programu na poziomie produktu w pliku danych lub za pomocą Content API.

Jeśli Twój plik danych interfejsu API został zarejestrowany w programie, np. w usłudze Kup przez Google (dawniej Shopping Actions), ale chcesz wykluczyć niektóre produkty, użyj atrybutu excludedDestinations i jako wartość podaj Shopping Actions. Jeśli nie ma błędów, zastąpią one domyślne ustawienia pliku danych z Merchant Center, przez co dany produkt nie pojawi się w usłudze Kup przez Google (dawniej Shopping Actions). Jeśli natomiast Twój plik danych nie został zakwalifikowany do programu, np. w Zakupach Google, możesz uwzględnić poszczególne produkty za pomocą atrybutu includedDestinations i Shopping_ads jako wartości, aby produkt wyświetlał się w reklamach produktowych.

Więcej informacji o atrybutach produktów includedDestinations i excludedDestinations znajdziesz w Centrum pomocy.

Pamiętaj o aktualizacji produktów, zanim wygasną

Jeśli element nie zmieni się przed wygaśnięciem (30 dni po ostatniej aktualizacji lub w określonym dniu ważności, jeśli wcześniej), zaktualizuj go, aby uniknąć jego dezaktywacji. Jeśli musisz zaktualizować wiele elementów, ponieważ żaden z nich się nie zmienił lub nie możesz śledzić, kiedy były ostatnio aktualizowane, nie aktualizuj wszystkich jednocześnie, ale rozkład obciążenia po równo na kilka dni.

Nie usuwaj pliku danych Content API, ponieważ Twoje produkty mogą zniknąć

Po pierwszym przesłaniu produktu za pomocą channel:online za pomocą Content API pojawi się w Merchant Center nowy plik danych o nazwie Content API. Po pierwszym przesłaniu produktu za pomocą channel:local za pomocą Content API pojawi się nowy plik danych o nazwie Content API z podtytułem Produkty dostępne lokalnie w Merchant Center. Sprawdź, czy przypadkowo nie usunięto pliku danych online lub lokalnego pliku danych Content API. W zależności od usuniętego pliku danych produkty online lub produkty dostępne lokalnie dodane do Merchant Center za pomocą Content API zostaną usunięte.

Zbiorcze wysyłanie żądań do tej samej usługi przy użyciu metody custombatch

Zamiast wysyłać wiele żądań sekwencyjnych lub równoległych do tej samej usługi, utwórz jedno żądanie niestandardowe, które będzie zawierać wszystkie żądane żądania. Dzięki temu opóźnienia związane z wysyłaniem żądań do punktu końcowego interfejsu API mają miejsce tylko w przypadku wywołania metody custombatch, a nie dla każdego pojedynczego żądania, co jest szczególnie ważne w przypadku żądań sekwencyjnych.

Nie wysyłaj wielu aktualizacji tego samego elementu w jednej grupie

Wywołuje to nieoczekiwane wyniki ze względu na niepewność co do kolejności aktualizacji i może doprowadzić do błędu konfliktu.

Nie wysyłaj aktualizacji niezmienionych elementów

Pamiętaj, aby wysyłać prośby wyłącznie o nowe, zmienione lub usunięte produkty, chyba że w przeciwnym razie wygasną.

Używanie dodatkowych plików danych w przypadku gwałtownych zmian cen lub dostępności

Jeśli masz problem z aktualizacją ceny, dostępności lub promocji produktu, rozważ skorzystanie z dodatkowych plików danych w zasobie products, aby wysyłać aktualizacje tylko tych atrybutów. Ponieważ aktualizacje dodatkowych plików danych są niewielkie, możesz w danym okresie wprowadzić znacznie więcej aktualizacji tych plików niż pełnych aktualizacji. Dzięki temu ceny i dostępność Twoich produktów będą zgodne z informacjami na stronach docelowych.

Inną metodą aktualizowania ceny i dostępności produktów jest korzystanie z automatycznych aktualizacji produktów. Tej opcji można użyć razem z aktualizacją interfejsu API, aby uniknąć rozbieżności między informacjami w Merchant Center a informacjami na stronach docelowych produktów. Pamiętaj jednak, że celem jest rozwiązanie niewielkich problemów z dokładnością cen i dostępności produktów, więc automatyczne aktualizacje produktów nie zastępują podawania prawidłowych informacji za pomocą interfejsu API.

Kiedy używać tokena odświeżania

Token odświeżania jest zwracany w nagłówku HTTP żądań autoryzacji. Zawiera on wiele innych informacji związanych z uwierzytelnianiem, ale często najbardziej przydatny jest token odświeżania, ponieważ eliminuje konieczność wielokrotnego proszenia użytkownika o uwierzytelnienie, ponieważ tokeny dostępu są ważne tylko przez 60 minut przed wygaśnięciem.