Ten dokument zawiera wskazówki dotyczące sprawdzonych metod. Więcej informacji znajdziesz we wskazówkach dotyczących skuteczności.
Kiedy używać interfejsu API
Automatyczne wysyłanie żądań
Niezależnie od tego, czy wolisz automatyzować każdy etap przepływu pracy, czy też chcesz przygotować się do korzystania z systemu ERP (Enterprise Resource Planning), Content API umożliwia wysyłanie aktualizacji natychmiast po zmianie asortymentu.
Aby otrzymać natychmiastową opinię
Interfejs Content API odpowiada na każde żądanie natychmiast, a nie w e-mailu z podsumowaniem po przetworzeniu plików danych. W przypadku dużych żądań zbiorczych należy spodziewać się opóźnień 5–10 sekund.
Aby często zmieniać dane produktów
Dzięki Content API możesz wprowadzać stopniowe aktualizacje w szybko zmieniającym się asortymencie produktów wiele razy w ciągu dnia, natomiast wysyłanie całego pliku danych za każdym razem jest niemożliwe. Jeśli aktualizacje będą dostępne pojedynczo, wysyłaj je pojedynczo, nie czekaj, aż pojawi się kilka aktualizacji, aby móc je połączyć zbiorczo. Podobnie, jeśli aktualizacje są dostępne partiami, wysyłaj je partiami, ale nie dziel ich na osobne żądania.
Aby zarządzać kilkoma subkontami:
Nowo utworzone konta Merchant Center to pojedyncze konta, które przechowują własny zestaw danych produktów. W większości przypadków takie rozwiązanie sprawdza się, ale w miarę rozwoju konta może się okazać, że potrzebujesz bardziej złożonego systemu zarządzania produktami. W takim przypadku warto użyć multikonta klientów (MCA). Do zarządzania kontem MCA na poziomie interfejsu API służy usługa Konta. Pozwala to na automatyczne dodawanie subkont i zarządzanie nimi. Więcej informacji o uzyskiwaniu konta MCA 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 aktualizuj tylko te usługi, których dane rzeczywiście się zmieniły. Wysyłanie całego pliku danych za pomocą zasobu products pochłania więcej czasu i zasobów zarówno Google, jak i Ciebie.
Nie używaj interfejsu API do regularnego pobierania przesłanych przez siebie informacji o produktach
Jeśli odpowiadasz za zachowanie informacji o produkcie na konkretnym koncie Merchant Center, unikaj regularnego wysyłania próśb o informacje o produktach do Content API za pomocą metod products.get lub products.list. W przypadku klientów przesyłających informacje te metody mogą pomóc w debugowaniu problemów podczas projektowania rozwiązań korzystających z Content API. Nie służą one jednak do regularnego pobierania informacji o produktach przez takich klientów. Musisz mieć inne źródło informacji o produktach, na przykład bazę danych o produktach dostępnych lokalnie, a produkty w Merchant Center powinny odzwierciedlać zawartość tego źródła.
Nie używaj jednocześnie plików danych i Content API do przesyłania produktów
Jeśli rozważasz przejście na interfejs API w przypadku przesyłania produktów, sprawdź, czy do przesyłania produktów nie używasz już plików danych. Jeśli będziesz przesyłać produkty za pomocą obu tych metod, mogą wystąpić nieoczekiwane rezultaty.
Czy mogę bezpiecznie korzystać jednocześnie z interfejsu API i plików danych?
Pliki danych można edytować za pomocą dostępnej w interfejsie API usługi Datafeed Service. Chociaż znacznie ułatwi to zarządzanie plikami danych na dużą skalę, 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 rezultaty.
Inne przykłady dopuszczalnych sposobów wspólnego korzystania z plików danych i interfejsu API to:
Wysyłanie za pomocą interfejsu API żądań w trybie tylko do odczytu (get lub list): niektórzy sprzedawcy chcą używać interfejsu API do pobierania informacji i aktualizacji stanu produktów. Jest to akceptowalne, ponieważ informacje o produktach są aktualizowane tylko za pomocą plików danych.
Korzystanie z interfejsu API do zarządzania subkontami (usługa Kont Google) lub ustawieniami podatków i dostawy na poziomie konta (Accounttax Service i Shippingsettings). Pliki danych nie mogą nimi obsługiwać, dlatego nie ma konfliktu między nimi a interfejsem API do zarządzania tymi funkcjami.
Jak przejść z plików danych na korzystanie tylko z interfejsu API lub odwrotnie?
Jeśli korzystasz obecnie z plików danych i chcesz, aby aktualizować produkty wyłącznie za pomocą interfejsu API, musisz ponownie przesłać dane produktów za pomocą tego interfejsu. Gdy aktualizujesz dany produkt za pomocą usługi produktów, interfejs API przejmuje kontrolę nad informacjami o produkcie, a usunięcie produktu z pliku danych lub samego pliku danych nie spowoduje już usunięcia informacji o produkcie z Twojego konta Merchant Center. Jeśli chcesz usunąć produkt z pliku danych lub samego pliku danych, upewnij się, że nie ma żadnych aktualizacji. 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 używasz tylko interfejsu API do przekazywania informacji o produktach i chcesz używać plików danych jako podstawowego źródła informacji o produktach, po prostu dodaj nowy plik danych do swojego konta Merchant Center, a on przejmie własność wymienionych produktów. Jeśli chcesz usunąć produkty przed wygaśnięciem ważności, które zostały przesłane wyłącznie za pomocą interfejsu API, musisz je usunąć w Merchant Center lub przez interfejs API.
Jak kierować produkty za pomocą interfejsu Content API for Shopping na wiele krajów?
Aby kierować reklamy i bezpłatne informacje produktów przesył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 Content API używasz biblioteki klienta Google, sprawdź, czy używasz menedżera pakietów dla wybranego języka programowania i czy jej wersja jest aktualna. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym wybranego języka w sekcji Sample i biblioteki.
Użyj atrybutów miejsc docelowych, aby kontrolować, które produkty wyświetlają się w różnych programach Zakupów Google
Content API automatycznie zastosuje domyślne ustawienia pliku danych Content API skonfigurowane w Merchant Center. Za pomocą atrybutów produktu includedDestinations lub excludedDestinations możesz kontrolować udział w programie na poziomie produktu w pliku danych lub za pomocą Content API.
Jeśli Twój plik danych API został włączony do programu, np. Kup przez Google (dawniej Shopping Actions), ale chcesz wykluczyć określone produkty, użyj atrybutu excludedDestinations i jako jego wartość podaj Shopping Actions. Jeśli nie będzie błędów, zastąpią one domyślne ustawienia pliku danych w Merchant Center, a dany produkt nie będzie wyświetlany w usłudze Kup przez Google (dawniej Shopping Actions). Jeśli natomiast Twój plik danych nie jest zarejestrowany w programie, np. w Zakupach Google, możesz uwzględnić w raporcie poszczególne produkty, używając atrybutu includedDestinations oraz Shopping_ads jako wartości. Wtedy produkt pojawi się w reklamach produktowych.
Więcej informacji o atrybutach produktów includedDestinations i excludedDestinations znajdziesz w Centrum pomocy.
Pamiętaj, aby zaktualizować produkty, zanim wygasną
Jeśli produkt nie zostanie zmieniony przed jego wygaśnięciem, po 30 dniach od ostatniej aktualizacji lub w podanym terminie ważności, jeśli nastąpi wcześniej, zaktualizuj produkt, aby uniknąć dezaktywacji. Jeśli musisz zaktualizować wiele elementów, ponieważ żaden z nich się nie zmienił lub nie możesz śledzić ostatniej aktualizacji, nie aktualizuj wszystkich elementów jednocześnie, lepiej rozłóż obciążenie po równo na wiele dni.
Nie usuwaj pliku danych Content API, bo Twoje produkty mogą zniknąć
Gdy po raz pierwszy prześlesz produkt z 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 za pomocą atrybutu channel:local za pomocą Content API, w Merchant Center pojawi się nowy plik danych o nazwie Content API z podtytułem Produkty dostępne lokalnie. Uważaj, aby przypadkowo nie usunąć pliku danych online
lub lokalnego pliku danych Content API. W zależności od usuniętego pliku danych produkty online lub lokalne dodane do Merchant Center za pomocą Content API zostaną usunięte.
Zgrupuj wiele żądań do tej samej usługi przy użyciu metody custombatch
Zamiast wysyłać wiele sekwencyjnych lub równoległych żądań do tej samej usługi, utwórz pojedyncze żądanie custombatch, które zawiera wszystkie żądane żądania. Dzięki temu czas oczekiwania na wysyłanie żądań do punktu końcowego interfejsu API występuje tylko raz dla wywołania custombatch, a nie dla każdego pojedynczego żądania, co jest szczególnie ważne w przypadku żądań sekwencyjnych.
Nie wysyłaj wielu aktualizacji do jednego produktu w jednej partii
Z powodu niepewności co do sekwencji aktualizacji wywoła to nieoczekiwane wyniki i może wywołać błąd konfliktu.
Nie wysyłaj aktualizacji niezmienionych elementów
Pamiętaj, aby wysyłać tylko prośby dotyczące nowych, zmienionych lub usuniętych produktów, chyba że ważność tych produktów wygaśnie.
Użyj dodatkowych plików danych, jeśli ceny lub dostępność gwałtownie się zmieniają
Jeśli masz trudności z aktualizacją informacji o cenie, dostępności lub wyprzedaży produktu, możesz skorzystać z dodatkowych plików danych w zasobie products, aby przesłać aktualizacje dotyczące tylko tych atrybutów. Aktualizacje dodatkowego pliku danych są niewielkie, dlatego w danym okresie możesz wprowadzić ich znacznie więcej niż pełne aktualizacje produktów. Dzięki temu ceny i dostępność Twoich produktów będą zgodne z informacjami na stronach docelowych.
Innym sposobem aktualizowania cen i dostępności produktów jest użycie automatycznych aktualizacji produktów. Można ich używać razem z aktualizacjami interfejsu API, aby uniknąć niezgodności między informacjami w Merchant Center a informacjami na stronach docelowych produktów. Pamiętaj jednak, że ma to na celu rozwiązanie niewielkich problemów z dokładnością informacji o cenie i dostępności, więc automatyczne aktualizacje produktów nie zastępują podawania prawidłowych informacji przez interfejs 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 elementem, z którym deweloperzy chcą się wykazać, ponieważ nie muszą już wielokrotnie prosić użytkownika o uwierzytelnienie, ponieważ tokeny dostępu są ważne tylko 60 minut przed wygaśnięciem.