Wymagania wstępne

Zanim zaczniesz pisać pierwszą aplikację kliencką, musisz wykonać kilka czynności:

Uzyskaj konto Google

Aby móc 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ż potrzebować osobnego konta Google do celów testowych.

Wypróbuj Google AdMob

Dokumentacja tego interfejsu API zakłada, że korzystasz z Google AdMob i znasz koncepcje programowania aplikacji internetowych oraz formaty danych internetowych.

Jeśli nie korzystasz z Google AdMob, przed rozpoczęciem kodowania wypróbuj interfejs.

Tworzenie projektu dla klienta

Aby móc wysyłać żądania do Google AdMob, musisz poinformować Google o swoim kliencie i aktywować dostęp do interfejsu API. W tym celu musisz użyć konsoli interfejsów API Google, aby utworzyć projekt, czyli nazwany zbiór ustawień i informacji dostępowych interfejsu API, oraz zarejestrować swoją aplikację.

Aby rozpocząć korzystanie z interfejsu AdMob API, musisz najpierw użyć narzędzia do konfiguracji, które przeprowadzi Cię przez proces tworzenia projektu w Konsoli interfejsów API Google i włączania interfejsu API.

Poznaj podstawy REST

REST to styl architektury oprogramowania, który zapewnia wygodne i spójne podejście do wysyłania żądań dotyczących danych i ich modyfikowania.

REST to skrót od „Representational State Transfer”. W kontekście interfejsów API Google oznacza to używanie czasowników HTTP do pobierania i modyfikowania reprezentacji danych przechowywanych przez Google.

W systemie RESTful zasoby są przechowywane w magazynie danych. Klient wysyła żądanie, aby serwer wykonał określone działanie (np. utworzył, pobrał, zaktualizował lub usunął zasób), a serwer wykonuje to działanie i wysyła odpowiedź, często w formie 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 za pomocą unikalnego globalnie identyfikatora URI w tej postaci:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Ponieważ wszystkie zasoby interfejsu API mają unikalne identyfikatory URI dostępne przez HTTP, REST umożliwia buforowanie danych i jest zoptymalizowany pod kątem współpracy z rozproszoną infrastrukturą internetu.

W dokumentacji standardów HTTP 1.1 znajdziesz definicje metod, w tym specyfikacje metod GET, POST, PUTDELETE.

REST w interfejsie AdMob API

Operacje interfejsu AdMob API są bezpośrednio powiązane z czasownikami REST HTTP.

Identyfikatory URI interfejsu AdMob API mają te formaty:

https://admob.googleapis.com/v1/resourcePath?parameters

Pełny zestaw identyfikatorów URI używanych w przypadku każdej obsługiwanej operacji w interfejsie API znajdziesz w dokumencie Dokumentacja interfejsu AdMob API.

Poznaj podstawy formatu JSON

Interfejs AdMob API zwraca dane w formacie JSON.

JSON (JavaScript Object Notation) to popularny, niezależny od języka format danych, który zapewnia prostą tekstową reprezentację dowolnych struktur danych. Więcej informacji znajdziesz na stronie json.org.