Method: accounts.promotions.list

Elenca le promozioni nel tuo account Merchant Center. La risposta potrebbe contenere meno elementi di quelli specificati da pageSize. Affidati a pageToken per determinare se ci sono altri elementi da richiedere.

Dopo aver inserito o aggiornato una promozione, potrebbero essere necessari diversi minuti prima che sia possibile recuperare la promozione elaborata aggiornata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. L'account per il quale elencare le promozioni elaborate. Formato: accounts/{account}

Parametri di query

Parametri
pageSize

integer

Solo output. Il numero massimo di promozioni da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il valore massimo è 1000; valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di promozioni.

pageToken

string

Solo output. Un token di pagina, ricevuto da una precedente chiamata a promotions.list. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a promotions.list devono corrispondere alla chiamata che ha fornito il token della pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per il metodo promotions.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Campi
promotions[]

object (Promotion)

Le promozioni elaborate dall'account specificato.

nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.