Google Wallet API позволяет вашим пользователям добавлять объект в Google Wallet из Интернета. Пользователи могут добавлять свои карты прямо с вашего сайта.
В этом справочном материале содержится подробная информация об HTML-элементе g:savetoandroidpay
, отображающем кнопку Google Wallet API, а также о веб-маркере JSON , описывающем вашу веб-службу для Google.
JavaScript API Google Кошелька
Для автоматического анализа HTML-тегов g:savetoandroidpay
при загрузке включите стандартный JavaScript
<script src="https://apis.google.com/js/platform.js" type="text/javascript"></script>
Для приложений AJAX и явного отображения кнопок Google Wallet API включите параметр "parsetags": "explicit"
.
<script src="https://apis.google.com/js/platform.js" type="text/javascript"> {"parsetags": "explicit"} </script>
HTML-тег g:savetoandroidpay
Тег пространства имен g:savetoandroidpay
определяет положение и различные атрибуты кнопки «Сохранить в Google Кошелек». Используйте этот тег, если вы выполняете рендеринг на стороне сервера HTML и JWT.
<g:savetoandroidpay jwt="JWT" onsuccess="successHandler" onfailure="failureHandler" />
Поле | Тип | Необходимый | Описание |
---|---|---|---|
height | Нить | Н | Высота отображаемой кнопки. Возможные значения: small (высота 30 пикселей) и standard (высота 38 пикселей). height по умолчанию small . Обратитесь к кнопкам Google Wallet API , чтобы увидеть образцы кнопок с различными настройками height . |
jwt | Нить | Д | API Google Кошелька JWT. |
onsuccess | Нить | Н | Строковое имя функции обработчика обратного вызова при успешном добавлении. |
onfailure | Нить | Н | Строковое имя функции обработчика обратного вызова при сбое сохранения. Этой функции передается объект ошибки, содержащий errorCode и errorMessage. |
onprovidejwt | Нить | Н | Строковое имя предоставляемой функции обработчика JWT. Цель этой функции — перехватить и потенциально манипулировать данными JWT до того, как объект будет сохранен в Google Wallet. Эта функция не принимает никаких параметров и должна возвращать JWT в виде строки. При реализации обработчика событий исходные данные JWT можно получить в поле this.getOpenParams().renderData.userParams.jwt . |
size | Нить | Н | Ширина отображаемой кнопки. Вы можете установить size matchparent , чтобы ширина соответствовала ширине родительского элемента. Или оставьте size неопределенным, чтобы ширина растягивалась до ширины text . Обратитесь к кнопкам Google Wallet API , чтобы увидеть образцы кнопок с различными настройками size . |
text | Нить | Н | Устаревший |
textsize | Нить | Н | Когда textsize=large , отображается значительно увеличенный размер текста и размер кнопок для случаев с особыми требованиями к пользовательскому интерфейсу. |
theme | Нить | Н | Тема кнопки для отображения. Возможные значения: dark и light . Тема по умолчанию dark . См. кнопки Google Wallet API , чтобы увидеть примеры кнопок с различными настройками theme . |
Функция gapi.savetoandroidpay.render
Эта функция позволяет явно отображать кнопку Google Wallet API.
gapi.savetoandroidpay.render("dom-container",{ "jwt": "JWT", "onsuccess": "successHandler", "onfailure": "failureHandler" });
Поле | Тип | Необходимый | Описание |
---|---|---|---|
dom-container | Нить | Д | ID контейнера для размещения кнопки Google Wallet API. |
jwt | Нить | Д | JWT определяет содержимое для сохранения. |
onsuccess | Нить | Н | Строковое имя функции обработчика обратного вызова при успешном сохранении. |
onfailure | Нить | Н | Строковое имя функции обработчика обратного вызова при сбое сохранения. Этой функции передается объект ошибки, содержащий errorCode и errorMessage. |
onprovidejwt | Нить | Н | Строковое имя предоставляемой функции обработчика JWT. Цель этой функции — перехватить данные JWT и потенциально манипулировать ими до того, как объект будет сохранен в Google Wallet. Эта функция не принимает никаких параметров и должна возвращать JWT в виде строки. При реализации обработчика событий исходные данные JWT можно получить в поле this.getOpenParams().renderData.userParams.jwt . |
Коды ошибок и сообщения Google Wallet API
В следующих таблицах перечислены коды ошибок и сообщения об ошибках по умолчанию, которые передаются в объекте ошибки в функцию обратного вызова при сбое, когда объект не удается успешно сохранить с помощью кнопки javascript.
{ "errorCode": "errorCode", "errorMessage": "errorMessage" }
errorCode | errorMessage |
---|---|
SERVICE_FAILURE | Произошла ошибка на сервере Google Кошелька. |
CLASS_NOT_FOUND | Класс, указанный в объекте, не найден. |
CLASS_MISMATCH | Объект должен присутствовать, того же типа и должен ссылаться на вложенный класс. |
ORIGIN_MISMATCH | Происхождение кнопки не совпадает с указанным в списке происхождений. |
INVALID_NUM_TYPES | Можно указать только один тип объекта. |
INVALID_SIGNATURE | Подпись проверить не удалось. |
INVALID_DUPLICATE_IDS | Дублирование объектов или классов не допускается. |
INVALID_JWT | Недействительный JWT. |
INVALID_EXP_IAT | Срок действия JWT истек или он был выпущен в будущем. |
INVALID_AUD | Недопустимое значение для поля AUD. |
INVALID_TYP | Недопустимое значение для поля TYP. |
INVALID_NUM_OBJECTS | Для карт лояльности, подарочных карт и предложений можно указать ровно один объект и не более одного класса. |
MALFORMED_ORIGIN_URL | Неверный URL-адрес источника. URL должен содержать протокол и домен. |
MISSING_ORIGIN | Происхождение должно быть указано. |
MISSING_FIELDS | В закрытом объекте или классе отсутствовали обязательные поля. |
Локализация
Язык кнопки JavaScript меняется в зависимости от следующих критериев:
- Если пользователь вошел в Google, кнопка отображается на предпочитаемом языке, указанном в профиле пользователя в учетной записи Google . Пользователь может прочитать Изменить язык , чтобы узнать, как изменить предпочитаемый язык своей учетной записи Google.
- Если пользователь не вошел в Google, кнопка использует значение
ACCEPT-LANGUAGE
в заголовке HTTP.
Если вы заметили, что кнопка не отображается на правильном языке в соответствии с приведенной выше логикой или формулировка неестественна, обратитесь в нашу службу поддержки .