Picker API 시작하기

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

시작하기 전에

Picker API 흐름

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

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

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

  3. 사용자를 Google 포토 앱으로 안내: 사용자에게 pickerUri를 제공합니다 (클릭 가능한 링크 또는 QR 코드). 이 URL은 Google 포토 앱을 안전하게 엽니다. 웹 기반 애플리케이션의 경우 이 URI에 /autoclose를 추가하여 사용자가 선택을 완료한 후 Google 포토 창을 자동으로 닫을 수 있습니다.

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

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

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

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

다음 단계

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