咨询Google Wallet通用票证即将到来通知功能的使用方法

• 核心前提： upcoming通知不是只开enableNotifications就生效，必须依赖票证的事件时间字段，同时要完整配置通知触发规则与内容。

1. 补全票证的时间与通知配置 #

构造GenericTicket对象时，必须指定未来的EventDateTime（事件开始时间），同时在Notifications字段里完整配置upcoming通知参数，而非仅设置EnableNotifications = true。示例代码：

var genericTicket = new GenericTicket()
{
    // 票证基础字段（ID、标题、Logo等）
    Id = "your-unique-ticket-id",
    Title = "XX活动门票",
    // 关键：设置未来的事件时间，Google以此判断通知触发时机
    EventDateTime = DateTimeOffset.UtcNow.AddHours(1), 
    Notifications = new GenericTicketNotifications()
    {
        EnableNotifications = true,
        Upcoming = new UpcomingNotification()
        {
            // 提前通知的时长，单位为秒，示例为1小时
            NotifyBefore = new Duration() { Seconds = 3600 },
            // 自定义通知标题与内容
            Title = "你的活动1小时后开始！",
            Body = "记得提前到场，带好相关凭证"
        }
    }
};

2. 检查API请求的Payload完整性 #

调用Google Wallet API创建票证时，确保请求Payload包含上述完整的notifications结构。如果仅单独设置EnableNotifications，却未配置Upcoming子对象，通知逻辑会被忽略。

3. 测试与排查方法 #

• 测试时可将EventDateTime设为1小时后，创建票证后等待1小时左右（可能存在轻微延迟），查看Google Wallet是否收到推送。
• 若未收到通知，前往Google Cloud控制台的API日志，检查是否有通知相关的请求报错（如参数不合法、权限问题等）。
• 提醒用户检查Google Wallet App权限：必须开启「票证通知」权限，否则即使后端配置正确，用户也收不到推送。

常见踩坑点 #

• 漏设EventDateTime：无此字段时，Google无法判断通知触发时机，直接跳过upcoming逻辑。
• NotifyBefore参数异常：设置负数或超出1分钟至7天的范围，会被Google忽略。
• 通知内容为空：Title或Body未填写时，部分地区的系统可能不会触发推送。

内容的提问来源于stack exchange，提问作者Ali Dbouk