Method: subscriptions.list

listy subskrypcji zarządzanych przez sprzedawcę. Lista może zawierać wszystkie subskrypcje, wszystkie subskrypcje klienta lub wszystkie przenoszone subskrypcje klienta.

Opcjonalnie metoda może odfiltrować odpowiedź według 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

Parametr zapytania customerAuthToken jest wymagany podczas tworzenia konta sprzedawcy, które przenosi subskrypcję klienta indywidualnego lub przenosi subskrypcję innego klienta sprzedawcy do zarządzania przez sprzedawcę. To szesnastkowy token uwierzytelniania potrzebny do przeniesienia 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 ulegnie zmianie, nie będzie można jej używać do uzyskiwania dostępu do klienta, ale zawsze można użyć jego unikalnego identyfikatora (zwracanego przez interfejs API). W stosownych przypadkach zalecamy przechowywanie w swoich systemach unikalnego identyfikatora.
customerNamePrefix

string

Podczas pobierania wszystkich subskrypcji i filtrowania ich według konkretnych klientów możesz wpisać prefiks nazwy klienta. Na przykładzie grupy klientów, która obejmuje klientów exam.com, example20.com i example.com:

  • exa – zwraca wszystkie nazwy klientów, które zaczynają się od „exa”, np. exam.com, example20.com i example.com. Prefiks nazwy jest podobny do gwiazdki w wyrażeniu regularnym, np. exa*.
  • example – zwraca wartości example20.com i example.com.
maxResults

integer (uint32 format)

Podczas pobierania dużej listy parametr maxResults to maksymalna liczba wyników na stronę. Wartość nextPageToken przekierowuje Cię na następną stronę. Wartość domyślna to 20.
pageToken

string

Token określający następną stronę na liście

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Subskrypcja zarządza relacją abonamentu klienta Google z kodem SKU produktu, licencjami użytkownika, stanem 30-dniowego bezpłatnego okresu próbnego i opcjami odnowienia. Głównym zadaniem sprzedawcy jest 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 zbiór subskrypcji. Wartość: reseller#subscriptions
subscriptions[]

object (Subscription)

subskrypcje na tej stronie wyników;
nextPageToken

string

token kontynuacji, który służy do przewijania dużych zbiorów wyników. Aby pobrać kolejną stronę wyników, podaj tę wartość w koleistycznym żądaniu.

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 dotyczącym autoryzacji.