Method: subscriptions.list

Listy subskrypcji zarządzanych przez sprzedawcę. Lista może zawierać wszystkie subskrypcje klienta, wszystkie subskrypcje klienta lub wszystkie subskrypcje klienta, które można przenieść.

Opcjonalnie ta metoda może filtrować odpowiedź według właściwości customerNamePrefix. Więcej informacji znajdziesz w artykule o zarządzaniu subskrypcjami.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
customerAuthToken

string

Ciąg zapytania customerAuthToken jest wymagany podczas tworzenia konta sprzedawcy, które przenosi subskrypcję klienta bezpośredniego lub subskrypcję innego klienta sprzedawcy do Twojego systemu zarządzania sprzedawcy. Jest to szesnastkowy token uwierzytelniania potrzebny do ukończenia przenoszenia subskrypcji. Więcej informacji znajdziesz w Centrum pomocy dla administratorów.
customerId

string

Może to być nazwa domeny podstawowej klienta lub jego unikalny identyfikator. Jeśli nazwa domeny klienta się zmieni, nie będzie można uzyskać dostępu do klienta za pomocą starej nazwy domeny, ale zawsze będzie można użyć niepowtarzalnego identyfikatora klienta (zwróconego przez interfejs API). Zalecamy przechowywanie unikalnego identyfikatora w systemach.
customerNamePrefix

string

Podczas pobierania wszystkich subskrypcji i filtrowania według konkretnych klientów możesz wpisać prefiks nazwy klienta. Przykładowa grupa klientów, która zawiera exam.com, example20.com i example.com:

  • exa – zwraca wszystkie nazwy klientów zaczynające się od „exa”, które może obejmować exam.com, example20.com i example.com. Prefiks nazwy jest podobny do gwiazdki wyrażenia regularnego, np.*
  • example – zwraca example20.com i example.com.
maxResults

integer (uint32 format)

Podczas pobierania dużej listy maxResults to maksymalna liczba wyników na stronę. Wartość nextPageToken powoduje przejście do następnej strony. Wartość domyślna to 20.
pageToken

string

Token do określenia następnej strony na liście

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Subskrypcja zarządza relacjami między abonamentem klienta Google a kodem SKU usługi, licencjami użytkowników, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Główna rola sprzedawcy to zarządzanie subskrypcjami klienta Google.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

Identyfikuje zasób jako kolekcję subskrypcji. Wartość: reseller#subscriptions
subscriptions[]

object (Subscription)

Subskrypcje na tej stronie wyników.
nextPageToken

string

Token kontynuacji używany do przeglądania dużych zbiorów wyników. Podaj tę wartość w kolejnej prośbie o wyświetlenie kolejnej strony wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.