Listen der Abos, die vom Reseller verwaltet werden. Die Liste kann alle Abos, alle Abos eines Kunden oder alle übertragbaren Abos eines Kunden enthalten.
Optional kann mit dieser Methode die Antwort nach einem customerNamePrefix
gefiltert werden. Weitere Informationen finden Sie unter Abos verwalten.
HTTP-Anfrage
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
customerAuthToken |
Der Abfragestring |
customerId |
Das kann entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden sein. Wenn sich der Domainname für einen Kunden ändert, kann der alte Domainname nicht mehr für den Zugriff auf den Kunden verwendet werden. Es kann jedoch immer die eindeutige ID des Kunden (die von der API zurückgegeben wird) verwendet werden. Wir empfehlen, die eindeutige Kennung gegebenenfalls in Ihren Systemen zu speichern. |
customerNamePrefix |
Wenn Sie alle Ihre Abos abrufen und nach bestimmten Kunden filtern, können Sie ein Präfix für einen Kundennamen eingeben. Hier ein Beispiel für eine Kundengruppe mit
|
maxResults |
Beim Abrufen einer großen Liste ist |
pageToken |
Token zur Angabe der nächsten Seite in der Liste |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Mit einem Abo wird die Beziehung zwischen dem Preismodell eines Google-Kunden mit der Artikelnummer, den Nutzerlizenzen, dem Status der kostenlosen 30-tägigen Testversion und den Verlängerungsoptionen verwaltet. Eine Hauptaufgabe von Resellern besteht darin, die Abos von Google-Kunden zu verwalten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"kind": string,
"subscriptions": [
{
object ( |
Felder | |
---|---|
kind |
Kennzeichnet die Ressource als Sammlung von Abos. Wert: reseller#subscriptions |
subscriptions[] |
Die Abos auf dieser Ergebnisseite. |
nextPageToken |
Das Fortsetzungstoken, das zum Durchsuchen großer Ergebnissätze verwendet wird. Geben Sie diesen Wert in einer nachfolgenden Anfrage an, um die nächste Ergebnisseite zurückzugeben. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/apps.order
https://www.googleapis.com/auth/apps.order.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.