Method: accounts.promotions.list

Wyświetla promocje na koncie Merchant Center. Odpowiedź może zawierać mniej elementów niż określono w parametry pageSize. Aby sprawdzić, czy są jeszcze inne elementy, o które możesz poprosić, użyj funkcji pageToken.

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

Żą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, na którym mają być wyświetlane przetworzone promocje. 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 250; wartości powyżej 250 zostaną skonwertowane na 250. Jeśli nie podasz tej wartości, zwrócona zostanie maksymalna liczba promocji.
pageToken

string

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

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji promotions.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

wiadomość z 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 być wysył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 OAuth 2.0 Overview.