W tym dokumencie znajdziesz wytyczne dotyczące sprawdzonych metod. Więcej informacji znajdziesz w sekcji Wskazówki dotyczące skuteczności.
Kiedy używać interfejsu API
Wysyłanie żądań programowo
Niezależnie od tego, czy wolisz zautomatyzować każdy element przepływu pracy, czy utworzyć połączenie z systemem ERP (Enterprise Resource Planning), Content API umożliwia wysyłanie aktualizacji natychmiast po zmianie asortymentu.
Aby otrzymywać natychmiastowe informacje zwrotne
W Content API otrzymujesz odpowiedź na każde żądanie od razu, a nie w e-mailu z podsumowaniem po przetworzeniu plików danych. W przypadku żądań o dużych wielkościach wsadu oczekiwane jest opóźnienie od 5 do 10 sekund.
Częste zmienianie danych produktów
Interfejs Content API umożliwia wielokrotne w ciągu dnia przyrostowe aktualizowanie asortymentu produktów, które szybko się sprzedają, podczas gdy przesyłanie całego pliku danych za każdym razem jest niemożliwe. Jeśli aktualizacje są dostępne pojedynczo, wysyłaj je pojedynczo. Nie czekaj, aż będzie ich kilka, aby wysłać je zbiorczo. Podobnie jeśli aktualizacje są dostępne w partiach, wysyłaj je w partiach, a nie w postaci pojedynczych żądań.
Zarządzanie kilkoma subkontami
Nowo utworzone konta Merchant Center są pojedynczymi kontami, które zawierają własny zestaw danych produktów. W większości przypadków to wystarcza, ale w miarę rozwoju konta może się okazać, że potrzebujesz bardziej złożonego systemu zarządzania produktami. Jeśli tak jest w Twoim przypadku, rozważ użycie multikonta klientów (MCA). Zarządzanie kontem MCK na poziomie interfejsu API można prowadzić za pomocą usługi Konta. Umożliwia ona programowe dodawanie kont podrzędnych i zarządzanie nimi. Więcej informacji o tym, jak uzyskać konto MCA, znajdziesz tutaj.
Jak korzystać z interfejsu API
Nie używaj interfejsu API w taki sam sposób jak plików danych.
Unikaj codziennych aktualizacji całego pliku danych o produktach, gdy korzystasz z zasobu products.
Zamiast tego aktualizuj tylko te produkty, których dane faktycznie się zmieniły. Przesyłanie całego pliku danych za pomocą zasobu products zajmuje więcej czasu i wymaga większych zasobów zarówno po stronie Google, jak i po Twojej stronie.
Nie używaj interfejsu API do regularnego pobierania przesłanych informacji o produktach.
Jeśli odpowiadasz za aktualizowanie informacji o produktach na określonym koncie Merchant Center, unikaj regularnego wysyłania zapytań o informacje o produktach do Content API za pomocą metod products.get lub products.list. W przypadku klientów, którzy przesyłają informacje, te metody mogą pomóc w debugowaniu problemów podczas projektowania rozwiązań korzystających z Content API. Nie są one jednak przeznaczone do regularnego pobierania informacji o produktach przez takie usługi. Musisz mieć inne źródło informacji o produktach, np. lokalną bazę danych produktów, a produkty w Merchant Center powinny odzwierciedlać zawartość tego źródła.
Nie używaj plików danych i interfejsu Content API do przesyłania produktów.
Jeśli rozważasz przejście na interfejs API do przesyłania produktów, upewnij się, że nie używasz już plików danych do przesyłania produktów. Jeśli nadal będziesz przesyłać produkty w obu tych mediach, mogą wystąpić nieoczekiwane wyniki.
Czy mogę bezpiecznie korzystać z interfejsu API i plików danych?
Możesz manipulować plikami danych za pomocą usługi Datafeed API. Ułatwi to zarządzanie plikami danych na dużą skalę, ale pamiętaj, że nie należy wstawiać ani aktualizować produktów za pomocą interfejsu API równocześnie z plikami danych, ponieważ może to spowodować nieoczekiwane wyniki.
Oto kilka innych przykładów dopuszczalnych sposobów wspólnego korzystania z plików danych i interfejsu API:
Wykonywanie żądań tylko do odczytu (get lub list) z interfejsu API: niektórzy sprzedawcy chcą używać interfejsu API do pobierania informacji i aktualizacji stanu swoich produktów. Jest to dopuszczalne, ponieważ informacje o produktach są aktualizowane tylko przez pliki danych.
Korzystanie z interfejsu API do zarządzania kontami podrzędnymi (usługa Accounts) lub ustawieniami podatków i dostawy na poziomie konta (usługa Accounttax i usługa Shippingsettings). Te funkcje nie są dostępne w przypadku plików danych, więc nie ma konfliktu z używaniem interfejsu API do zarządzania nimi.
Jak przejść z korzystania z plików danych na korzystanie tylko z interfejsu API lub odwrotnie?
Jeśli obecnie używasz plików danych i chcesz przejść na aktualizowanie produktów wyłącznie za pomocą interfejsu API, musisz ponownie przesłać dane produktów za pomocą interfejsu API. Gdy używasz usługi products do aktualizowania danego produktu, interfejs API przejmuje kontrolę nad informacjami o produkcie, a usunięcie produktu z pliku danych lub usunięcie samego pliku danych nie spowoduje już usunięcia informacji o produkcie z konta Merchant Center. Upewnij się, że nie ma aktualizacji pliku danych, jeśli chcesz usunąć produkt z pliku danych lub sam plik danych. W przeciwnym razie plik danych ponownie przejmie własność, a usunięcie produktu z pliku danych spowoduje usunięcie produktu.
Jeśli obecnie używasz tylko interfejsu API do przesyłania informacji o produktach i chcesz używać plików danych jako głównego źródła informacji o produktach, możesz po prostu dodać nowy plik danych do konta Merchant Center. Wtedy przejmie on własność wymienionych produktów. Jeśli chcesz usunąć produkty przed wygaśnięciem, które zostały przesłane wyłącznie z interfejsu API, musisz je usunąć w Merchant Center lub za pomocą interfejsu API.
Jak kierować produkty na wiele krajów za pomocą interfejsu Content API for Shopping?
Aby kierować reklamy i bezpłatne informacje na wiele krajów w przypadku produktów przesłanych za pomocą Content API, skonfiguruj dodatkowe kraje w podstawowym pliku danych Content API w Merchant Center lub dodaj te dodatkowe kraje za pomocą pola shipping w zasobie products.
Poniżej znajdziesz przykład modyfikowania ustawień podstawowego pliku danych interfejsu Content API.
Więcej informacji znajdziesz w artykule Kierowanie reklam produktowych i bezpłatnych informacji na wiele krajów.
Sprawdź, czy biblioteki klienta są aktualne
Jeśli do interakcji z Content API używasz biblioteki klienta Google, użyj menedżera pakietów w wybranym języku programowania i upewnij się, że wersja biblioteki jest aktualna. Więcej informacji znajdziesz w przewodniku dla deweloperów w wybranym języku w sekcji Przykłady i biblioteki.
Używaj atrybutów miejsc docelowych, aby kontrolować, które produkty pojawiają się w różnych programach zakupowych.
Interfejs Content API automatycznie przyjmuje domyślne ustawienia pliku danych Content API skonfigurowane w Merchant Center. Możesz użyć atrybutów produktu includedDestinations lub excludedDestinations, aby kontrolować udział w programie na poziomie produktu w pliku danych lub za pomocą interfejsu Content API.
Jeśli Twój plik danych API został włączony do programu, np. Kup przez Google (wcześniej Shopping Actions), ale chcesz wykluczyć niektóre produkty, użyj atrybutu excludedDestinations i podaj wartość Shopping Actions. Jeśli nie ma błędów, zastąpi to domyślne ustawienia pliku danych w Merchant Center, a dany produkt nie będzie wyświetlany w Kup przez Google (wcześniej znanym jako Shopping Actions). Jeśli Twój plik danych nie został włączony do programu, np. Zakupy Google, możesz dodać poszczególne produkty, używając atrybutu includedDestinations i wartości Shopping_ads. Produkt będzie się wtedy wyświetlać w reklamach produktowych.
Więcej informacji o atrybutach produktów includedDestinations i excludedDestinations znajdziesz w Centrum pomocy.
Pamiętaj, aby aktualizować produkty przed upływem ich ważności
Jeśli produkt nie zmieni się przed upływem 30 dni od ostatniej aktualizacji lub przed określoną datą ważności (w zależności od tego, co nastąpi wcześniej), zaktualizuj go, aby uniknąć jego dezaktywacji. Jeśli musisz zaktualizować wiele produktów, ponieważ żaden z nich nie uległ zmianie lub nie możesz śledzić, kiedy były ostatnio aktualizowane, nie aktualizuj wszystkich produktów w tym samym czasie, ale rozłóż obciążenie równomiernie na kilka dni.
Nie usuwaj pliku danych Content API, bo w przeciwnym razie Twoje produkty mogą zniknąć.
Gdy po raz pierwszy prześlesz produkt z atrybutem channel:online za pomocą Content API, w Merchant Center pojawi się nowy plik danych o nazwie Content API. Gdy po raz pierwszy prześlesz produkt z atrybutem channel:local za pomocą Content API, w Merchant Center pojawi się nowy plik danych o nazwie Content API z podtytułem Produkty lokalne. Uważaj, aby nie usunąć przypadkowo pliku danych Content API online lub lokalnego. W zależności od tego, który plik danych usuniesz, produkty online lub lokalne dodane do Merchant Center za pomocą Content API zostaną usunięte.
Wysyłanie wielu żądań do tej samej usługi w ramach jednego żądania zbiorczego za pomocą metody custombatch
Zamiast wysyłać wiele kolejnych lub równoległych żądań do tej samej usługi, wyślij jedno żądanie custombatch zawierające wszystkie żądane żądania. Dzięki temu opóźnienie związane z wysyłaniem żądań do punktu końcowego interfejsu API występuje tylko raz w przypadku wywołania custombatch, a nie w przypadku każdego pojedynczego żądania, co jest szczególnie ważne, jeśli wysyłasz żądania sekwencyjne.
Nie wysyłaj wielu aktualizacji dotyczących jednego produktu w jednej partii.
Spowoduje to nieoczekiwane wyniki ze względu na niepewność co do kolejności aktualizacji i może spowodować błąd konfliktu.
Nie wysyłaj aktualizacji dotyczących niezmienionych produktów
Upewnij się, że wysyłasz żądania tylko w przypadku nowych, zmienionych lub usuniętych produktów, chyba że w przeciwnym razie wygasną.
Używaj dodatkowych plików danych, jeśli ceny lub dostępność szybko się zmieniają.
Jeśli masz problem z aktualizowaniem ceny, dostępności lub informacji o wyprzedaży produktu, rozważ użycie dodatkowych plików danych w zasobie products, aby przesyłać aktualizacje tylko tych atrybutów. Aktualizacje dodatkowego pliku danych są niewielkie, więc w danym okresie możesz wprowadzić ich znacznie więcej niż pełnych aktualizacji produktów. Dzięki temu ceny i dostępność produktów będą zgodne z informacjami na stronach docelowych.
Innym sposobem aktualizowania ceny i dostępności produktu jest korzystanie z automatycznych aktualizacji produktów. Można go używać w połączeniu z aktualizacjami API, aby uniknąć niezgodności między informacjami w Merchant Center a informacjami na stronach docelowych produktów. Pamiętaj jednak, że to rozwiązanie ma na celu naprawianie drobnych problemów z dokładnością informacji o cenie i dostępności produktu, 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 token odświeżania jest często tym, na czym zależy deweloperom, ponieważ eliminuje konieczność wielokrotnego proszenia użytkownika o uwierzytelnienie, ponieważ tokeny dostępu wygasają po 60 minutach.