Zaawansowane interfejsy API w skryptach Google Ads umożliwiają programistom łączenie się z określonymi publicznymi interfejsami API Google z mniejszymi wymaganiami dotyczącymi konfiguracji niż w przypadku korzystania z interfejsów HTTP. Możesz używać tych interfejsów API podobnie jak wbudowanych usług skryptów. Oferują one te same udogodnienia, takie jak autouzupełnianie i automatyczna autoryzacja.
Przykłady użycia tych interfejsów API znajdziesz na naszej stronie z fragmentami kodu.
Dostępne zaawansowane interfejsy API
- Google Analytics
- Możesz używać Google Analytics do śledzenia ruchu w swojej witrynie i odpowiednio dostosowywać stawki w kampanii. Jeśli połączysz usługę w Google Analytics z kontem Google Ads, możesz też analizować aktywność klientów w Twojej witrynie. Dzięki temu dowiesz się, jaka część ruchu w witrynie lub sprzedaży pochodzi z Google Ads. Te informacje pomogą Ci też ulepszyć reklamy i stronę internetową. Więcej informacji o łączeniu kont Analytics i Google Ads znajdziesz w przewodniku w Centrum pomocy Konfigurowanie Analytics na potrzeby witryny lub aplikacji.
- Google BigQuery,
- Możesz wczytywać duże ilości danych do Google Cloud Storage, a następnie wykonywać na nich zapytania za pomocą Google BigQuery. Możesz na przykład wczytać publiczne dane pogodowe z ostatnich 10 lat, a potem w skrypcie, który wykorzystuje te informacje do dostosowywania stawek, wysłać zapytanie o średnią temperaturę w danym regionie. Możesz też używać go do analizowania danych o skuteczności konta z kilku lat.
- Kalendarz Google
- Skrypt może tworzyć wydarzenia dotyczące przyszłych zadań (np. uruchamiać raport skuteczności kampanii za 2 tygodnie) lub wykonywać działania na podstawie utworzonego w kalendarzu wpisu (np. włączać kampanię w określonym dniu).
- Prezentacje Google
- Skrypt może eksportować szczegóły lub statystyki kampanii do Prezentacji Google, aby publikować te informacje w formacie prezentacji.
- Lista zadań Google
- Skrypt może tworzyć listę przypomnień o przyszłych zadaniach (np. za 2 tygodnie wygenerować raport skuteczności kampanii) lub wykonywać działania na podstawie wpisu utworzonego na liście przypomnień (np. włączyć kampanię w określonym dniu).
- Interfejs API sprzedawcy
- Skrypt może używać Merchant API do przesyłania list produktów i zarządzania nimi oraz do zarządzania kontami Google Merchant Center. W skryptach może to być przydatne do sprawdzania informacji o produktach i łączenia konkretnych produktów z konkretnymi reklamami. Interfejs Merchant API ma podrzędne interfejsy API, które można włączyć osobno w oknie Zaawansowane interfejsy API. Więcej informacji o łączeniu konta Google Merchant Center znajdziesz w przewodniku Rejestracja jako deweloper.
- Treści związane z zakupami
- Skrypt może używać interfejsu Google Content API for Shopping do przesyłania informacji o produktach i zarządzania nimi oraz do zarządzania kontami Google Merchant Center. W skryptach może to być przydatne do sprawdzania informacji o produktach i łączenia konkretnych produktów z konkretnymi reklamami. Uwaga: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping. Zamiast tego używaj interfejsu Merchant API opisanego w poprzedniej sekcji.
- YouTube i Statystyki YouTube
- Możesz pobierać i aktualizować swoje filmy, playlisty itp., a także dane o skuteczności filmów, aby podejmować decyzje dotyczące stawek.
Włączanie interfejsów API Advanced
Aby sprawdzić, które interfejsy API Google są dostępne jako interfejsy API zaawansowane, kliknij przycisk Zaawansowane interfejsy API na górnym pasku edytora.
Otworzy się okno Zaawansowane interfejsy API. Zaznacz interfejsy API, które chcesz włączyć.
Następnie kliknij link Konsola interfejsów API Google, aby otworzyć stronę Konsola interfejsów API w konsoli z projektem powiązanym ze skryptem. Jeśli projekt nie jest jeszcze wybrany, wybierz go z menu Projekt. Wyszukaj interfejsy API, których chcesz użyć w skrypcie, wpisując nazwę interfejsu API na pasku wyszukiwania.
W wynikach wyszukiwania wybierz interfejs API, a na następnej stronie kliknij Włącz. Jeśli widzisz przycisk Wyłącz, oznacza to, że ten interfejs API jest już włączony. Powtórz tę czynność w przypadku każdego interfejsu API, który chcesz włączyć.
Aby wyświetlić listę włączonych interfejsów API w projekcie, otwórz stronę Panel. Sprawdź, czy wszystkie zaawansowane interfejsy API, których chcesz używać w skrypcie, są wymienione na liście.
Teraz zamknij okno Zaawansowane interfejsy API, aby wrócić do edytora. Nowe interfejsy API zostaną włączone w skrypcie i będą dostępne na liście autouzupełniania.
Uwagi końcowe
Podczas pracy z interfejsami API o większych możliwościach warto pamiętać o kilku kwestiach.
Identyfikator projektu
Każdy skrypt Google Ads ma powiązany z nim identyfikator projektu Google Cloud (znany też jako numer projektu). Numer projektu skryptu znajdziesz, otwierając stronę Konsoli interfejsów API Google z okna Zaawansowane interfejsy API. Ten identyfikator projektu jest tworzony podczas tworzenia skryptu i jest powiązany z użytkownikiem, który utworzył skrypt Google Ads. Jeśli użytkownik, który utworzył skrypt, zostanie później usunięty z konta, użytkownik próbujący uzyskać dostęp do skryptu zostanie poproszony o ponowne autoryzowanie skryptu i ponowne skonfigurowanie zaawansowanych zależności interfejsu API. Zostanie też utworzony nowy identyfikator projektu Google Developer. Musisz ponownie skonfigurować zaawansowane interfejsy API, jak opisano wcześniej w tym dokumencie.
Zależności
Tylko użytkownik, który utworzył skrypt na koncie, może zmienić zależności zaawansowanych interfejsów API w tym skrypcie.
Uprawnienia
Podczas uzyskiwania dostępu do interfejsów API skrypt korzysta z uprawnień użytkownika, który go autoryzował. Sprawdź, czy użytkownik, który autoryzował skrypt, ma wymagany dostęp do wszystkich używanych zaawansowanych interfejsów API oraz do danych, których skrypt potrzebuje. Jeśli używasz interfejsu Google Analytics API, sprawdź, czy użytkownik, który autoryzował skrypt, ma niezbędne uprawnienia do konta Analytics, do którego uzyskuje dostęp.
Warunki korzystania z usługi
Każdy z interfejsów API w wersji zaawansowanej może mieć własne Warunki, które musisz zaakceptować podczas włączania interfejsu API w Konsoli interfejsów API Google.
Limit
Większość zaawansowanych interfejsów API ma powiązany z nimi bezpłatny dzienny limit. Gdy skrypt przekroczy ten limit, interfejs API przestanie działać, dopóki nie poprosisz o dodatkowe dane lub nie zostanie uzupełniony bezpłatny limit. Możesz monitorować limit wykorzystany przez skrypt, otwierając w oknie dialogowym Zaawansowane interfejsy API konsolę interfejsów API Google dla skryptu. Konsola interfejsów API Google umożliwia też wysyłanie próśb o zwiększenie limitu interfejsu API.
Płatności
Niektóre zaawansowane interfejsy API wymagają płatności za korzystanie z nich. Płatności te są zarządzane w ramach projektu Google Cloud powiązanego ze skryptem, a nie w ramach Google Ads. Więcej informacji o tym, jak włączyć płatności za projekt Google Cloud skryptu, znajdziesz w naszej dokumentacji.