实时开发者通知参考指南

2023-09-25 19:20| 来源: 网络整理| 查看: 265

本主题列出并描述了您可以从 Google Play 收到的实时开发者通知的类型。

注意：您必须在收到实时开发者通知后调用 Google Play Developer API，以获取完整状态并更新您自己的后端状态。此类通知只会告知您购买状态发生了变化，而不会为您提供有关购买交易的完整信息。编码

发布到 Cloud Pub/Sub 主题的每条消息都包含一个以 base64 编码的数据字段。

{ "message": { "attributes": { "key": "value" }, "data": "eyAidmVyc2lvbiI6IHN0cmluZywgInBhY2thZ2VOYW1lIjogc3RyaW5nLCAiZXZlbnRUaW1lTWlsbGlzIjogbG9uZywgIm9uZVRpbWVQcm9kdWN0Tm90aWZpY2F0aW9uIjogT25lVGltZVByb2R1Y3ROb3RpZmljYXRpb24sICJzdWJzY3JpcHRpb25Ob3RpZmljYXRpb24iOiBTdWJzY3JpcHRpb25Ob3RpZmljYXRpb24sICJ0ZXN0Tm90aWZpY2F0aW9uIjogVGVzdE5vdGlmaWNhdGlvbiB9", "messageId": "136969346945" }, "subscription": "projects/myproject/subscriptions/mysubscription" }

对以 base64 编码的数据字段进行解码后，DeveloperNotification 包含以下字段：

{ "version": string, "packageName": string, "eventTimeMillis": long, "oneTimeProductNotification": OneTimeProductNotification, "subscriptionNotification": SubscriptionNotification, "testNotification": TestNotification }

下表对这些字段进行了说明。

属性名称值说明 version string 此通知的版本。最初，此值为“1.0”。此版本与其他版本字段不同。 packageName string 与此通知相关的应用的软件包名称（例如“com.some.thing”）。 eventTimeMillis long 事件发生的时间戳，以从公元纪年开始计算的毫秒数表示。 subscriptionNotification SubscriptionNotification 如果此字段存在，则此通知与订阅相关，并且此字段包含与订阅相关的其他信息。请注意，此字段与 testNotification 和 oneTimeProductNotification 互斥。 oneTimeProductNotification OneTimeProductNotification 如果此字段存在，则此通知与一次性购买相关，并且此字段包含与购买交易相关的其他信息。请注意，此字段与 testNotification 和 subscriptionProductNotification 互斥。 testNotification TestNotification 如果此字段存在，则此通知与测试发布相关。这些只通过 Google Play 管理中心发送。请注意，此字段与 subscriptionNotification 和 oneTimeProductNotification 互斥。 SubscriptionNotification

SubscriptionNotification 包含以下字段：

{ "version": string, "notificationType": int, "purchaseToken": string, "subscriptionId": string } 属性名称值说明 version string 此通知的版本。最初，此值为“1.0”。此版本与其他版本字段不同。 notificationType int 订阅的 notificationType 可以具有以下值： (1) SUBSCRIPTION_RECOVERED - 从帐号保留状态恢复了订阅。 (2) SUBSCRIPTION_RENEWED - 续订了处于活动状态的订阅。 (3) SUBSCRIPTION_CANCELED - 自愿或非自愿地取消了订阅。如果是自愿取消，在用户取消时发送。 (4) SUBSCRIPTION_PURCHASED - 购买了新的订阅。 (5) SUBSCRIPTION_ON_HOLD - 订阅已进入帐号保留状态（如果已启用）。 (6) SUBSCRIPTION_IN_GRACE_PERIOD - 订阅已进入宽限期（如果已启用）。 (7) SUBSCRIPTION_RESTARTED - 用户已通过 Play > 帐号 > 订阅恢复了订阅。订阅已取消，但在用户恢复时尚未到期。如需了解详情，请参阅恢复。 (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED - 用户已成功确认订阅价格变动。 (9) SUBSCRIPTION_DEFERRED - 订阅的续订时间点已延期。 (10) SUBSCRIPTION_PAUSED - 订阅已暂停。 (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - 订阅暂停计划已更改。 (12) SUBSCRIPTION_REVOKED - 用户在到期时间之前已撤消订阅。 (13) SUBSCRIPTION_EXPIRED - 订阅已到期。 purchaseToken string 购买订阅时向用户设备提供的令牌。 subscriptionId string 所购买订阅的商品 ID（例如“monthly001”）。示例

下面是新订阅购买的通知示例：

{ "version":"1.0", "packageName":"com.some.thing", "eventTimeMillis":"1503349566168", "subscriptionNotification": { "version":"1.0", "notificationType":4, "purchaseToken":"PURCHASE_TOKEN", "subscriptionId":"monthly001" } } OneTimeProductNotification 注意：仅针对某些类型的一次性购买发送 OneTimeProductNotification。如需了解详情，请参阅将库集成到您的应用中。

OneTimeProductNotification 包含以下字段：

{ "version": string, "notificationType": int, "purchaseToken": string, "sku": string } 属性名称值说明 version string 此通知的版本。最初，此值为“1.0”。此版本与其他版本字段不同。 notificationType int 通知的类型。它可以具有以下值： (1) ONE_TIME_PRODUCT_PURCHASED - 用户成功购买了一次性商品。 (2) ONE_TIME_PRODUCT_CANCELED - 用户已取消待处理的一次性商品购买交易。 purchaseToken string 购买时向用户设备提供的令牌。 sku string 购买的一次性商品的商品 ID（例如“sword_001”）。示例

下面是新一次性购买的通知示例：

{ "version":"1.0", "packageName":"com.some.thing", "eventTimeMillis":"1503349566168", "oneTimeProductNotification": { "version":"1.0", "notificationType":1, "purchaseToken":"PURCHASE_TOKEN", "sku":"my.sku" } } TestNotification

TestNotification 包含以下字段：

{ "version": string } 属性名称值说明 version string 此通知的版本。最初，此值为“1.0”。此版本与其他版本字段不同。示例

下面是测试通知的示例：

{ "version":"1.0", "packageName":"com.some.thing", "eventTimeMillis":"1503350156918", "testNotification": { "version":"1.0" } }

【本文地址】

实时开发者通知参考指南

实时开发者通知参考指南

今日新闻

推荐新闻