Zaawansowane interfejsy API w skryptach Google Ads umożliwiają doświadczonym deweloperom nawiązywanie połączeń z określonymi publicznymi interfejsami API Google z mniejszymi wymaganiami dotyczącymi konfiguracji niż w przypadku korzystania z ich interfejsów HTTP. Korzystasz z tych interfejsów API podobnie jak z wbudowanych usług skryptów. Oferują one te same udogodnienia, takie jak autouzupełnianie i automatyczne uwierzytelnianie.
Możliwe zastosowania interfejsów API zaawansowanych
- Google Analytics
- Możesz używać Google Analytics do śledzenia ruchu w swojej witrynie i odpowiednio dostosowywać stawki 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 tym informacjom dowiesz się, jaka część ruchu i sprzedaży w witrynie pochodzi z Google Ads. Te informacje pomogą też ulepszyć Twoje reklamy i witrynę. Więcej informacji o łączeniu kont Analytics i Google Ads znajdziesz w Centrum pomocy.
- Google BigQuery
- Możesz wczytywać duże ilości danych do Google Cloud Storage, a potem wykonywać zapytania do tych danych za pomocą Google BigQuery. Możesz na przykład załadować publiczne dane o pogodzie z ostatnich 10 lat, a potem zapytać o średnią temperaturę w regionie w skrypcie, który wykorzystuje te informacje do dostosowywania stawek. Innym zastosowaniem jest przetwarzanie danych o skuteczności Twojego konta z kilku lat.
- YouTube i Statystyki YouTube
- Aby podejmować decyzje dotyczące stawek, możesz pobierać i aktualizować filmy, playlisty itp., a także dane o wynikach filmów.
- Kalendarz Google
- Skrypt może tworzyć wydarzenia dotyczące przyszłych zadań (np. uruchamiać raport o wydajności kampanii za 2 tygodnie) lub wykonywać czynności na podstawie wpisu utworzonego w kalendarzu (np. włączać kampanię w określonym dniu).
- Treść Zakupów
- Twój skrypt może korzystać z interfejsu Google Content API for Shopping w Apps Script. Ten interfejs API umożliwia użytkownikom Google Merchant Center przesyłanie informacji o produktach i zarządzanie nimi oraz zarządzanie kontami Merchant Center. W skryptach może to być przydatne do sprawdzania informacji o produktach i linkowania konkretnych produktów do konkretnych reklam.
- Lista zadań Google
- Skrypt może tworzyć listę przypomnień o przyszłych zadaniach (np. o wygenerowaniu raportu o skuteczności kampanii za 2 tygodnie) lub wykonywać czynności na podstawie wpisu utworzonego na liście przypomnień (np. włączać kampanię w określonym dniu).
- Prezentacje Google
- Skrypt może eksportować szczegóły kampanii lub statystyki do Prezentacji Google, aby publikować takie informacje w prezentowalnym formacie.
Włączanie zaawansowanych interfejsów API
Aby sprawdzić, które interfejsy Google są dostępne jako interfejsy zaawansowane, kliknij przycisk Interfejsy zaawansowane 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ć w Konsoli stronę Konsoli interfejsów API z projektem powiązanym ze skryptem. Jeśli projekt nie jest jeszcze wybrany, wybierz go na liście 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, kliknij Panel. Sprawdź, czy wszystkie interfejsy API zaawansowane, których chcesz użyć w skrypcie, są wymienione.
Zamknij okno interfejsów API zaawansowanych, aby wrócić do edytora. Nowe interfejsy API zostaną włączone w Twoim skrypcie i będą dostępne na liście autouzupełniania.
Dostępne interfejsy API
Dostępne są te interfejsy API:
| Nazwa interfejsu API | Dokumentacja |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Kalendarz Google | https://developers.google.com/apps-script/advanced/calendar |
| Prezentacje Google | https://developers.google.com/apps-script/advanced/slides |
| Lista zadań Google | https://developers.google.com/apps-script/advanced/tasks |
| Treść Zakupów | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| Statystyki YouTube | https://developers.google.com/apps-script/advanced/youtube-analytics |
Przykłady korzystania z tych interfejsów API znajdziesz też na stronie z fragmentami kodu.
Uwagi końcowe
Podczas pracy z zaawansowanymi interfejsami API należy pamiętać o kilku kwestiach.
Identyfikator projektu
Każdy skrypt Google Ads ma powiązany identyfikator projektu (zwany też numerem projektu) Google Cloud Platform. Numer projektu skryptu możesz znaleźć na stronie interfejsów API Google w oknie Interfejsy API zaawansowane. 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 zależności interfejsu Advanced API. Utworzy się też nowy identyfikator projektu dewelopera Google. Musisz ponownie skonfigurować interfejsy API zaawansowane, zgodnie z instrukcjami podanymi wcześniej w tym dokumencie.
Zależności
Tylko użytkownik, który utworzył skrypt na koncie, może zmienić jego zależności od zaawansowanych interfejsów API.
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 używanych interfejsów API zaawansowanych oraz do danych, których potrzebuje skrypt. Jeśli korzystasz z interfejsu Google Analytics API, upewnij się, że użytkownik, który autoryzował skrypt, ma odpowiednie uprawnienia do konta Analytics, do którego ma być uzyskiwany dostęp.
Warunki korzystania z usługi
Każdy z interfejsów API zaawansowanych może mieć własne Warunki korzystania z usługi, które należy zaakceptować podczas włączania interfejsu API w Konsoli interfejsów API Google.
Limit
Większość interfejsów API zaawansowanych 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 uzupełnisz bezpłatnego limitu. Możesz monitorować limit wykorzystany przez skrypt, otwierając w konsoli interfejsów API Google okno skryptu Zaawansowane interfejsy API. W Konsoli interfejsów API Google możesz też poprosić o dodatkową pulę interfejsu API.
Płatności
Niektóre interfejsy API zaawansowane wymagają uiszczenia opłaty za korzystanie z nich. Tymi płatnościami zarządzasz w projekcie Google Cloud Platform powiązanym ze skryptem, a nie w Google Ads. Więcej informacji o włączaniu płatności w projekcie Google Cloud Platform, w którym znajduje się skrypt, znajdziesz w naszej dokumentacji.