> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFAuthenticationLoginWithGoogleAccountRequest

> PFAuthenticationLoginWithGoogleAccountRequest 데이터 모델. Google 로그인은 Google 로그인을 사용하여 Google OAuth 2.0 자격 증명을 얻어 수행됩니다.

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](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](https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html))에서 확인할 수 있습니다.

## 구문

```cpp theme={null}
typedef struct PFAuthenticationLoginWithGoogleAccountRequest {  
    bool createAccount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFGetPlayerCombinedInfoRequestParams const* infoRequestParameters;  
    const char* playerSecret;  
    const char* serverAuthCode;  
    bool const* setEmail;  
} PFAuthenticationLoginWithGoogleAccountRequest;  
```

### 멤버

**`createAccount`**   bool

현재 이 ID에 연결된 계정이 없는 경우 자동으로 PlayFab 계정을 생성합니다.

**`customTags`**   PFStringDictionaryEntry const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`infoRequestParameters`**   PFGetPlayerCombinedInfoRequestParams const\*<br />*may be nullptr*

(선택 사항) 사용자에 대해 반환할 정보 항목에 대한 플래그입니다.

**`playerSecret`**   const char\*<br />*is null-terminated*

(선택 사항) API 요청 서명을 확인하는 데 사용되는 플레이어 비밀입니다(엔터프라이즈 전용).

**`serverAuthCode`**   const char\*<br />*is null-terminated*

Google 클라이언트 API의 getServerAuthCode()([https://developers.google.com/identity/sign-in/android/offline-access](https://developers.google.com/identity/sign-in/android/offline-access))를 호출하여 클라이언트에서 얻은 OAuth 2.0 서버 인증 코드입니다.

**`setEmail`**   bool const\*<br />*may be nullptr*

(선택 사항) Google 계정을 만들 때 MPA 이메일 설정을 옵트아웃할 수 있는 선택적 부울 값이며, 기본값은 true입니다.

## 요구 사항

**헤더:** PFAuthenticationTypes.h

## 참고 항목

[PFAuthenticationTypes 멤버](/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationLoginWithGoogleAccountAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleaccountasync.md)
- [PFAuthenticationReLoginWithGoogleAccountAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithgoogleaccountasync.md)
- [Services C API 개요 - PFAuthenticationTypes.h](/ko/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationLoginWithGoogleAccountGetResult](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleaccountgetresult.md)
- [PFAuthenticationLoginWithGoogleAccountGetResultSize](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleaccountgetresultsize.md)