Zaawansowane interfejsy API

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 pokazujące, jak korzystać z 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ż na przykład przeprowadzić analizę 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 zaawansowanych interfejsów API

Aby sprawdzić, które interfejsy API Google są dostępne jako interfejsy API zaawansowane, 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ć wybór 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 w tym skrypcie.

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, 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.

Wskazówki 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 projekcie Google Cloud. Jeśli w oknie dialogowym zaawansowanych interfejsów API zobaczysz link do konsoli Google Cloud, oznacza to, że skrypt jest objęty tymi zmianami.

Włączanie zaawansowanych interfejsów API

W przypadku skryptów sprzed 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 wyświetlonym oknie kliknij link do konsoli Google Cloud.
  2. Jeśli Twój projekt nie jest jeszcze wybrany, wybierz go z menu Projekt.
  3. Wyszukaj interfejsy API, których chcesz użyć w skrypcie, wpisując ich nazwy na pasku wyszukiwania.
  4. 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 i ponowną autoryzację skryptu.