Method: accounts.promotions.list

Liste les promotions dans votre compte Merchant Center. La réponse peut contenir moins d'éléments que spécifié par pageSize. Appuyez-vous sur pageToken pour déterminer si d'autres éléments peuvent être demandés.

Une fois que vous avez inséré ou mis à jour une promotion, plusieurs minutes peuvent s'écouler avant que la promotion traitée mise à jour puisse être récupérée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Compte pour lequel répertorier les promotions traitées. Format : accounts/{account}

Paramètres de requête

Paramètres
pageSize

integer

Uniquement en sortie. Nombre maximal de promotions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. Si aucune valeur n'est spécifiée, le nombre maximal de promotions est renvoyé.

pageToken

string

Uniquement en sortie. Jeton de page reçu d'un appel promotions.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à promotions.list doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour la méthode promotions.list.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Champs
promotions[]

object (Promotion)

Promotions traitées à partir du compte spécifié.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.