> ## 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.

# PFAuthenticationLoginWithGooglePlayGamesServicesRequest

> PFAuthenticationLoginWithGooglePlayGamesServicesRequest 데이터 모델. Google Play Games 로그인은 Google OAuth 2.0 자격 증명을 얻어 수행됩니다.

PFAuthenticationLoginWithGooglePlayGamesServicesRequest 데이터 모델. Google Play Games 로그인은 디바이스에서 Android용 Google Play Games 로그인 API를 사용하여 Google OAuth 2.0 자격 증명을 얻고 이를 이 API에 전달하여 수행됩니다. 사용자가 Google Play Games 계정으로 처음 로그인하는 경우이고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Google Play Games 계정에 연결됩니다. 그렇지 않으면 해당 Google Play Games 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되어, 타이틀이 사용자가 PlayFab 계정을 만들도록 안내할 수 있게 됩니다. Android 애플리케이션에서 Google Play Games 계정 자격 증명을 얻는 현재(권장) 방법은 GamesSignInClient.requestServerSideAccess()를 호출하고 이 API의 ServerAuthCode 매개 변수로 인증 코드를 보내는 것입니다. 이렇게 하기 전에 Google API Console에서 OAuth 2.0 웹 애플리케이션 클라이언트 ID를 만들고, 사용 중인 타이틀에 대해 PlayFab Game Manager Google 추가 기능에서 해당 클라이언트 ID와 비밀을 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요청할 필요가 없으므로 사용자 경험의 마찰이 최소화됩니다. 서버 인증 코드를 얻는 방법에 대한 자세한 내용은 [https://developers.google.com/games/services/android/signin](https://developers.google.com/games/services/android/signin)을 참조하세요.

## 구문

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

### 멤버

**`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 Play Games 클라이언트 API의 requestServerSideAccess()([https://developers.google.com/games/services/android/signin](https://developers.google.com/games/services/android/signin))를 호출하여 클라이언트에서 얻은 OAuth 2.0 서버 인증 코드입니다.

## 요구 사항

**헤더:** PFAuthenticationTypes.h

## 참고 항목

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


## Related topics

- [PFAuthenticationLoginWithGooglePlayGamesServicesAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleplaygamesservicesasync.md)
- [PFAuthenticationReLoginWithGooglePlayGamesServicesAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithgoogleplaygamesservicesasync.md)
- [Services C API 개요 - PFAuthenticationTypes.h](/ko/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationLoginWithGooglePlayGamesServicesGetResult](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleplaygamesservicesgetresult.md)
- [PFAuthenticationLoginWithGooglePlayGamesServicesGetResultSize](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithgoogleplaygamesservicesgetresultsize.md)
