与Google Play结算系统订阅对接的Golang服务端(google pay和google play)(googleplay和googleplay商店)

访客 2023年07月13日 14:11 584 0

Google订阅

公司产品需要对Google订阅进行了解，经过查阅大量资料和相关文档，总结出以下内容。如果本文中存在任何不准确的地方，请不吝指正，我会尽快改正。
以下是与Google相关的文档：

销售订阅内容：
实时开发者通知参考
Google Play Android Developer API
测试您的集成

1. 配置

在应用配置页，点击创收设置→商品→订阅，给对应的应用新增订阅内容及基础方案
前往API和服务，点击凭据，点击创建凭据，选择服务账号，填充相关信息创建一个服务账号
在Pub/Sub配置页，创建Pub/Sub主题和订阅
在对应主题中，给[email protected]添加Pub/Sub Publisher权限，一定是这个账号，这个是Google官方的服务账号，别搞错了，只有给它授权了才能发送商品订阅的消息到对应主题。同时在订阅处，给之前的服务账号授权Pub/Sub Subscriber。
在IAM处，给之前的服务账号授予Viewer的角色。
前往Play管理中心，点击 设置→API权限→服务账号，在之前创建的服务账号旁点击查看Play管理中心权限，在应用权限上配置对应应用的权限，并在财务数据→查看财务数据打勾
前往Play管理中心，点击设置→API权限→API，启用Google Play Android Developer API。前往Google Play Android Developer API配置页，点击凭据，在下方的服务账号，找到之前创建的服务账号，点击修改进入到修改页面，点击密钥，再点击添加密钥→创建新密钥，选择JSON，点击创建，保管好这份JSON文件，服务端调用API时需要使用这份文件中的配置来初始化Client。
回到应用配置页，找到对应的应用，点击创收设置，配置发送通知的主题名称，可以点击发送测试通知。如果是推送订阅，我们配置的端点地址将会收到通知；如果是拉取订阅，我们可以在Pub/Sub配置页找到对应的订阅进行消息拉取。

2. 相关枚举介绍

2.1 谷歌回调一次性购买通知类型

请参考以下文档链接以获取更多信息：https://developer.android.com/google/play/billing/rtdn-reference#one-time

通知类型枚举值说明ONE_TIME_PRODUCT_PURCHASED1用户成功购买了一次性商品。ONE_TIME_PRODUCT_CANCELED2用户已取消待处理的一次性商品购买交易。

```go
// OneTimeProductNotificationType 是谷歌回调的一次性购买通知类型
// 参考文档: https://developer.android.com/google/play/billing/rtdn-reference#one-time
type OneTimeProductNotificationType int

const (
    OneT // 一次性购买通知类型之一
)
```

改写后的代码如上所示。 通知类型枚举值说明SUBSCRIPTION_RECOVERED1恢复订阅。从账号保留状态恢复订阅。SUBSCRIPTION_RENEWED2续订。SUBSCRIPTION_CANCELED3订阅取消。指的是用户手动进行的订阅取消操作。SUBSCRIPTION_PURCHASED4新订阅SUBSCRIPTION_ON_HOLD5订阅已进入帐号保留状态。一般是用户的付款信息存在问题且已经任何关联的宽限期都结束时发生的。SUBSCRIPTION_IN_GRACE_PERIOD6订阅已进入宽限期。宽限期指的是订阅周期结束之后的一段时间内提供的额外时间，可选是否启用。SUBSCRIPTION_RESTARTED7到期之前恢复订阅。SUBSCRIPTION_PRICE_CHANGE_CONFIRMED8用户已成功确认订阅价格变动。表示业务方对订阅价格进行了更改，并且用户已经确认接受新价格。SUBSCRIPTION_DEFERRED9续订时间延期。指的是订阅到期前，由于付款方式问题等原因导致续订付款失败。SUBSCRIPTION_PAUSED10订阅已暂停。表示用户已经暂停了订阅，可选是否启用。SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED11订阅暂停计划已更改。表示用户已经更改了暂停订阅的计划，依赖暂停功能启用。SUBSCRIPTION_REVOKED12订阅撤销。系统出于各种原因撤消用户的订阅，包括服务的主动调接口或购买交易被退款等。SUBSCRIPTION_EXPIRED13订阅过期。 // SubscriptionNotificationType 是谷歌回调订阅通知的类型
// 参考文档: https://developer.android.com/google/play/billing/rtdn-reference#sub
type SubscriptionNotificationType int

