Method: accounts.promotions.list

Hier werden die Angebote in Ihrem Merchant Center-Konto aufgeführt. Die Antwort enthält möglicherweise weniger Elemente als in pageSize angegeben. Anhand von pageToken kannst du feststellen, ob weitere Elemente angefordert werden müssen.

Nach dem Einfügen oder Aktualisieren eines Angebots kann es einige Minuten dauern, bis das aktualisierte verarbeitete Angebot abgerufen werden kann.

HTTP-Anfrage

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Konto, für das verarbeitete Angebote aufgelistet werden sollen. Format: accounts/{account}

Suchparameter

Parameter
pageSize

integer

Nur Ausgabe. Die maximale Anzahl der zurückzugebenden Angebote. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert ist 250. werden Werte über 250 in 250 umgewandelt. Wenn nicht angegeben, wird die maximale Anzahl von Angeboten zurückgegeben.
pageToken

string

Nur Ausgabe. Ein Seitentoken, das von einem vorherigen promotions.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für promotions.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für die Methode promotions.list.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Felder
promotions[]

object (Promotion)

Die verarbeiteten Angebote aus dem angegebenen Konto.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.