Проверка

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

Как настроить аккаунт разработчика Google Play

Чтобы публиковать приложения и игры в Google Play, используйте Google Play Console. В Google Play Console вы также можете управлять товарами и настройками, связанными с платежами.

Чтобы получить доступ к Google Play Console, необходимо создать аккаунт разработчика Google Play.

Чтобы продавать приложения и контент в них в Google Play, вам также необходимо настроить профиль в платежном центре Google и связать его с аккаунтом разработчика Google Play. Подробнее о том, как связать аккаунт разработчика Google Play с платежным профилем…

Как включить функции, связанные с оплатой, в Google Play Console

После настройки аккаунта разработчика вам нужно опубликовать версию приложения, которая включает библиотеку Google Play Платежей. Это необходимо, чтобы включить в Google Play Console функции, связанные с платежами, например настройку товаров, которые вы хотите продавать.

Добавить зависимость библиотеки

Чтобы интегрировать платежную систему Google Play, сначала добавьте в приложение зависимость от библиотеки Google Play Платежей. Она предоставляет доступ к Android API, которые подключают вас к Google Play. Там вы можете получить доступ к информации о покупках, запросить обновления о покупках, предложить пользователю совершить новые покупки и многое другое.

Библиотека Google Play Платежей доступна в репозитории Maven от Google. Добавьте зависимость в файл build.gradle приложения, как показано ниже.

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Если вы используете Kotlin, то в модуле KTX библиотеки Play Платежей есть расширения Kotlin и поддержка сопрограмм, которые позволяют писать идиоматический код Kotlin при работе с платежной системой Google Play. Чтобы включить эти расширения в проект, добавьте в файл build.gradle приложения следующую зависимость:

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

В примерах кода Kotlin на этой странице по возможности используются расширения KTX.

Загрузка приложения

Добавив библиотеку в приложение, создайте и опубликуйте его. Для этого создайте приложение и опубликуйте его на любом канале, включая канал внутреннего тестирования.

Создание и настройка продуктов

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

Процесс создания контента для однократных покупок и подписок похож. Для каждого товара нужно указать уникальный идентификатор товара, название, описание и цену. Для подписок требуется дополнительная информация, например тип продления основного плана (автоматическое или по предоплате).

В Google Play Console есть веб-интерфейс, который можно использовать для управления товарами.

Вместо веб-интерфейса вы можете использовать REST-ресурс inappproducts для контента, продаваемого через приложение, и REST-ресурс monetization.subscriptions для подписок в Google Play Developer API.

Как настроить Google Play Developer API

Google Play Developer API – это межсерверный API, который дополняет библиотеку Google Play Платежей для Android. Этот API предоставляет функции, недоступные в библиотеке Google Play Платежей, например безопасную проверку покупок и возврат средств пользователям.

Чтобы интегрировать платежную систему Google Play в приложение, необходимо настроить доступ к Google Play Developer API через Google Play Console. Инструкции приведены в статье Начало работы с Google Play Developer API.

После настройки доступа к Google Play Developer API убедитесь, что вы предоставили разрешение Просмотр финансовых данных, которое необходимо для доступа к функциям, связанным с оплатой. Рекомендации и дополнительную информацию о настройке разрешений можно найти в статье Как добавлять пользователей аккаунта разработчика и управлять разрешениями.

Как настроить уведомления для разработчиков в режиме реального времени

Уведомления для разработчиков в режиме реального времени (RTDN) – это механизм, позволяющий получать уведомления от Google, когда у пользователя меняется разрешение в вашем приложении. RTDN использует Google Cloud Pub/Sub, что позволяет получать данные, которые либо отправляются на заданный вами URL, либо запрашиваются с помощью клиентской библиотеки. Это позволяет сразу реагировать на изменения статуса подписки, не обращаясь к Google Play Developer API. Обратите внимание, что неэффективное использование Google Play Developer API может привести к ограничениям квоты API.

Cloud Pub/Sub – это полностью управляемый сервис, с помощью которого можно обмениваться сообщениями между независимыми приложениями в режиме реального времени. Google Play использует Cloud Pub/Sub для публикации push-уведомлений по темам, на которые вы подписаны.

Чтобы получать уведомления, необходимо создать бэкенд-сервер, который будет обрабатывать сообщения, отправленные в вашу тему. Ваш сервер может получать эти сообщения, отвечая на HTTPS-запросы к зарегистрированной конечной точке или используя клиентские библиотеки Cloud Pub/Sub. Эти библиотеки доступны на разных языках. Дополнительную информацию можно найти в разделе Как создать подписку Pub/Sub.

Определите цены и квоты

Подробную информацию о ценах и квотах можно найти в разделах Цены и Квоты.

Оценка использования данных

Объем данных в уведомлении о подписке составляет примерно 1 КБ на запрос. Для каждой публикации и получения требуется отдельный запрос, или примерно 2 КБ данных на уведомление. Количество уведомлений в месяц зависит от платежного цикла и действий пользователей. В течение платежного цикла вы получите как минимум одно уведомление для каждого пользователя.

Настройка Cloud Pub/Sub

Чтобы включить уведомления для разработчиков в режиме реального времени, сначала настройте Cloud Pub/Sub в своем облачном проекте Google Cloud, а затем включите уведомления для приложения.

