Zanim zaczniesz kodować swoją pierwszą aplikację kliencką, musisz wykonać kilka czynności.
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ć.
Warto też mieć oddzielne konto Google do celów testowych.
Wypróbuj Google AdMob
W tej dokumentacji dotyczącej interfejsu API zakładamy, że znasz już Google AdMob oraz pojęcia związane z programowaniem internetowym i formatami danych z sieci.
Jeśli korzystasz z Google AdMob po raz pierwszy, wypróbuj interfejs, zanim zaczniesz tworzyć kod.
Tworzenie projektu dla klienta
Zanim zaczniesz wysyłać żądania do Google AdMob, musisz poinformować Google o swoim kliencie i aktywować dostęp do interfejsu API. Możesz to zrobić, korzystając z Konsoli interfejsów API Google, aby utworzyć projekt, który jest nazwanym zbiorem ustawień i informacji o dostępie do interfejsu API, oraz zarejestrować swoją aplikację.
Aby zacząć korzystać 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, włączania interfejsu API i tworzenia danych logowania.
Poznaj podstawy REST
REST to styl architektury oprogramowania zapewniający wygodne i spójne podejście do żądania i modyfikowania danych.
Termin REST to skrót od „Representational State Transfer”. W kontekście interfejsów API Google odnosi się do korzystania z czasowników HTTP do pobierania i modyfikowania reprezentacji danych przechowywanych przez Google.
W systemie REST zasoby są przechowywane w magazynie danych. Klient wysyła żądanie, aby serwer przystąpił do realizacji konkretnego działania (na przykład utworzenia, pobrania, zaktualizowania lub usunięcia zasobu), serwer wykonuje działanie i wysyła odpowiedź, często w formie reprezentacji określonego zasobu.
W interfejsach API Google typu REST klient określa działanie przy użyciu czasownika HTTP, takiego jak POST
, GET
, PUT
czy DELETE
. Zasób określa go za pomocą unikalnego identyfikatora URI, który ma postać:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Wszystkie zasoby interfejsu API mają unikalne identyfikatory URI dostępne przez HTTP, dlatego REST umożliwia buforowanie danych i jest zoptymalizowany pod kątem współpracy z rozproszoną infrastrukturą sieci.
Definicje metod można znaleźć w dokumentacji standardów HTTP 1.1. Obejmują one specyfikacje GET
, POST
, PUT
i DELETE
.
REST w interfejsie AdMob API
Operacje interfejsu API AdMob mapują bezpośrednio czasowniki HTTP REST.
Oto konkretne formaty identyfikatorów URI interfejsu AdMob API:
https://admob.googleapis.com/v1/resourcePath?parameters
Podsumowanie wszystkich identyfikatorów URI używanych w przypadku poszczególnych obsługiwanych operacji w interfejsie API znajdziesz w dokumentacji interfejsu AdMob API.
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 przedstawia proste struktury danych w formie tekstowej. Więcej informacji znajdziesz na stronie json.org.