Aby zacząć używać interfejsu Google Photos Library API z biblioteką klienta w Javie, musisz wykonać te czynności: Skonfiguruj bibliotekę klienta w środowisku programistycznym. Zanim to zrobisz, skonfiguruj projekt, włączając interfejs API. za pomocą Konsoli interfejsów API Google i skonfigurować identyfikator klienta OAuth 2.0.
Twoja aplikacja wchodzi w interakcję ze Zdjęciami Google w imieniu Użytkownik Zdjęć Google. Jeśli na przykład utworzysz albumy w w bibliotece Zdjęć Google ani przesyłać elementów multimedialnych do folderu użytkownika; konta Zdjęć Google, użytkownik autoryzuje te żądania do interfejsu API za pomocą Protokół OAuth 2.0.
Identyfikator klienta OAuth 2.0 pozwala użytkownikom aplikacji logować się, uwierzytelniać i tym samym używać interfejsu Library API. Interfejs Library API nie obsługuje konta usługi; aby korzystać z tego interfejsu API, użytkownicy muszą być zalogowani na Konto.
Konfiguracja aplikacji
Włącz API
Zanim użyjesz interfejsu Library API, musisz włączyć go w swoim projekcie.
- Otwórz konsolę interfejsów API Google.
- Na pasku menu wybierz projekt lub utwórz nowy.
- Aby otworzyć bibliotekę interfejsów API Google, w menu nawigacyjnym wybierz Interfejsy API Usługi > Biblioteka.
- Wyszukaj „Google Photos Library API”. Wybierz właściwy wynik i kliknij Włącz.
Żądanie identyfikatora klienta OAuth 2.0
Wykonaj poniższe czynności, aby zażądać identyfikatora klienta OAuth i skonfigurować go dla swojej aplikacji. W tym przykładzie korzystamy z aplikacji, w której cały przepływ OAuth jest po stronie serwera, jak w przykładach. Proces konfiguracji może się różnić w przypadku innych scenariuszy implementacji.
- Otwórz konsolę interfejsów API Google. i wybierz swój projekt.
- Z menu wybierz Interfejsy API i Usługi > Dane logowania.
- Na stronie Credentials (Dane logowania) kliknij Create Credentials (Utwórz dane logowania) > Identyfikator klienta OAuth.
- Wybierz Typ aplikacji. W tym przykładzie typ aplikacji to Aplikacja internetowa.
Zarejestruj źródła, z których aplikacja może uzyskiwać dostęp do interfejsów API Google w następujący sposób:
- Wpisz nazwę, aby zidentyfikować identyfikator klienta.
W polu Autoryzowane źródła JavaScript wpisz źródło źródła . W tym polu nie można używać symboli wieloznacznych.
Możesz podać wiele źródeł, aby aplikacja działała w różnych protokoły, domeny i subdomeny. Wpisane adresy URL mogą i uruchomić żądanie OAuth.
W poniższym przykładzie pokazano adres URL na potrzeby lokalnego programowania (w naszych przykładach użyto
localhost:8080
) i produkcyjny adres URL.http://localhost:8080 https://myproductionurl.example.com
Pole Autoryzowany identyfikator URI przekierowania to punkt końcowy, który odbiera z serwera OAuth 2.0. Zazwyczaj są to i wskazuje ścieżkę w aplikacji.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
Kliknij Utwórz.
-
W wyświetlonym oknie klienta OAuth pobierz plik JSON. zawierający konfigurację klienta. Na dane klienta składają się: :
- Identyfikator klienta
- Tajny klucz klienta
Ten plik JSON zostanie użyty później do konfiguracji z biblioteką Google Auth dla języka Java, która działa z tą biblioteką klienta.
Zanim uruchomisz aplikację publiczną, która uzyskuje dostęp do interfejsu Library API, Twoja aplikacja musi zostać sprawdzona przez Google. „Niezweryfikowana aplikacja” w podczas testowania aplikacji, aż stanie się zweryfikowane.
Konfigurowanie biblioteki klienta
Biblioteka klienta w języku Java obsługuje za Ciebie wszystkie wywołania interfejsu API backendu i udostępnia łatwe do wykorzystania obiekty, w tym przykłady kodu do typowych zadań interfejsu API. Najpierw pobierz i zainstaluj bibliotekę klienta interfejsu Google Photos Library API dla języka Java z zależnościami z GitHub. Następnie skonfiguruj swoje dane logowania OAuth2 dla języka Java.
Opcje pobierania
Oto kilka sposobów pobrania biblioteki klienta:
Zależność Gradle:
Aby używać tej biblioteki z Gradle, dodaj tę zależność do
build.gradle
.repositories { mavenCentral() } dependencies { compile 'com.google.photos.library:google-photos-library-client:1.7.3' }
Zależność Maven:
Aby korzystać z tej biblioteki w Maven, dodaj do
pom.xml
Maven ten kod .<dependency> <groupId>com.google.photos.library</groupId> <artifactId>google-photos-library-client</artifactId> <version>1.7.3</version> </dependency>
Pobieranie wersji:
strony wersji. zawiera różne artefakty dla każdej wersji biblioteki, w tym pliki jar.
Klonowanie repozytorium:
Skorzystaj z tej metody, jeśli chcesz wprowadzić zmiany w tej bibliotece lub w niej pomóc, na np. przesyłania żądań pull lub wypróbowania naszych próbek. Gdy sklonujesz repozytorium, zostaną pobrane wszystkie pliki z tego repozytorium.
- Uruchom
git clone https://github.com/google/java-photoslibrary.git
w wiersza poleceń. - Otrzymasz katalog
java-photoslibrary
. Przejdź do niego, uruchamiająccd java-photoslibrary
- Otwórz plik
build.gradle
w swoim IDE lub uruchom./gradlew assemble
na wiersza poleceń, aby skompilować projekt. Zobacz./gradlew tasks
, aby dowiedzieć się więcej które są dostępne.
- Uruchom
Skonfiguruj swoje dane logowania OAuth2 dla języka Java
Ta biblioteka klienta współpracuje z biblioteką uwierzytelniania Google dla Java). Aby dowiedzieć się więcej, znajdziesz w artykule Używanie OAuth 2.0 z biblioteką klienta interfejsów API Google do Java).
Określ konfigurację OAuth klienta w CredentialsProvider
, gdy
tworząc PhotoLibrarySettings
dla obiektu PhotosLibraryClient
.
Wypróbuj kilka przykładów
Wypróbuj poniższy kod, aby wykonać pierwsze wywołanie interfejsu API za pomocą biblioteki klienta w Javie.
// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
PhotosLibrarySettings.newBuilder()
.setCredentialsProvider(
FixedCredentialsProvider.create(/* Add credentials here. */))
.build();
try (PhotosLibraryClient photosLibraryClient =
PhotosLibraryClient.initialize(settings)) {
// Create a new Album with at title
Album createdAlbum = photosLibraryClient.createAlbum("My Album");
// Get some properties from the album, such as its ID and product URL
String id = album.getId();
String url = album.getProductUrl();
} catch (ApiException e) {
// Error during album creation
}
Jest więcej przykładów znajdziesz na GitHubie.