Method: accounts.promotions.list

Wyświetla listę promocji na koncie Merchant Center. Odpowiedź może zawierać mniej elementów niż określona wartość w polu pageSize. Zdaj się na firmę pageToken, aby określić, czy można zamówić więcej produktów.

Po wstawieniu lub zaktualizowaniu promocji może minąć kilka minut, zanim będzie można pobrać zaktualizowaną przetworzoną promocję.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Konto, dla którego chcesz wyświetlić listę przetworzonych promocji. Format: accounts/{account}

Parametry zapytania

Parametry
pageSize

integer

Tylko dane wyjściowe. Maksymalna liczba promocji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 1000. wartości powyżej 1000 zostaną zmienione na 1000. Jeśli nie określono inaczej, zostanie zwrócona maksymalna liczba promocji.

pageToken

string

Tylko dane wyjściowe. Token strony otrzymany z poprzedniego wywołania funkcji promotions.list. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu promotions.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat odpowiedzi dla metody promotions.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Pola
promotions[]

object (Promotion)

Przetworzone promocje z określonego konta.

nextPageToken

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.