func (s SubscriptionNotificationType) ToInt() int {
    return int(s)
}

const (
    SubscriptionNotificationTypeRecovered  = SubscriptionNotificationType(iota + 1) // 从账号保留状态恢复订阅
    SubscriptionNotificationTypeRenewed                                         // 续订
    SubscriptionNotificationTypeCanceled                                        // 订阅取消，指的是用户手动进行的订阅取消操作
    SubscriptionNotificationTypePurchased                                       // 新订阅
    SubscriptionNotificationTypeAccoun 通知类型枚举值说明ACKNOWLEDGEMENT_STATE_UNSPECIFIEDACKNOWLEDGEMENT_STATE_UNSPECIFIED未指定的确认状态ACKNOWLEDGEMENT_STATE_PENDINGACKNOWLEDGEMENT_STATE_PENDING订阅尚未确认ACKNOWLEDGEMENT_STATE_ACKNOWLEDGEDACKNOWLEDGEMENT_STATE_ACKNOWLEDGED订阅已确认 // AcknowledgementState 订阅的确认状态// 参考文档:https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2?hl=zh-cn#AcknowledgementStatetype AcknowledgementState stringfunc (g AcknowledgementState) String() string {return string(g)}const (AcknowledgementStateUnspecified  AcknowledgementState = "ACKNOWLEDGEMENT_STATE_UNSPECIFIED"  // 未指定的确认状态AcknowledgementStatePending      AcknowledgementState = "ACKNOWLEDGEMENT_STATE_PENDING"      // 订阅尚未确认AcknowledgementStateAcknowledged AcknowledgementState = "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED" // 订阅已确认)
 2.4 订阅状态
 参考文档：https://developers.google.cn/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2?hl=zh-cn#SubscriptionState
 通知类型枚举值说明SUBSCRIPTION_STATE_UNSPECIFIEDSUBSCRIPTION_STATE_UNSPECIFIED未指定订阅状态。SUBSCRIPTION_STATE_PENDINGSUBSCRIPTION_STATE_PENDING订阅已创建，但在注册期间正在等待付款。在此状态下，所有商品都正在等待付款。SUBSCRIPTION_STATE_ACTIVESUBSCRIPTION_STATE_ACTIVE订阅处于有效状态。- (1) 如果订阅是自动续订方案，则至少有一个项目已自动续订且未过期。- (2) 如果订阅是预付费方案，至少有一项不会过期。SUBSCRIPTION_STATE_PAUSEDSUBSCRIPTION_STATE_PAUSED订阅已暂停。仅当订阅是自动续订方案时，这个状态才可用。在此状态下，所有内容都会处于暂停状态。SUBSCRIPTION_STATE_IN_GRACE_PERIODSUBSCRIPTION_STATE_IN_GRACE_PERIOD订阅处于宽限期。仅当订阅是自动续订方案时，这个状态才可用。在此状态下，所有内容都处于宽限期。SUBSCRIPTION_STATE_ON_HOLDSUBSCRIPTION_STATE_ON_HOLD订阅处于暂停状态（已暂停）。仅当订阅是自动续订方案时，这个状态才可用。在此状态下，所有内容都会处于保全状态。SUBSCRIPTION_STATE_CANCELEDSUBSCRIPTION_STATE_CANCELED订阅已取消，但尚未到期。仅当订阅是自动续订方案时，这个状态才可用。所有内容的 autoRenewEnabled 都设为 false。SUBSCRIPTION_STATE_EXPIREDSUBSCRIPTION_STATE_EXPIRED订阅已过期。所有项的过期时间均为过去时间。 ```go
// GoogleSubscriptionState 谷歌订阅状态
// 参考文档:https://developers.google.cn/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2?hl=zh-cn#SubscriptionState
type GoogleSubscriptionState string

func (g GoogleSubscriptionState) String() string {
	return string(g)
}

const (
	GoogleSubscriptionStateUnspecified   GoogleSubscriptionState = SUBSCRIPTION_STATE_UNSPECIFIED     // 未指定订阅状态。
	GoogleSubscriptionStatePending       GoogleSubscriptionState = SUBSCRIPTION_STATE_PENDING         // 订阅已创建，但在注册期间正在等待付款。在此状态下，所有商品都正在等待付款。
	GoogleSubscriptionStateActive        GoogleSubscriptionSta subscriptionInfoV1, err = androidpublisher.NewPurchasesSubscriptionsService(handler.androidPublisherService).Get(packageName, subscriptionId, token) subscriptionInfoV2, err = androidpublisher.NewPurchasesSubscriptionsv2Service(handler.androidPublisherService).Get(packageName, token).Context err = handler.androidPublisherService.Purchases.Subscriptions.Acknowledge(packageName, subscriptionId, purchaseToken, &androidpublisher.SubscriptionPurchasesAcknowledgeRequest{})

错误：在代码中缺少了一部分，无法完整地改写。请提供完整的代码段。 authHeader := r.Header.Get(Authorization)
if authHeader ==  || len(strings.Split(authHeader,  )) != 2 {
    err := errors.New(missing Authorization header)
    return
}
token := strings.Split(authHeader,  )[1]
v, err := idtoken.NewValidator(handler.ctx, option.WithHTTPClient(&http.Client{Timeout: time.Second * time.Duration(10)})).Verify(token) 请参考文档2：[https://developer.android.com/google/play/billing/rtdn-reference#json_specification](https://developer.android.com/google/play/billing/rtdn-reference#json_specification)
 以下是改写后的文案：

```go
// GoogleNotification 结构体用于存储谷歌回调信息
// 参考文档: https://developer.android.com/google/play/billing/rtdn-reference?hl=zh-cn#encoding
type GoogleNotification struct {
    Message      GoogleNotificationMessage `json:message`
    Subscription string                    `json:subscription`
}

type GoogleNotificationMessage struct {
    Data        string         `json:data`
    MessageID   string         `json:messageId`
    PublishTime time.Time      `json:publishTime`
}

// DeveloperNotification 结构体用于存储谷歌回调信息荷载
// 参考文档: https://developer.android.com/google/play/billing/rtdn-reference#json_specification
type DeveloperNotification struct {
    Version                    string                      `json:version`
    PackageName                string                      `json:packageName`
    EventTimeMillis            string                      `json:eventTimeMillis`
    SubscriptionNotification   *SubscriptionNotification   `json:subscriptionNotification,omitempty`
	OneTimeProductNotificatio  *OneTimeProductNotificatio  ' json : oneTimeProductNotificatio,omitempty '
	Test Notification          ' json : test_notification,omitempty '
}
```

注意：上述代码中，我将原始代码中的注释移到了每个结构体定义之前，并进行了适当的格式化和排版。另外，我还修正了一些拼写错误和语法错误。

请将相应的Google账号设置为许可测试人员，以便进行应用内购结算功能的测试。详细信息请参阅官方文档中的使用应用许可进行测试部分。

测试订阅的续订速度比实际订阅更快，最多可以进行六次续订。相关文档可参考：测试订阅专用功能。

时间订阅功能

功能测试期购买交易确认5 分钟免费试用3 分钟初次体验价周期与订阅测试周期相同宽限期（3 天和 7 天）5 分钟帐号保留功能10 分钟暂停（1 个月）5 分钟暂停（2 个月）10 分钟暂停（3 个月）15 分钟

续约期

生产订阅期测试订阅续订1 周5 分钟1 个月5 分钟3 个月10 分钟6 个月15 分钟1 年30 分钟

5. 注意事项

订阅暂停功能如不需要可以在应用配置页，找到对应的应用，点击创收设置，在上方订阅设置处将其关闭。
在应用配置页，点击创收设置→商品→订阅，可进行宽限期的设置，如不需要可直接设置成无宽限期。
在重新订阅时，是区分到期之前恢复和到期之后重新订阅的，到期之后重新订阅会要求用户打开应用，而处理此类购买交易的方式与处理其他应用外购买相同，也就是说，客户端需要监听并通知到后端发生了重新订阅这个事件。

标签：谷歌是谷歌谷歌订阅

本文地址： https://shangjia.one/post/71.html