Method: accounts.promotions.list

Muestra una lista de las promociones en tu cuenta de Merchant Center. La respuesta puede contener menos elementos de los que especifica 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 enumeran las promociones procesadas. Formato: accounts/{account}

Parámetros de consulta

Parámetros
pageSize

integer

Solo salida. La cantidad máxima de promociones que se mostrarán. El servicio puede mostrar menos que este valor. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000. 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.