Skip to main content
PFAuthenticationLoginWithGoogleAccountRequest 데이터 모델. Google 로그인은 디바이스에서 Android용 Google 로그인 API를 사용하여 Google OAuth 2.0 자격 증명을 얻고 이를 이 API에 전달하여 수행됩니다. 사용자가 Google 계정으로 처음 로그인하는 경우이고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Google 계정에 연결됩니다. 그렇지 않으면 해당 Google 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되어, 타이틀이 사용자가 PlayFab 계정을 만들도록 안내할 수 있게 됩니다. Android 애플리케이션에서 Google 계정 자격 증명을 얻는 현재(권장) 방법은 GoogleSignInAccount.getServerAuthCode()를 호출하고 이 API의 ServerAuthCode 매개 변수로 인증 코드를 보내는 것입니다. 이렇게 하기 전에 Google API Console에서 OAuth 2.0 웹 애플리케이션 클라이언트 ID를 만들고, 사용 중인 타이틀에 대해 PlayFab Game Manager Google 추가 기능에서 해당 클라이언트 ID와 비밀을 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요청할 필요가 없으므로 사용자 경험의 마찰이 최소화됩니다. 서버 인증 코드를 얻는 방법에 대한 자세한 내용은 https://developers.google.com/identity/sign-in/android/offline-access를 참조하세요. 이전(사용되지 않음) 방법은 클라이언트에서 GetAccessToken()을 호출하여 OAuth 액세스 토큰을 얻고 이를 이 API의 AccessToken 매개 변수로 전달하는 것이었습니다. Google OAuth 2.0 액세스 토큰과 함께 사용됩니다. 이 변경 사항에 대한 자세한 내용은 Google 개발자 설명서(https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html)에서 확인할 수 있습니다.

구문

멤버

createAccount bool 현재 이 ID에 연결된 계정이 없는 경우 자동으로 PlayFab 계정을 생성합니다. customTags PFStringDictionaryEntry const*
may be nullptr
(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등). customTagsCount uint32_t customTags의 개수입니다. infoRequestParameters PFGetPlayerCombinedInfoRequestParams const*
may be nullptr
(선택 사항) 사용자에 대해 반환할 정보 항목에 대한 플래그입니다. playerSecret const char*
is null-terminated
(선택 사항) API 요청 서명을 확인하는 데 사용되는 플레이어 비밀입니다(엔터프라이즈 전용). serverAuthCode const char*
is null-terminated
Google 클라이언트 API의 getServerAuthCode()(https://developers.google.com/identity/sign-in/android/offline-access)를 호출하여 클라이언트에서 얻은 OAuth 2.0 서버 인증 코드입니다. setEmail bool const*
may be nullptr
(선택 사항) Google 계정을 만들 때 MPA 이메일 설정을 옵트아웃할 수 있는 선택적 부울 값이며, 기본값은 true입니다.

요구 사항

헤더: PFAuthenticationTypes.h

참고 항목

PFAuthenticationTypes 멤버
마지막 수정일 2026년 8월 13일