Zaawansowane interfejsy API w skryptach Google Ads umożliwiają deweloperom łączenie się z niektórymi publicznymi interfejsami API Google przy mniejszej liczbie czynności konfiguracyjnych 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 pokazujące, jak używać tych interfejsów API, znajdziesz na stronie z fragmentami kodu.
Dostępne zaawansowane interfejsy API
- Google Analytics
- Uwaga: zaawansowany interfejs API
Analyticsw oknie Zaawansowane interfejsy API jest przeznaczony dla wyłączonego interfejsu Universal Analytics v3 API, a żądania do niego kończą się niepowodzeniem. Skrypty Google Ads nie obsługują usług zaawansowanychAnalyticsDataaniAnalyticsAdminGoogle Analytics 4. Aby wysyłać zapytania o dane Google Analytics 4 ze skryptu, wysyłaj żądania HTTPS do interfejsu Google Analytics Data API, korzystając z usługiUrlFetchAppi OAuth 2.0. Możesz też połączyć usługę Google Analytics 4 z kontem Google Ads, aby bezpośrednio udostępniać dane o konwersjach w witrynie i aplikacji. Instrukcje konfigurowania znajdziesz w przewodniku po konfiguracji Analytics. - 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 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 dla przyszłych zadań (np. uruchomić 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 atrakcyjnym formacie.
- Lista zadań Google
- Skrypt może utworzyć listę przypomnień o przyszłych zadaniach (np. wygenerować raport skuteczności kampanii za 2 tygodnie) lub wykonać działania na podstawie wpisu utworzonego na liście przypomnień (np. włączyć kampanię w określonym dniu).
- Merchant API
- Skrypt może używać interfejsu Merchant API 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 określonymi reklamami. 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 Rejestrowanie się jako deweloper.
- Treści promujące produkty
- 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 określonymi reklamami. Uwaga: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping. Zamiast tego użyj interfejsu Merchant API, który opisaliśmy w poprzedniej sekcji.
- YouTube i Statystyki YouTube
- Możesz pobierać i aktualizować filmy, playlisty itp., a także dane o skuteczności filmów, aby podejmować decyzje dotyczące określania stawek.
Włączanie zaawansowanych interfejsów API
Aby zobaczyć, które interfejsy API Google są dostępne jako zaawansowane interfejsy API, kliknij Zaawansowane interfejsy API na górnym pasku edytora. Wyświetli się okno Zaawansowane interfejsy API. Wybierz interfejsy API, które chcesz włączyć.
Kliknij Zapisz, aby zapisać wybrane opcje 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 zaawansowanych interfejsów API skrypt używa uprawnień użytkownika, który go autoryzował. Użytkownik, który udziela autoryzacji, musi mieć wymagany dostęp do wszystkich danych, których potrzebuje skrypt. Na przykład aby używać zaawansowanego interfejsu API BigQuery, autoryzujący użytkownik musi mieć wymagane uprawnienia do docelowego projektu Google Cloud i zbioru danych BigQuery.
Uwagi dotyczące skryptów sprzed maja 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 ze skryptem projekcie Google Cloud. Jeśli w oknie zaawansowanych interfejsów API zobaczysz link do konsoli Google Cloud, oznacza to, że Twój skrypt jest objęty zmianami.
Włączanie zaawansowanych interfejsów API
W przypadku skryptów sprzed 2019 roku musisz ręcznie włączyć każdy zaawansowany interfejs API, którego chcesz używać w skrypcie:
- Kliknij przycisk Advanced APIs (Zaawansowane interfejsy API). W następnym oknie kliknij link do konsoli Google Cloud.
- Jeśli Twój 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.
- Wybierz interfejs API z wyników wyszukiwania i kliknij przycisk „Włącz” na następnej stronie.
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 zostanie poproszony o ponowne włączenie zaawansowanych zależności interfejsu API oraz o ponowną autoryzację skryptu.