Method: subscriptions.list

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

Opcjonalnie ta metoda może filtrować odpowiedź według parametru customerNamePrefix. Więcej informacji znajdziesz w artykule na temat zarządzania 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 przenosi 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 ulegnie zmianie, nie będzie można używać starej nazwy domeny, aby uzyskać dostęp do klienta, ale zawsze można użyć unikalnego identyfikatora klienta (wyświetlonego przez interfejs API). W stosownych przypadkach zalecamy przechowywanie unikalnego identyfikatora w swoich systemach.
customerNamePrefix

string

Podczas pobierania wszystkich subskrypcji i filtrowania danych pod kątem określonych klientów możesz wpisać prefiks nazwy klienta. Za pomocą przykładowej grupy klientów, która obejmuje exam.com, example20.com i example.com:

  • exa – zwraca wszystkie nazwy klientów zaczynające się od „exa”. które mogą obejmować exam.com, example20.com i example.com. Prefiks nazwy jest podobny do stosowania gwiazdki w wyrażeniu regularnym (exa*.
  • example – zwraca example20.com i example.com.
maxResults

integer (uint32 format)

W przypadku pobierania dużej listy wartość maxResults to maksymalna liczba wyników na stronę. Wartość nextPageToken przenosi na następną stronę. Wartością domyślną jest 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, 30-dniowym bezpłatnym okresem próbnym i opcjami odnowienia. Główną rolą 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 używany do przeglądania dużych zbiorów wyników. Podaj tę wartość w kolejnym żądaniu, aby zwrócić następną stronę wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.