Zanim zaczniesz kodować swoją pierwszą aplikację kliencką, musisz wykonać kilka czynności, jeśli jeszcze nie zostało to zrobione.
Załóż konto Google
Aby utworzyć projekt w konsoli interfejsów API Google, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić.
Możesz też utworzyć osobne konto Google na potrzeby testów.
Wypróbuj Raport na temat widoczności reklamy
W tej dokumentacji zakładamy, że korzystasz z raportu dotyczącego widoczności reklam Google oraz że znasz koncepcję programowania stron internetowych i formaty danych internetowych.
Jeśli nie korzystasz z raportu dotyczącego widoczności reklam Google, zanim zaczniesz kodować, wypróbuj interfejs.
Tworzenie projektu dla klienta
Aby móc wysyłać żądania do raportu na temat widoczności reklamy Google, musisz poinformować Google o swoim kliencie i aktywować dostęp do interfejsu API. W tym celu trzeba użyć konsoli API Google do utworzenia projektu, który jest nazwaną kolekcją ustawień i informacji o dostępie do interfejsu API, a następnie zarejestrować aplikację.
Poznaj podstawy REST
Interfejs API można wywołać na 2 sposoby:
- Wysyłanie żądań HTTP i analizowanie odpowiedzi.
- Korzystasz z bibliotek klienta.
Jeśli nie chcesz korzystać z bibliotek klienckich, musisz zrozumieć podstawy REST.
REST to architektura oprogramowania zapewniająca wygodne i spójne podejście do żądania oraz modyfikowania danych.
Termin REST to skrót od " State State Transfer. W kontekście interfejsów API Google oznacza to użycie czasowników HTTP do pobierania i modyfikowania danych przechowywanych przez Google.
W systemie REST zasoby są przechowywane w magazynie danych. Klient wysyła żądanie wykonania określonego działania (na przykład utworzenia, pobrania, zaktualizowania lub usunięcia zasobu), a serwer wykonuje działanie i wysyła odpowiedź, często w postaci reprezentacji określonego zasobu.
W interfejsach API REST Google klient określa działanie za pomocą czasownika HTTP, takiego jak POST, GET, PUT lub DELETE. Określa zasób przez unikalny globalnie identyfikator URI tego formularza:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Wszystkie zasoby API mają unikalne identyfikatory URI dostępne przy użyciu HTTP, dlatego funkcja REST umożliwia zapisywanie danych w pamięci podręcznej i jest zoptymalizowana pod kątem współpracy z rozproszoną infrastrukturą sieciową.
Definicje metod znajdziesz w dokumentacji standardu HTTP 1.1. Zawierają one specyfikacje GET, POST, PUT i DELETE.
REST w interfejsie Google Ad Experience Report API
Operacje interfejsu API raportu reklam Google bezpośrednio mapują na czasowniki HTTP REST.
Poszczególne formaty identyfikatorów URI interfejsu Google Ad Experience Report API to:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
Pełny zestaw identyfikatorów URI używanych w poszczególnych obsługiwanych operacjach w interfejsie API znajdziesz w przewodniku po interfejsie Google Ad Experience Report API.
Poznaj podstawy JSON
Interfejs Google Ad Experience Report API zwraca dane w formacie JSON.
JSON (JavaScript Object Notation) to popularny, niezależny od języka format danych, który reprezentuje prosty tekst reprezentujący dowolne struktury danych. Więcej informacji znajdziesz na stronie json.org.