Method: accounts.promotions.list

Listet die Angebote in Ihrem Merchant Center-Konto auf. Die Antwort enthält möglicherweise weniger Elemente als von pageSize angegeben. Anhand von pageToken können Sie feststellen, ob weitere Artikel angefordert werden können.

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 beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. Wenn keine Angabe erfolgt, 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 Übersicht über OAuth 2.0.