Method: subscriptions.list

Списки подписок, управляемых реселлером. В список могут входить все подписки, все подписки клиента или все передаваемые подписки клиента.

При необходимости этот метод может фильтровать ответ по customerNamePrefix . Дополнительную информацию см. в разделе Управление подписками .

HTTP-запрос

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

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

Параметры запроса

Параметры
customerAuthToken

string

Строка запроса customerAuthToken требуется при создании перепродаваемой учетной записи, которая передает подписку прямого клиента или передает подписку другого клиента-посредника в управление вашего торгового посредника. Это шестнадцатеричный токен аутентификации, необходимый для завершения передачи подписки. Дополнительную информацию см. в справочном центре администратора .

customerId

string

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

customerNamePrefix

string

При получении всех ваших подписок и фильтрации по конкретным клиентам вы можете ввести префикс для имени клиента. Используя пример группы клиентов, включающей exam.com , example20.com и example.com :

  • exa — возвращает все имена клиентов, начинающиеся с «exa», которые могут включать в себя exam.com , example20.com и example.com . Префикс имени аналогичен использованию звездочки в регулярном выражении exa*.
  • example — Возвращает example20.com и example.com .

maxResults

integer ( uint32 format)

При получении большого списка maxResults — это максимальное количество результатов на странице. Значение nextPageToken приведет вас на следующую страницу. По умолчанию — 20.

pageToken

string

Токен для указания следующей страницы в списке

Тело запроса

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

Тело ответа

Подписка управляет связью плана оплаты клиента Google с номером SKU продукта, пользовательскими лицензиями, статусом 30-дневной бесплатной пробной версии и вариантами продления. Основная роль реселлера – управление подписками клиентов Google.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Поля
kind

string

Идентифицирует ресурс как коллекцию подписок. Значение: реселлер#подписки

subscriptions[]

object ( Subscription )

Подписки на этой странице результатов.

nextPageToken

string

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

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

Требуется одна из следующих областей OAuth:

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

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