Ta strona została przetłumaczona przez Cloud Translation API.

Wprowadzenie do biblioteki klienta w Javie

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:
1. Wpisz nazwę, aby zidentyfikować identyfikator klienta.
2. 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
```
3. 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
```
4. 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.
1. Uruchom git clone https://github.com/google/java-photoslibrary.git w wiersza poleceń.
2. Otrzymasz katalog java-photoslibrary. Przejdź do niego, uruchamiając cd java-photoslibrary
3. 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.

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.