Method: accounts.promotions.list

Wyświetla promocje 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 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ą zmienione na 250. 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 ten parametr, 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

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 wybranego 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 artykule Omówienie OAuth 2.0.