Возможности с добавленной стоимостью, Возможности с добавленной стоимостью, Возможности с добавленной стоимостью, Возможности с добавленной стоимостью

Фон

Теперь вы можете обновить объекты и классы, включив в них модули возможностей с добавленной стоимостью. Модули будут отображаться на странице сведений и могут ссылаться на контент эмитента. В этом документе описаны ключевые шаги, необходимые для включения и использования модулей с помощью API Google Кошелька.

Пример функции

Одиночный просмотр	Просмотр списка

В следующем руководстве предполагается, что вы знакомы с основными по��ятиями Google Кошелька и уже выполнили рекомендуемые предварительные требования . Любые вопросы или отзывы отправляйте в POC вашего Google Кошелька.

Этапы интеграции

Чтобы добавить новый модуль, вам необходимо обновить объект и/или класс, включив в него ValueAddedModuleData . ValueAddedModuleData имеет следующие поля:

[Обязательно] Заголовок LocalizedString

Тело LocalizedString

Изображение изображения

[Обязательно] строка uri

МодульViewConstraints viewConstraints

TimeInterval displayInterval

int32 индекс сортировки

Пример ValueAddedModuleData:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

Ожидаемое поведение

После успешного обновления объекта и/или класса вы увидите модули на соответствующем проходе. Если вы добавили только один модуль, вы увидите его на лицевой стороне пропуска.

Рекомендации по модулям возможностей добавленной стоимости

Модули — это возможность расширить возможности вашего пользователя дополнительными действиями. При создании модулей и управлении ими следует учитывать следующее:

• Модули должны быть определены с использованием соответствующего языка, чтобы указать, что они полезны для действий, чтобы помочь пользователям понять, что эти модули кликабельны.
• В модулях должны быть определены соответствующие изображения, относящиеся к конкретному модулю.
• Вы контролируете модули и должны заранее расставлять приоритеты модулей в зависимости от их важности и актуальности.
• Вам следует показывать только активные пользовательские модули. Вы можете контролировать это, установив displayInterval в модуле или заранее добавив или удалив его из класса или объекта.

Обработка исключений