Listen der vom Reseller verwalteten Abos. Die Liste kann alle Abos, alle Abos eines Kunden oder alle übertragbaren Abos eines Kunden enthalten.
Optional kann diese Methode die Antwort nach einem customerNamePrefix
filtern. 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 für den Zugriff auf den Kunden verwendet werden. Die eindeutige Kennung des Kunden, die von der API zurückgegeben wird, kann jedoch immer 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. Beispiel für eine Kundengruppe mit
|
maxResults |
Beim Abrufen einer langen Liste gibt |
pageToken |
Token zur Angabe der nächsten Seite in der Liste |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Ein Abo verwaltet die Beziehung zwischen dem Preismodell eines Google-Kunden und der Artikelnummer eines Produkts, Nutzerlizenzen, dem Status einer kostenlosen 30-tägigen Testversion und Verlängerungsoptionen. Eine primäre Rolle eines Resellers besteht darin, die Abos des 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 Durchblättern großer Ergebnismengen 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.