Method: subscriptions.suspend

Приостанавливает активную подписку.

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

  • Для FLEXIBLE подписок выставление счетов приостанавливается.
  • Для подписок ANNUAL_MONTHLY_PAY или ANNUAL_YEARLY_PAY :
    • Приостановка подписки не меняет изначально установленную дату продления.
    • Приостановленная подписка не продлевается. Если вы активируете подписку после первоначальной даты продления, будет создана новая годовая подписка, начиная со дня активации.

Мы настоятельно рекомендуем вам приостанавливать подписку только на короткие периоды времени, поскольку приостановка на срок более 60 дней может привести к отмене подписки.

HTTP-запрос

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Это может быть либо основное доменное имя клиента, либо уникальный идентификатор клиента. Если доменное имя клиента изменится, старое доменное имя нельзя будет использовать для доступа к клиенту, но всегда можно использовать уникальный идентификатор клиента (возвращаемый API). Мы рекомендуем хранить уникальный идентификатор в ваших системах, где это возможно.

subscriptionId

string

Это обязательное свойство. subscriptionId — это идентификатор подписки, который уникален для каждого клиента. Поскольку subscriptionId меняется при обновлении подписки, мы рекомендуем не использовать этот идентификатор в качестве ключа для постоянных данных. А subscriptionId можно найти с помощью метода получения всех подписок реселлера .

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр Subscription .

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/apps.order

Дополнительную информацию см. в руководстве по авторизации .