Picker API 시작하기

Picker API는 사용자가 Google 포토 라이브러리에서 사진과 동영상을 선택하고 애플리케이션과 공유할 수 있는 안전한 방법을 제공합니다.

시작하기 전에

  • 개요 확인: Picker API와 Library API를 비교하여 Picker API가 사용 사례에 적합한지 확인합니다.
  • 앱 구성: API를 사용 설정하고 인증을 설정합니다. 자세한 단계는 앱 구성을 참고하세요.

Picker API 흐름

다음은 Picker API의 작동 방식에 대한 개요입니다.

  1. OAuth 토큰 확인: Picker API 흐름을 시작하기 전에 사용자의 유효한 OAuth 2.0 액세스 토큰을 확인합니다. 토큰이 없으면 OAuth 2.0 승인 흐름을 시작하여 토큰을 가져옵니다.

  2. 세션 만들기: Picker API를 호출하여 새 세션을 만들고 프로세스를 시작합니다. 이 호출은 고유한 pickerUri를 반환합니다.

  3. 사용자를 Google 포토 앱으로 안내: 사용자에게 pickerUri를 제공합니다 (클릭 가능한 링크 또는 QR 코드로 제공). 이 URL을 사용하면 Google 포토 앱이 안전하게 열립니다.

  4. 사용자가 미디어 항목을 선택합니다. 사용자는 Google 포토 앱 내에서 라이브러리를 둘러보고 앱과 공유할 사진과 동영상을 선택할 수 있습니다. 사용자의 선택 환경 개요를 읽어보세요.

  5. 세션 폴링: 앱은 주기적으로 세션을 폴링하여 상태를 확인해야 합니다. 사용자가 선택을 완료했음을 나타내는 true를 반환하는 mediaItemsSet 속성을 찾습니다.

  6. 선택한 미디어 항목 나열: mediaItemsSet가 true를 반환하면 목록 메서드를 사용하여 선택된 미디어 항목에 관한 세부정보를 가져올 수 있습니다.

  7. 미디어 항목 검색 및 사용: 이제 선택한 미디어 항목에 액세스할 수 있습니다. baseUrl를 사용하여 콘텐츠를 가져오고 애플리케이션 내에서 활용할 수 있습니다.

다음 단계

  • 참조 문서 검토: 사용 가능한 모든 메서드와 매개변수에 대해 알아보려면 자세한 Picker API 참조 문서를 살펴보세요.
  • 샘플 사용해 보기: 샘플을 확인하여 Picker API가 작동하는 모습을 보고 통합에 대한 아이디어를 얻으세요.