Устранение неполадок

Информация в этом документе поможет устранить проблемы, которые могут возникнуть при внедрении функции привязки подписок .

Совет: Откройте консоль JavaScript и найдите сообщения об ошибках от клиентской библиотеки swg.js Это поможет вам выявить потенциальные проблемы в вашей реализации.

Кнопка призыва к действию при оформлении подписки зависла на экране загрузки.

Пример ошибки:

Рисунок 1. Кнопка призыва к действию для перехода на подписку не загружается.

Для решения этой проблемы проверьте следующее:

• Убедитесь, что вы добавили источники страниц, включая тестовые поддомены, в качестве дополнительных URL-адресов в настройках публикации в Центре издателя.
  • Убедитесь, что статус URL-адреса — «Проверено», а не «Проверить».
• Для реализаций Extended Access или Reader Revenue Manager Enterprise убедитесь, что вы добавили источники страниц, включая тестовые поддомены, в список авторизованных источников JavaScript клиента OAuth 2.0, настроенного для данной реализации. Это необходимо сделать в консоли Google Cloud.

Примечание: Если вы недавно добавили источники, может потребоваться до часа, прежде чем они смогут получить доступ к клиентской библиотеке swg.js

Не удалось связать учетную запись.

Пример ошибки:

Рисунок 2. Проблема: Не удалось связать учетную запись.

Для решения этой проблемы проверьте следующее:

• Обязательно примите условия использования функции привязки подписок в Центре издателя . Для этого перейдите в настройки привязки подписок и нажмите «Подписать условия использования функции привязки подписок» .
• Если учетная запись Google уже была связана, при повторной попытке привязки подписки вы получите сообщение об ошибке. Перед повторным тестированием интеграции на стороне клиента необходимо отменить привязку подписки на странице подписок в учетной записи Google.

Ошибка доступа при вызове API для привязки подписок.

Пример ошибки:

Код	403
Сообщение	'readerrevenuesubscriptionlinking.readerEntitlements.update' отклонен для ресурса '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (или же оно может и не существовать).'

Для решения этой проблемы проверьте следующее:

• Убедитесь, что вы используете тот же проект, что и указано в настройках привязки подписок . При настройке привязки подписок в Центре издателя используйте номер проекта . Номер проекта можно найти на панели управления проектом .
• Убедитесь, что API для привязки подписок включен в вашем проекте.
• В проекте «Управление идентификацией и доступом (IAM)» убедитесь, что учетной записи службы назначена роль « Администратор привязки подписок» . Обратите внимание, что распространение изменений роли по системе может занять некоторое время. Если при выполнении вызовов API вы получаете ошибку 403, даже после подтверждения того, что вашей учетной записи службы назначена правильная роль IAM, подождите несколько минут, а затем повторите запрос.

• Если вы не уверены, какие учетные записи служб использовать или имеют ли они необходимую роль IAM, воспользуйтесь анализатором политик из проекта, который вы настроили для привязки подписок. Создайте и выполните пользовательский запрос со следующими параметрами:

  Параметр 1	Роль
  Роль	Администрирование привязки подписок

• Убедитесь, что при вызове API привязки подписки вы используете правильный ключ учетной записи службы. Проверьте следующие свойства в ключе учетной записи службы (JSON-файл):

  • Тип: Это должен быть service_account.
  • project_id: Это должен быть идентификатор проекта, номер которого указан в настройках привязки подписки.
    Примечание: Идентификатор проекта и номер проекта — это два разных идентификатора, которые вы можете найти на панели управления вашего проекта .
  • client_email: Это должна быть та же учетная запись службы в IAM проекта, которая назначена роли «Администратор привязки подписок» .

• Если вы получили токен доступа через конечную точку токенов Google OAuth 2.0 (https://oauth2.googleapis.com/token), убедитесь, что токен действителен и не просрочен при вызове API для привязки подписок. Если срок действия токена истек, вам необходимо получить новый.

• Если вы используете REST API, убедитесь, что вы используете идентификатор публикации, указанный вами при настройке привязки подписки . Например, если ваш идентификатор публикации — example.com , то URL-адрес запроса должен его содержать.

  • ✅ Используйте только указанный идентификатор публикации: publications/example.com/readers/10078823/entitlements
  • ❌ Не используйте идентификатор публикации, отличный от указанного в настройках привязки подписки : publications/example-staging.com/readers/10078823/entitlements
  • ❌ Не указывайте название издания в запросе: publications/example.com:premium/readers/10078823/entitlements

Примечание: Для вступления в силу изменений разрешений в IAM может потребоваться несколько минут или больше. Для получения дополнительной информации см. раздел «Распространение изменений доступа» .

Ошибка "Недопустимый аргумент" при обновлении прав доступа.

Пример ошибки:

Сообщение

Ошибка: Запрос содержит недопустимый аргумент.

Для решения этой проблемы проверьте следующее:

• Убедитесь, что вы предоставляете объект entitlements в правильном формате. См. этот пример .
• Убедитесь, что product_id имеет формат publication_id:product .
  • ✅ Допустимый пример: "product_id":"example.com:basic"
  • ❌ Неверный пример: "product_id":"example.com"

Статьи не отображаются в результатах поиска.

Для решения этой проблемы проверьте следующее:

• Обязательно добавьте структурированные данные во все свои статьи. Используйте тест расширенных результатов , чтобы проверить правильность структурированных данных.
• Убедитесь, что в структурированные данные внесен действительный productID , соответствующий набору идентификаторов продуктов (Product ID), используемых для обновления прав доступа читателя .
• Используйте расширенный отчет о результатах поиска по запросу "подписанный контент" в Search Console , чтобы выявить любые проблемы, связанные со структурированными данными.

Примечание: При отображении результатов поиска по вашим подпискам учитываются факторы ранжирования. Это означает, что по любому поисковому запросу вам не всегда гарантировано отображение вашей новостной статьи.

Невозможно изменить язык сообщения с призывом к действию при привязке подписки.

Текст призыва к действию при оформлении подписки определяется настройками пользователя. Его нельзя изменить глобально.

Язык определяется следующим образом:

1. Если пользователь авторизован с помощью своей учетной записи Google, используется основной язык, установленный в настройках его учетной записи Google ( https://myaccount.google.com/language ).

2. Если пользователь не авторизован, язык определяется на основе основных языковых настроек его браузера или операционной системы.

Призывы к действию в разделе «Подписка» поддерживают не все языки. Если основной язык пользователя не поддерживается, призыв к действию может по умолчанию отображаться на английском языке.