Zaawansowane interfejsy API

Zaawansowane interfejsy API w skryptach Google Ads umożliwiają deweloperom łą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 stronie z fragmentami kodu.

Dostępne zaawansowane interfejsy API

Google Analytics
Możesz używać Google Analytics do śledzenia ruchu w swojej witrynie i odpowiedniego dostosowywania stawek w kampanii. Jeśli połączysz usługę w Google Analytics z kontem Google Ads, możesz też analizować aktywność klientów w swojej witrynie. Dzięki temu dowiesz się, jaka część ruchu i sprzedaży w witrynie pochodzi z Google Ads. Te informacje pomogą też ulepszyć Twoje reklamy i stronę internetową. Więcej informacji o łączeniu kont Analytics i Google Ads znajdziesz w przewodniku Konfigurowanie Analytics na potrzeby witryny lub aplikacji w Centrum pomocy.
Google BigQuery
Możesz wczytywać duże ilości danych do Google Cloud Storage, a następnie wysyłać do nich zapytania za pomocą Google BigQuery. Możesz na przykład wczytać publiczne dane pogodowe z ostatnich 10 lat, a następnie wysłać zapytanie o średnią temperaturę w danym regionie w skrypcie, który wykorzystuje te informacje do dostosowywania stawek. Innym zastosowaniem może być analiza 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 wpisu utworzonego w kalendarzu (np. włączyć kampanię w określonym dniu).
Prezentacje Google
Skrypt może eksportować szczegóły lub statystyki kampanii do Prezentacji Google, aby publikować te informacje w czytelnej formie.
Lista zadań Google
Skrypt może tworzyć listę przypomnień o przyszłych zadaniach (np. uruchamiać raport skuteczności kampanii za 2 tygodnie) lub wykonywać działania na podstawie wpisu utworzonego na liście przypomnień (np. włączyć kampanię w określonym dniu).
Interfejs Merchant API
Skrypt może używać interfejsu Merchant API do przesyłania i zarządzania listami produktów oraz do zarządzania kontami Google Merchant Center. W skryptach może to być przydatne do sprawdzania list produktów 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.
Content API for Shopping
Skrypt może używać interfejsu Google Content API for Shopping do przesyłania i zarządzania listami produktów oraz do zarządzania kontami Google Merchant Center. W skryptach może to być przydatne do sprawdzania list produktów i łączenia konkretnych produktów z konkretnymi reklamami. Uwaga: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping. Zamiast niego używaj interfejsu Merchant API opisanego w poprzedniej sekcji.
YouTube i Statystyki YouTube
Możesz pobierać i aktualizować filmy, playlisty itp. oraz dane o skuteczności filmów, aby podejmować decyzje dotyczące ustalania stawek.

Włączanie zaawansowanych interfejsów API

Aby sprawdzić, które interfejsy API Google są dostępne jako zaawansowane interfejsy API, kliknij Zaawansowane interfejsy API na górnym pasku edytora, aby wyświetlić okno Zaawansowane interfejsy API. Wybierz interfejsy API, które chcesz włączyć.

Kliknij Zapisz , aby zapisać zmiany i wrócić do edytora skryptów. Nowe interfejsy API zostaną włączone w skrypcie i będą dostępne na liście autouzupełniania.

Uwagi dodatkowe

Podczas pracy z zaawansowanymi interfejsami API warto pamiętać o kilku kwestiach.

Zależności

Tylko użytkownik, który utworzył skrypt na koncie, może zmienić zależności zaawansowanych interfejsów API dla tego skryptu.

Uprawnienia

Podczas uzyskiwania dostępu do interfejsów API skrypt korzysta z uprawnień użytkownika, który go autoryzował. Upewnij się, że użytkownik, który autoryzował skrypt, ma wymagany dostęp do wszystkich danych potrzebnych skryptowi. 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.

Wskazówki dotyczące skryptów utworzonych przed majem 2019 r.

W przypadku skryptów utworzonych przed majem 2019 r. może być konieczne ręczne włączenie odpowiednich interfejsów API w powiązanym projekcie Google Cloud. Jeśli w oknie zaawansowanych interfejsów API zobaczysz link do konsoli Google Cloud, oznacza to, że skrypt jest objęty tym problemem.

Włączanie zaawansowanych interfejsów API

W przypadku skryptów utworzonych przed 2019 r. musisz ręcznie włączyć każdy zaawansowany interfejs API, którego chcesz używać w skrypcie:

  1. Kliknij przycisk Zaawansowane interfejsy API. W następnym oknie dialogowym kliknij link do konsoli Google Cloud.
  2. Jeśli projekt nie jest jeszcze wybrany, wybierz go z listy rozwijanej Projekt.
  3. Wyszukaj interfejsy API, których chcesz używać w skrypcie, wpisując nazwę interfejsu API na pasku wyszukiwania.
  4. Wybierz interfejs API z wyników wyszukiwania i na następnej stronie kliknij przycisk „Włącz”.

Jeśli użytkownik, który utworzył skrypt, zostanie później usunięty z konta, każdy nowy użytkownik próbujący uzyskać dostęp do skryptu będzie musiał ponownie włączyć zależności zaawansowanych interfejsów API i ponownie autoryzować skrypt.