Google은 흑인 공동체를 위한 인종 간 평등을 진전시키기 위해 노력하고 있습니다. Google에서 어떤 노력을 하고 있는지 확인하세요.

일회성 제품 관련 기능 추가

이 문서에서는 일회성 제품과 관련된 기능을 구현하는 방법을 설명합니다.

Google Play 결제에서는 다음과 같은 일회성 제품 유형을 지원합니다.

  • 비소비성 일회성 제품은 프리미엄 업그레이드와 같이 영구적인 효과를 제공하는 제품입니다. 사용자가 이러한 제품을 다시 구매하지 않도록 하려면 소비되는 제품으로 표시해서는 안 됩니다.

  • 소비성 일회성 제품은 일시적인 혜택을 제공하며, 게임 내 추가 통화나 추가 게임 수명과 같이 다시 구매할 수 있습니다. 소비성 일회성 제품을 다시 구매할 수 있도록 하려면 Google Play에 소비 요청을 보내야 합니다.

일회성 제품이 소비되었음을 나타내기

일회성 제품이 소비되었음을 나타내려면 BillingClient 인스턴스에서 consumeAsync()를 호출하고, Google Play에서 다시 구매할 수 있도록 할 구매 토큰을 포함합니다. 또한 ConsumeResponseListener 인터페이스를 구현하는 객체를 전달해야 합니다. 이 객체는 소비 작업의 결과를 처리합니다. 작업이 완료되면 Google Play 결제 라이브러리에서 호출하는 ConsumeResponseListener 인터페이스의 onConsumeResponse() 메서드를 재정의할 수 있습니다.

구매가 완료되면 사용자가 구매한 인앱 상품 1개를 나타내는 고유 식별자인 구매 토큰이 생성됩니다. Purchase 객체에서 getPurchaseToken()을 호출하여 연결된 토큰을 검색할 수도 있습니다.

다음 예는 관련 구매 토큰을 사용하는 제품 소비를 나타냅니다.

Kotlin

val consumeParams =
    ConsumeParams.newBuilder()
        .setPurchaseToken(/* token */)
        .setDeveloperPayload(/* payload */)
        .build()

billingClient.consumeAsync(consumeParams, { billingResult, outToken ->
    if (billingResult.responseCode == BillingResponse.OK) {
        // Handle the success of the consume operation.
        // For example, increase the number of coins inside the user's basket.
    }
})

자바

ConsumeParams consumeParams =
    ConsumeParams.newBuilder()
        .setPurchaseToken(/* token */)
        .setDeveloperPayload(/* payload */)
        .build();

ConsumeResponseListener listener = new ConsumeResponseListener() {
    @Override
    public void onConsumeResponse(BillingResult billingResult, String outToken) {
            if (billingResult.getResponseCode() == BillingResponse.OK) {
                // Handle the success of the consume operation.
                // For example, increase the number of coins inside the user's basket.
    }
};

billingClient.consumeAsync(consumeParams, listener);

소비 요청이 실패하는 경우가 있으므로 보안 백엔드 서버에서 각 구매 토큰이 사용되지 않았는지 확인해야 합니다. 또는 상품을 프로비저닝하기 전에 Google Play에서 성공적인 소비 응답을 받을 때까지 기다릴 수도 있습니다. Google Play에서 성공적인 소비 응답을 보낼 때까지 사용자의 구매를 보류하기로 선택하는 경우 소비 요청 후 구매 추적을 놓치지 않도록 매우 주의해야 합니다.

일회성 제품의 프로모션 구현

프로모션 또는 프로모션 코드를 사용하면 한정된 수의 사용자에게 일회성 제품이나 정기 결제 체험판을 무료로 제공할 수 있습니다. 일회성 제품의 프로모션 코드를 구현하려면 프로모션 구현을 참조하세요.

다음 단계

일회성 제품 관련 기능을 추가한 후 권장사항을 참조하세요.