Wymagania wstępne

Zanim zaczniesz kodować swoją pierwszą aplikację kliencką, zapoznaj się z tymi co trzeba zrobić, jeśli jeszcze nie wykonali tych czynności.

Tworzenie projektu dla klienta

Aby móc wysyłać żądania, musisz powiadomić Google o swoim kliencie i aktywować dostęp do interfejsu API. W tym celu użyj Konsoli interfejsów API Google, aby utworzyć projekt, który jest nazwanym kolekcją. ustawień i informacji dotyczących dostępu do interfejsu API oraz zarejestruj aplikację.

Aby zacząć korzystać z interfejsu Android Over The Air API, musisz: użyj w narzędziu konfiguracji, które przeprowadzi Cię przez proces tworzenia projektu w Konsola interfejsów API Google, włączenie interfejsu API i tworzenie danych logowania.

Umieść projekt na białej liście

Interfejs Android Over The Air API jest dostępny tylko w projektach umieszczonych na białej liście. Jeśli Twojego projektu nie ma na białej liście, próba użycia spowoduje wystąpienie 404 błędów.

Aby znaleźć się na białej liście, wyślij e-maila do TAM-a Google, aby dodać Twój nowy identyfikator projektu do białej listy.

Identyfikator projektu znajdziesz w panelu Cloud. Więcej informacji znajdziesz w tym dokumencie pomocy.

Uwaga: identyfikator projektu powinien mieć optymalny format {company}-gota-api-{number}

Po dodaniu Cię do białej listy włącz interfejs Android Over The Air API dla swojego projektu i sprawdź, znajdziesz w instrukcji autoryzacji.

Pamiętaj, że tylko podany przez Ciebie identyfikator projektu będzie umożliwiał korzystanie z interfejsu Android Over The Air API. Śr zdecydowanie zalecamy utworzenie konta usługi (zgodnie z opisem w autoryzacji) na potrzeby korzystania z interfejsu API niż używać kont osobistych.

Wypróbuj panel bezprzewodowy Androida

W tej dokumentacji zakładamy, że używasz Panelu Android Over-The Air i znasz zagadnienia programowania i formaty danych w internecie.

Jeśli nie korzystasz jeszcze z panelu Android Over The Air, zanim zaczniesz pisać kod, wypróbuj interfejs.

Podstawy REST

Interfejs API można wywołać na 2 sposoby:

Jeśli zdecydujesz się nie używać bibliotek klienta, musisz znać podstawy REST.

REST to styl architektury oprogramowania, który zapewnia wygodne i spójne podejście do żądania i modyfikowania danych.

Skrót REST to reprezentatywny transfer stanowy. 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 REST zasoby są przechowywane w magazynie danych. klient wysyła żądanie, aby serwer wykonał określone działanie (takie jak utworzenie, pobranie, zaktualizowanie lub usunięcie zasobu), a serwer wykonuje tę czynność i wysyła odpowiedź, często w formie reprezentacji określonego zasobu.

W interfejsach API typu REST firmy Google klient określa działanie za pomocą czasownika HTTP, takiego jak POST, GET, PUT lub DELETE. Wskazuje zasób za pomocą globalnie unikalnego identyfikatora URI o następującej postaci:

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

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

Definicje metod znajdziesz w dokumentacji standardów HTTP 1.1. zawierają one specyfikacje GET, POST, PUT i DELETE.

REST w interfejsie Android Over The Air API

Operacje interfejsu Android Over The Air API są mapowane bezpośrednio na czasowniki HTTP REST.

Identyfikatory URI interfejsu Android Over The Air API mają kilka konkretnych formatów:

https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters

Pełny zestaw identyfikatorów URI używanych w przypadku każdej obsługiwanej operacji w interfejsie API znajduje się w dokumencie Android Over The Air API.

Podstawy kodu JSON

Interfejs Android Over The Air API zwraca dane w formacie JSON.

JSON (JavaScript Object Notation) to popularny, niezależny od języka format danych, który w prosty sposób przedstawia dowolne struktury danych w formie tekstowej. Więcej informacji znajdziesz na stronie json.org.