Method: accounts.promotions.list

Muestra las promociones de tu cuenta de Merchant Center. Es posible que la respuesta contenga menos elementos que los especificados por pageSize. Confía en pageToken para determinar si hay más elementos por solicitar.

Después de insertar o actualizar una promoción, pueden pasar varios minutos hasta que se pueda recuperar la promoción procesada y actualizada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. La cuenta para la que se mostrarán las promociones procesadas. Formato: accounts/{account}

Parámetros de consulta

Parámetros
pageSize

integer

Solo salida. Es la cantidad máxima de promociones que se mostrarán. El servicio puede mostrar menos que este valor. El valor máximo es 250; los valores superiores a 250 se convertirán a 250. Si no se especifica, se devolverá la cantidad máxima de promociones.
pageToken

string

Solo salida. Un token de página, recibido desde una llamada promotions.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a promotions.list deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para el método promotions.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Campos
promotions[]

object (Promotion)

Son las promociones procesadas de la cuenta especificada.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.