Sprawdzone metody

Ten przewodnik zawiera sprawdzone metody, które możesz wdrożyć, aby zoptymalizować wydajność i skuteczność aplikacji.

Zarządzanie aplikacją

Aby mieć pewność, że aplikacja będzie działać bez zakłóceń, wykonaj te czynności:

  • Upewnij się, że lista właścicieli i edytujących projekt Google Cloud jest aktualna. Będziemy kontaktować się z tymi użytkownikami w nagłych przypadkach lub w sprawach związanych ze zgodnością z Warunkami korzystania z interfejsu API. Jeśli nie będziemy mogli skontaktować się z Tobą w sprawie zgodności z Warunkami korzystania z interfejsu API, Twój dostęp do interfejsu API może zostać ograniczony lub cofnięty.

  • Aby otrzymywać informacje o problemach, takich jak zmiany w usłudze, przerwy w działaniu spowodowane konserwacją i daty wycofania, zasubskrybuj nasz blog o interfejsie API i blog o usłudze.

  • Zadbaj o to, aby Twoja aplikacja była zgodna z Warunkami korzystania z interfejsu Google Ads API. W razie potrzeby zespół ds. zgodności interfejsu API skontaktuje się z właścicielami i edytorami Twojego projektu Google Cloud, którzy mają dostęp do interfejsu API. Jeśli masz pytania lub wątpliwości dotyczące Warunków korzystania z usługi, możesz skontaktować się z zespołem ds. zgodności, odpowiadając na e-maila, którego wysłał, gdy rozpatrywał Twoją prośbę o dostęp do interfejsu API.

Optymalizacja

Możesz zoptymalizować aplikację, wykonując operacje zbiorcze i, w stosownych przypadkach, wysyłając obiekty rozproszone.

Operacje wsadowe

Wysłanie żądania do interfejsu API wiąże się z szeregiem stałych kosztów, takich jak opóźnienie sieci w obie strony, przetwarzanie serializacji i deserializacji oraz wywołania systemów backendu. Aby zmniejszyć wpływ tych stałych kosztów i zwiększyć ogólną skuteczność, większość metod mutate w interfejsie API została zaprojektowana tak, aby akceptować tablicę operacji. Grupując wiele operacji w każdym żądaniu, możesz zmniejszyć liczbę wysyłanych żądań i związane z nimi koszty stałe. Jeśli to możliwe, unikaj wysyłania żądań z tylko jedną operacją.

Załóżmy na przykład, że dodajesz do kampanii 50 000 słów kluczowych w różnych grupach reklam. Zamiast wysyłać 50 000 żądań, z których każde zawiera 1 słowo kluczowe, wyślij 100 żądań, z których każde zawiera 500 słów kluczowych, lub nawet 10 żądań, z których każde zawiera 5000 słów kluczowych. Liczba operacji dozwolonych w żądaniu jest ograniczona, więc aby uzyskać optymalną wydajność, może być konieczne dostosowanie rozmiaru zbioru.

Wysyłanie obiektów rozproszonych

Gdy obiekty są wysyłane do interfejsu API, pola muszą zostać zdeserializowane, zweryfikowane i zapisane w bazie danych. Przekazywanie pełnych obiektów, gdy chcesz zaktualizować tylko kilka pól, może wydłużyć czas przetwarzania i zmniejszyć wydajność. Aby temu zapobiec, interfejs Google Ads API obsługuje rozproszone aktualizacje, co pozwala wypełniać tylko te pola w obiekcie, które chcesz zmienić lub które są wymagane. Aktualizacje rozproszone są przetwarzane szybciej i rzadziej powodują błędy. Pola, których nie ma w obiekcie update_mask (znanym też jako FieldMask), pozostają bez zmian.

Na przykład aplikacja, która aktualizuje stawki na poziomie słowa kluczowego, może korzystać z aktualizacji rozproszonych, ponieważ trzeba wypełnić tylko pola identyfikatora grupy reklam, identyfikatora kryterium i stawek.

Obsługa błędów i zarządzanie nimi

Podczas tworzenia aplikacji prawdopodobnie napotkasz błędy. W tej sekcji opisujemy kwestie i strategie związane z wbudowaniem zarządzania błędami w aplikację. Oprócz tej sekcji zapoznaj się z przewodnikiem po rozwiązywaniu problemów, aby dowiedzieć się więcej o zarządzaniu błędami.