Чтобы использовать Cloud Pub/Sub, у вас должен быть проект Google Cloud с включенным Cloud Pub/Sub API. Если вы не знакомы с Google Cloud и Cloud Pub/Sub, ознакомьтесь с кратким руководством.

Создать тему

Чтобы получать уведомления, создайте тему, в которой Google Play будет их публиковать. Чтобы создать тему, следуйте инструкциям в разделе Создание темы.

Как создать подписку Pub/Sub

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

  1. Ознакомьтесь с руководством по подписке на Cloud Pub/Sub, чтобы определить, какую подписку вам нужно настроить: push или pull.
    • Подписка на push-уведомления позволяет Cloud Pub/Sub отправлять уведомления в вашу защищенную серверную часть, отправляя HTTPS-запросы.
    • При подписке с извлечением ваш защищенный внутренний сервер должен инициировать запросы к серверу Cloud Pub/Sub для получения сообщений.
  2. Создайте подписку, следуя инструкциям в статье Как добавить подписку.

Предоставьте права на публикацию по вашей теме

Чтобы Google Play мог публиковать уведомления по вашей теме, необходимо предоставить ему соответствующие разрешения в Cloud Pub/Sub.

  1. Откройте консоль Google Cloud.
  2. Выберите проект и нажмите Pub/Sub на панели навигации слева.
  3. Найдите нужную тему и откройте сведения о разрешениях.

    доступ к конфигурации для темы разрешений
    Рисунок 1. Доступ к настройкам для темы Разрешения.
  4. Добавьте сервисный аккаунт google-play-developer-notifications@system.gserviceaccount.com и назначьте ему роль Издатель Pub/Sub.

    Добавление сервисного аккаунта Google Play в качестве издателя Pub/Sub
    Рисунок 2. Добавление сервисного аккаунта Google Play в качестве издателя Pub/Sub.
  5. Нажмите Сохранить, чтобы завершить настройку темы.

    Настроенная тема Cloud Pub/Sub в консоли Google Cloud.
    Рисунок 3. настроенная тема.

Как включить уведомления для разработчиков в режиме реального времени

Чтобы включить уведомления для разработчиков в режиме реального времени, выполните следующие действия:

  1. Откройте Google Play Console.
  2. Выберите приложение.
  3. Перейдите в раздел Монетизация > Настройка монетизации.
  4. Перейдите к разделу Уведомления для разработчиков в режиме реального времени в верхней части страницы.

    Раздел "Уведомления для разработчиков в режиме реального времени" в Play Console.
    Рисунок 4. Уведомления для разработчиков в режиме реального времени.
  5. Выберите Включить уведомления в реальном времени.

  6. В поле Название темы введите полное название темы Cloud Pub/Sub, которую вы настроили ранее. Название темы должно быть указано в формате projects/{project_id}/topics/{topic_name}, где project_id – уникальный идентификатор проекта, а topic_name – название созданной ранее темы.

  7. Нажмите Отправить тестовое сообщение. Пробная публикация позволяет убедиться, что все настроено правильно. Если тестовая публикация прошла успешно, вы увидите сообщение об этом. Если вы прикрепили подписку к этой теме, вы должны получить тестовое сообщение.

    Если у вас подписка с извлечением, перейдите к ней в Cloud Console, нажмите View Messages (Посмотреть сообщения) и извлеките сообщения. Чтобы избежать повторной доставки сообщений из Cloud Pub/Sub, подтверждайте их получение. Если вы используете подписку push, проверьте, доставлено ли тестовое сообщение в конечную точку push. Код успешного ответа будет служить подтверждением сообщения.

    Если публикация не удалась, появится сообщение об ошибке. Убедитесь, что название темы указано правильно и что у сервисного аккаунта google-play-developer-notifications@system.gserviceaccount.com есть доступ к теме с ролью Издатель Pub/Sub.

  8. Выберите типы уведомлений, которые хотите получать.

    • Получать уведомления о подписках и обо всех аннулированных покупках. Вы будете получать уведомления для разработчиков в режиме реального времени, связанные с подписками и аннулированными покупками. Вы не будете получать уведомления о покупках контента, оплачиваемого однократно.
    • Получать все уведомления о подписках и контенте, оплачиваемом однократно. Вы будете получать уведомления обо всех событиях, связанных с подписками и аннулированными покупками. Вы также будете получать события покупки контента для однократных покупок, например ONE_TIME_PRODUCT_PURCHASED и ONE_TIME_PRODUCT_CANCELED. Подробнее о жизненном цикле разовой покупки, чтобы узнать больше об этих событиях покупки.
  9. Нажмите Сохранить изменения.

Проверка конфигурации

Чтобы получать уведомления для разработчиков в режиме реального времени, создайте защищенный бэкенд-сервер, который будет обрабатывать сообщения, отправленные в тему Cloud Pub/Sub.

Вы можете проверить конфигурацию, нажав кнопку Отправить тестовое сообщение в Google Play Console, как описано в предыдущем разделе. Если вы не настроили бэкенд-сервер для получения уведомлений, то можете проверить конфигурацию с помощью инструмента командной строки gcloud. Инструкции по обработке сообщений с помощью gcloud приведены в разделе Получение сообщения из подписки.

Дальнейшие действия