Method: accounts.promotions.list

Lista as promoções na sua conta do Merchant Center. A resposta pode conter menos itens do que o especificado por pageSize. Use pageToken para determinar se há mais itens a serem solicitados.

Depois de inserir ou atualizar uma promoção, pode levar vários minutos até que a promoção processada atualizada possa ser recuperada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. A conta para listar as promoções processadas. Formato: accounts/{account}

Parâmetros de consulta

Parâmetros
pageSize

integer

Apenas saída. O número máximo de promoções a serem retornadas. O serviço pode retornar menos que esse valor. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000. Se não for especificado, o número máximo de promoções será retornado.
pageToken

string

Apenas saída. Um token de página recebido de uma chamada promotions.list anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para promotions.list precisam corresponder à chamada que forneceu o token da página.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para o método promotions.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Campos
promotions[]

object (Promotion)

As promoções processadas da conta especificada.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.