Rozróżnianie źródeł żądań

Niektóre aplikacje są głównie interaktywne i wywołują interfejs API bezpośrednio w odpowiedzi na działania użytkownika w interfejsie. Inne działają głównie offline, wysyłając wywołania interfejsu API w ramach okresowego procesu backendu. Wiele aplikacji łączy te 2 metody. Podczas rozważania zarządzania błędami warto rozróżnić te różne typy żądań.

W przypadku żądań inicjowanych przez użytkownika głównym celem powinno być zapewnienie użytkownikom dobrego wrażenia. Użyj konkretnego błędu, który wystąpił, aby przekazać użytkownikowi jak najwięcej kontekstu w interfejsie. Podaj jasne instrukcje, jak rozwiązać problem (patrz sugestie poniżej).

W przypadku żądań inicjowanych w backendzie zaimplementuj moduły obsługi różnych typów błędów, które mogą wystąpić w aplikacji. Zawsze uwzględniaj domyślny moduł obsługi, aby rozwiązywać rzadkie lub wcześniej nienapotkane błędy. Dobrym podejściem w przypadku domyślnego modułu obsługi jest dodanie nieudanej operacji i błędu do kolejki, aby operator mógł je sprawdzić i określić odpowiednie rozwiązanie.

Rozróżnianie typów błędów

Znajomość różnic między typami błędów w interfejsie Google Ads API ma kluczowe znaczenie dla skutecznej obsługi błędów. Najczęstsze typy błędów:

Więcej informacji znajdziesz w sekcjach Typy błędów i Typowe błędy.

Synchronizowanie backendów

Jeśli użytkownicy Twojej aplikacji mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, o których aplikacja nie wie, co może spowodować utratę synchronizacji lokalnej bazy danych aplikacji. Jak wspomnieliśmy w przewodniku Typy błędów, możesz reagować na błędy związane z synchronizacją, gdy wystąpią, ale możesz też próbować im zapobiegać. Jedną ze strategii proaktywnych jest okresowe uruchamianie zadania synchronizacji w celu uzgadniania lokalnej bazy danych z obiektami Google Ads na kontach. W przypadku dużych hierarchii kont unikaj pobierania wszystkich obiektów ze wszystkich kont co noc, aby nie wyczerpać dziennych limitów. Zamiast tego wysyłaj zapytania do ChangeStatus lub filtruj ostatnio zmodyfikowane elementy, aby synchronizować zmiany przyrostowo.

Błędy w logu

Wszystkie błędy powinny być rejestrowane, aby ułatwić debugowanie i monitorowanie. Zapisuj co najmniej identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje, które należy rejestrować, to identyfikator klienta, usługa interfejsu API, czas oczekiwania na żądanie w obie strony, liczba ponownych prób oraz oczyszczone nieprzetworzone żądanie i odpowiedź (pamiętaj o usunięciu poufnych danych uwierzytelniających, takich jak tokeny OAuth i wszelkie informacje umożliwiające identyfikację).

Pamiętaj, aby monitorować trendy w błędach interfejsu API, aby móc wykrywać i rozwiązywać problemy z aplikacją. Rozważ utworzenie własnego rozwiązania lub skorzystanie z jednego z wielu dostępnych narzędzi komercyjnych, które mogą wykorzystywać Twoje dzienniki do tworzenia interaktywnych paneli i wysyłania automatycznych alertów.

Programowanie

Podczas tworzenia aplikacji używaj kont testowych.

Używanie kont testowych

Konta testowe to konta Google Ads, które nie wyświetlają reklam. Możesz używać konta testowego do eksperymentowania z interfejsem Google Ads API i sprawdzania, czy połączenie aplikacji, logika zarządzania kampanią lub inne procesy działają zgodnie z oczekiwaniami. Projekt Google Cloud potrzebuje tylko dostępu testowego, aby można było go używać na koncie testowym. Możesz więc od razu zacząć tworzyć aplikacje za pomocą interfejsu Google Ads API, czekając, aż Google sprawdzi Twoją aplikację pod kątem wyższych poziomów dostępu do interfejsu API.

Dalej
Ograniczenia interfejsu API