Ten dokument zawiera wskazówki dotyczące sprawdzonych metod. Więcej informacji znajdziesz w wskazówkach dotyczących wydajności.
Kiedy używać interfejsu API
Wysyłanie żądań programowo
Niezależnie od tego, czy wolisz zautomatyzować każdą część procesu, czy też chcesz utworzyć element łączący z systemem ERP (planowania zasobów przedsiębiorstwa), Content API umożliwia wysyłanie aktualizacji zaraz po zmianie asortymentu.
Aby uzyskać natychmiastowe informacje zwrotne
W Content API odpowiedź na każde żądanie otrzymujesz natychmiast, a nie w ramach podsumowania e-maila po przetworzeniu plików danych. W przypadku dużych żądań zbiorczych należy się spodziewać opóźnienia 5–10 sekund.
Często zmieniać dane produktów
Dzięki interfejsowi Content API możesz wprowadzać przyrostowe aktualizacje asortymentu produktów szybko sprzedających się produktów wiele razy dziennie, podczas gdy 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ż uzbiera się ich kilka, aby wysłać je w grupie. Jeśli aktualizacje są dostępne w partiach, wysyłaj je w partiach, a nie dziel na poszczególne żądania.
Zarządzanie kilkoma subkontami
Nowo utworzone konta Merchant Center są pojedynczymi kontami, które zawierają własny zestaw danych o produktach. W większości przypadków sprawdza się to dobrze, ale wraz z rozwojem konta może się okazać, że potrzebujesz bardziej złożonego systemu zarządzania produktami. W takim przypadku rozważ użycie multikonta klientów (MCA). Zarządzanie kontem MCA na poziomie interfejsu API jest możliwe za pomocą usługi Konta. Umożliwia to automatyczne dodawanie subkont 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 tak, jak plików danych
Jeśli używasz zasobu products, unikaj codziennego aktualizowania całego pliku danych o produktach.
Zamiast tego aktualizuj tylko te produkty, których dane się zmieniły. Przesyłanie całego pliku danych za pomocą zasobu products wymaga więcej czasu i zasobów zarówno od Google, jak i od Ciebie.
Nie używaj interfejsu API do regularnego pobierania przesłanych przez siebie informacji o produktach.
Jeśli odpowiadasz za aktualizowanie informacji o produktach na konkretnym koncie Merchant Center, nie wysyłaj regularnie żądań o informacje o produktach za pomocą metod products.get lub products.list interfejsu Content API. W przypadku klientów, którzy przesyłają informacje, te metody mogą pomóc Ci w rozwiązywaniu problemów podczas projektowania rozwiązań korzystających z 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. lokalną bazę danych produktów, a produkty w Merchant Center powinny odzwierciedlać zawartość tego źródła.
Nie używaj plików danych ani Content API do przesyłania produktów
Jeśli rozważasz przejście na przesyłanie produktów za pomocą interfejsu API, upewnij się, że nie używasz już plików danych do przesyłania produktów. Jeśli nadal będziesz przesyłać elementy w obu tych formatach, mogą wystąpić nieoczekiwane wyniki.
Czy istnieje sposób na bezpieczne używanie interfejsu API i plików danych jednocześnie?
Za pomocą usługi danych interfejsu API możesz manipulować plikami danych. Chociaż znacznie ułatwi to zarządzanie plikami danych, 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 akceptowalnych sposobów korzystania z plików danych i interfejsu API:
Wykonywanie żądań tylko do odczytu (GET lub LIST) za pomocą 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 za pomocą plików danych.
Korzystanie z interfejsu API do zarządzania subkontami (Accounts Service) lub ustawieniami podatków i dostawy na poziomie konta (Accounttax Service i Shippingsettings Service). Nie są to funkcje, które mogą być udostępniane przez pliki danych, więc nie ma konfliktu z używaniem interfejsu API do zarządzania tymi funkcjami.
Jak przejść z korzystania z plików danych na korzystanie tylko z interfejsu API lub odwrotnie?
Jeśli obecnie korzystasz z plików danych i chcesz zaktualizować produkty tylko za pomocą interfejsu API, musisz ponownie przesłać dane produktów za pomocą interfejsu API. Gdy używasz usługi produktów do aktualizowania danego produktu, interfejs API przejmuje kontrolę nad informacjami o produkcie. Usunięcie produktu z pliku danych lub samego pliku danych nie spowoduje już usunięcia informacji o produkcie z konta Merchant Center. Jeśli chcesz usunąć produkt z pliku danych lub sam plik danych, upewnij się, że nie ma żadnych aktualizacji pliku danych. W przeciwnym razie plik danych przejmie własność produktu, a usunięcie produktu z pliku danych spowoduje jego usunięcie.
Jeśli obecnie używasz tylko interfejsu API do informacji o produktach i chcesz używać plików danych jako podstawowego źródła informacji o produktach, możesz po prostu dodać nowy plik danych do swojego konta Merchant Center, a produkty zostaną przypisane do właściciela. Jeśli chcesz usunąć produkty przesłane wyłącznie za pomocą interfejsu API przed ich wygaśnięciem, musisz je usunąć za pomocą Merchant Center lub interfejsu API.
Jak kierować produkty na wiele krajów za pomocą Content API for Shopping?
Aby kierować reklamy i bezpłatne informacje o produktach przesyłane za pomocą Content API na wiele krajów, skonfiguruj dodatkowe kraje w podstawowym pliku danych Content API w Merchant Center lub dodaj je za pomocą pola shipping w zasobach products.
Poniżej znajdziesz przykład modyfikacji ustawień podstawowego pliku danych Content API.
Więcej informacji znajdziesz w artykule Ukierunkowanie 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, korzystaj z menedżera pakietów dla wybranego języka programowania i upewnij się, że wersja biblioteki jest aktualna. Więcej informacji znajdziesz w przewodniku dla deweloperów na temat wybranego języka w sekcji Próbki i biblioteki.
Używaj atrybutów miejsc docelowych, aby kontrolować, które produkty wyświetlają się w różnych programach zakupowych.
Interfejs Content API automatycznie stosuje domyślne ustawienia pliku danych Content API zgodnie z konfiguracją 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 interfejsu API jest włączony w programie, np. Kup przez Google (dawniej Shopping Actions), ale chcesz wykluczyć z niego określone produkty, użyj atrybutu excludedDestinations i jako wartości podaj Shopping Actions. Jeśli nie wystąpią żadne błędy, spowoduje to zastąpienie domyślnych ustawień pliku danych w Merchant Center i dany produkt nie będzie widoczny w Kup przez Google (dawniej Shopping Actions). Jeśli jednak Twój plik danych nie jest objęty programem, np. Zakupami Google, możesz uwzględnić w nim poszczególne produkty, używając atrybutu includedDestinations i wartości Shopping_ads. Produkty te będą się wyświetlać w reklamach produktowych.
Więcej informacji o atrybutach produktów includedDestinations i excludedDestinations znajdziesz w Centrum pomocy.
Pamiętaj, aby aktualizować elementy przed ich wygaśnięciem.
Jeśli produkt nie ulegnie zmianie przed wygaśnięciem, zaktualizuj go 30 dni po ostatniej aktualizacji lub w określonym dniu ważności, jeśli nastąpi to wcześniej. Jeśli musisz zaktualizować wiele elementów, ponieważ żaden z nich się nie zmienił lub nie możesz śledzić, kiedy zostały one ostatnio zaktualizowane, nie aktualizuj wszystkich elementów w tym samym czasie, ale rozłóż to równomiernie na kilka dni.
Nie usuwaj pliku danych Content API, ponieważ może to spowodować zniknięcie Twoich produktów.
Gdy po raz pierwszy prześlesz produkt za pomocą interfejsu 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 użyciem channel:local za pomocą Content API, w Merchant Center pojawi się nowy plik danych o nazwie Content API z podtytułem Produkty lokalne. Upewnij się, że nie usuniesz przez przypadek pliku danych Content API online ani lokalnego. W zależności od tego, który plik danych usuniesz, zostaną usunięte produkty online lub produkty dostępne lokalnie dodane do Merchant Center za pomocą Content API.
Wysyłanie wielu żądań do tego samego serwisu za pomocą metody custombatch
Zamiast wysyłać wiele sekwencyjnych lub równoległych żądań do tej samej usługi, prześlij pojedyncze żądanie zbiorcze, które zawiera wszystkie żą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 metody custombatch, a nie dla każdego żądania z osobna. Jest to szczególnie ważne, jeśli wysyłasz żądania sekwencyjnie.
Nie wysyłaj wielu aktualizacji jednego produktu w ramach jednej partii
Może to spowodować nieoczekiwane wyniki z powodu niepewności co do kolejności aktualizacji i może wywołać błąd konfliktu.
Nie wysyłaj aktualizacji dotyczących niezmienionych elementów.
Wysyłaj żądania tylko w przypadku nowych, zmienionych lub usuniętych produktów, chyba że mają one wygasnąć.
Używaj dodatkowych plików danych, jeśli ceny lub dostępność zmieniają się szybko
Jeśli masz problem z aktualizowaniem informacji o cenie, dostępności lub cenie promocyjnej produktu, rozważ użycie dodatkowych plików danych w zasobach products, aby wysyłać aktualizacje tylko tych atrybutów. Aktualizacje dodatkowego pliku danych są niewielkie, więc możesz w danym okresie wprowadzić więcej takich aktualizacji 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 cen i dostępności produktów jest korzystanie z automatycznych aktualizacji produktów. Można go używać oprócz aktualizacji interfejsu API, aby uniknąć niezgodności między informacjami w Merchant Center a informacjami na stronach docelowych produktów. Pamiętaj jednak, że ta funkcja ma na celu rozwiązywanie drobnych problemów z dokładnością informacji o cenie i dostępności produktów, więc automatyczne aktualizacje produktów nie zastępują prawidłowego podawania 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 ona wiele innych informacji związanych z uwierzytelnianiem, ale token odświeżania jest często elementem, który deweloperzy chcą uzyskać, ponieważ eliminuje konieczność wielokrotnego wyświetlania użytkownikowi prośby o uwierzytelnienie, ponieważ tokeny dostępu wygasają po 60 minutach.