Aktualizacja zasad użytkowania zasobów interfejsu Google Ads API

Środa, 1 maja 2024 r.

Co się zmienia?

Aktualizujemy zasady użytkowania zasobów interfejsu Google Ads API, aby ograniczać wzorce zapytań GoogleAdsService.Search i GoogleAdsService.SearchStream, które zużywają nadmierną ilość zasobów interfejsu API. Jeśli dany wzorzec zapytania jest ograniczony, inne usługi, metody i wzorce zapytań będą nadal działać bez zmian.

Od 17 czerwca 2024 r. w przypadku ograniczonych wzorców zapytań żądania będą obsługiwane w następujący sposób:

  • Jeśli używasz interfejsu API w wersji 17 lub starszej, pojawi się błąd QuotaError.RESOURCE_EXHAUSTED.
  • Jeśli używasz interfejsu API w wersji 18 lub nowszej, otrzymasz błąd QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION lub QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, w zależności od tego, czy nadmierne wykorzystanie zasobów miało miejsce przez krótki czas (kilka minut) czy przez dłuższy czas.

Aby ułatwić Ci identyfikowanie i monitorowanie kosztownych raportów, będziemy też zwracać dane o kosztach poszczególnych raportów. Aby wyświetlić koszt udanych raportów, sprawdź te pola:

Skąd ta zmiana?

Wprowadzamy tę zmianę, aby zachować niezawodność i stabilność interfejsu API.

Co muszę zrobić?

Przed 17 czerwca 2024 r. zaktualizuj aplikacje, aby:

  • Obsługuj nowe kody błędów podczas wywoływania GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Jeśli używasz interfejsu Google Ads API w wersji 17 lub starszej, obsługuj błędy QuotaError.RESOURCE_EXHAUSTED.
    • Jeśli używasz interfejsu API w wersji 18 lub nowszej, obsługuj błędy QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION i QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Jeśli co najmniej 1 z Twoich wzorców zapytań raportowania jest ograniczany, sprawdź go i popraw. Oto kilka sposobów na poprawę wydajności zapytań:
    • Uruchamiaj zapytanie rzadziej.
    • Użyj tańszego wzorca zapytania lub widoku.

Więcej informacji o optymalizowaniu zapytań znajdziesz w artykule o zarządzaniu efektywnością danych.

  • [Opcjonalnie] Dodaj nowy wskaźnik query_resource_consumption do systemów monitorowania, aby wykrywać i obsługiwać nowe kosztowne zapytania.

Jak uzyskać pomoc

Jeśli masz pytania związane z tą zmianą lub potrzebujesz pomocy w optymalizacji konkretnych wzorców zapytań, wejdź na stronę pomocy interfejsu Google Ads API, aby poznać dostępne opcje.

– David Stevens, Google Ads API Product Manager

Etykiety: google-ads-api