자바 클라이언트 라이브러리 시작하기

자바 클라이언트 라이브러리와 함께 Google 포토 라이브러리 API를 사용하려면 다음을 수행해야 합니다. 개발 환경에서 클라이언트 라이브러리를 설정합니다. 그 전에 API를 사용 설정하여 프로젝트를 구성합니다. OAuth 2.0 클라이언트 ID를 설정할 수 있습니다.

애플리케이션은 Google 포토 사용자입니다. 예를 들어 사용자의 Google 포토 라이브러리에 추가하거나 미디어 항목을 Google 포토 계정에서 사용자는 OAuth 2.0 프로토콜

OAuth 2.0 클라이언트 ID를 사용하면 애플리케이션 사용자가 Library API를 사용하세요 Library API는 서비스 계정 이 API를 사용하려면 유효한 Google 계정에 로그인해야 합니다. 계정.

앱 구성

API 사용 설정

라이브러리 API를 사용하려면 우선 프로젝트에서 사용 설정해야 합니다.

  1. Google API 콘솔로 이동합니다.
  2. 메뉴 바에서 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
  3. Google API 라이브러리를 열려면 탐색 메뉴에서 API 및 서비스 > Library로 구성됩니다.
  4. 'Google 포토 라이브러리 API'를 검색합니다. 올바른 결과를 선택하고 사용 설정.

OAuth 2.0 클라이언트 ID 요청

아래 단계에 따라 OAuth 클라이언트 ID를 요청하고 애플리케이션입니다. 이 예에서는 전체 OAuth 흐름이 서버 측에서 처리되는 것을 볼 수 있습니다. 설정 프로세스는 다를 수 있음 자세한 내용은 구현 시나리오를 참고하세요.

  1. Google API 콘솔로 이동합니다. 프로젝트를 선택합니다
  2. 메뉴에서 API 및 서비스 > 사용자 인증 정보.
  3. 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 >를 클릭합니다. OAuth 클라이언트 ID를 입력합니다.
  4. 애플리케이션 유형을 선택합니다. 이 예에서 애플리케이션 유형은 웹 애플리케이션.
  5. 앱이 Google API에 액세스할 수 있는 출처를 등록합니다. 방법은 다음과 같습니다.

    1. 클라이언트 ID를 식별하기 위해 이름을 입력합니다.
    2. 승인된 JavaScript 원본 필드에 파일의 원본을 입력합니다. 있습니다. 이 필드에는 와일드 카드가 허용되지 않습니다.

      앱이 다양한 출처에서 실행되도록 허용할 출처를 여러 개 입력할 수 있습니다. 하위 도메인일 수 있습니다. 입력한 URL은 OAuth 요청을 시작할 수 있습니다.

      다음 예는 로컬 개발 URL을 보여줍니다 (샘플은 localhost:8080) 및 프로덕션 URL이 포함됩니다.

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. 승인된 리디렉션 URI 필드는 응답을 수신할 수 있습니다. 일반적으로 여기에는 애플리케이션의 경로를 가리킵니다.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. 만들기를 클릭합니다.

  1. 표시되는 OAuth 클라이언트 대화상자에서 JSON 파일을 다운로드합니다. 클라이언트 구성이 포함됩니다 클라이언트 세부정보는 있습니다.

    • 클라이언트 ID
    • 클라이언트 보안 비밀번호

    이 JSON 파일은 나중에 설정하는 데 사용됩니다. 이 클라이언트 라이브러리와 함께 작동하는 Java용 Google 인증 라이브러리를 사용합니다.

라이브러리 API에 액세스하는 공개 애플리케이션을 실행하려면 먼저 Google의 검토를 받아야 합니다. '확인되지 않은 앱' 메시지가 표시되는 화면에 완전히 표시되며 인증됨

클라이언트 라이브러리 설정

Java 클라이언트 라이브러리는 모든 백엔드 API 호출을 자동으로 처리하고 일반적인 API 작업을 위한 코드 샘플을 비롯하여 작업할 수 있는 친숙한 객체를 제공합니다. 먼저 Java용 Google 포토 라이브러리 API 클라이언트 라이브러리를 GitHub의 종속 항목을 사용할 수 있습니다. 그런 다음 Java용 OAuth2 사용자 인증 정보를 설정합니다.

다운로드 옵션

다음은 클라이언트 라이브러리를 다운로드할 수 있는 몇 가지 옵션입니다.

  • Gradle 종속 항목:

    이 라이브러리를 Gradle과 함께 사용하려면 build.gradle 파일.

    repositories {
      mavenCentral()
    }
    dependencies {
      compile 'com.google.photos.library:google-photos-library-client:1.7.3'
    }
    
  • Maven 종속 항목:

    이 라이브러리를 Maven에서 사용하려면 다음을 Maven pom.xml에 추가하세요. 파일에서 참조됩니다.

    <dependency>
      <groupId>com.google.photos.library</groupId>
      <artifactId>google-photos-library-client</artifactId>
      <version>1.7.3</version>
    </dependency>
    
  • 출시 버전 다운로드:

    출시 페이지 에는 jar 파일을 포함하여 각 라이브러리 릴리스에 대한 다양한 아티팩트가 포함됩니다.

  • 저장소를 클론합니다.

    이 라이브러리를 변경하거나 기여하려면 이 메서드를 사용하세요. 예를 들어 pull 요청을 제출하거나 샘플을 사용해 볼 수 있습니다. 저장소를 클론하면 이 저장소의 모든 파일이 다운로드됩니다.

    1. 다음에서 git clone https://github.com/google/java-photoslibrary.git 실행: 명령 프롬프트
    2. java-photoslibrary 디렉터리가 표시됩니다. 다음을 실행하여 cd java-photoslibrary
    3. IDE에서 build.gradle 파일을 열거나 다음 위치에서 ./gradlew assemble를 실행합니다. 명령 프롬프트를 사용하여 프로젝트를 빌드합니다 ./gradlew tasks에서 확인하세요. 작업을 수행할 수 있습니다

Java용 OAuth2 사용자 인증 정보 설정

이 클라이언트 라이브러리는 Google 인증 라이브러리 Java 자세한 내용은 Google API 클라이언트 라이브러리에 OAuth 2.0 사용 Java

다음과 같은 경우 CredentialsProvider에서 클라이언트 OAuth 구성을 지정하세요. PhotosLibraryClient 객체의 PhotoLibrarySettings 만들기

샘플 사용해 보기

아래 코드를 사용하여 Java 클라이언트 라이브러리를 사용하여 첫 번째 API 호출을 만들어 보세요.

// 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
}

더 많은 샘플이 있습니다 를 GitHub에서 확인할 수 있습니다.