2019-12-28 22:25:09 +09:00
|
|
|
from typing import TYPE_CHECKING, Optional, Union
|
2019-12-27 18:14:51 +09:00
|
|
|
|
2020-01-26 21:19:22 +09:00
|
|
|
from yandex_music import YandexMusicObject
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
if TYPE_CHECKING:
|
|
|
|
from yandex_music import Client
|
|
|
|
|
New supported objects: Station, StationResult, StationTrackResult, Value, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, DashBoard, AdParams
The following methods are wrapped:
- /rotor/account/status
- /rotor/stations/dashboard
- /rotor/stations/list
- /rotor/station/genre:{genre}/feedback
- /rotor/station/genre:{genre}/info
- /rotor/station/genre:{genre}/tracks
The following fields are now optional: Account[region, passport_phones], Status[cache_limit, subeditor, subeditor_level, plus], Subscription[auto_renewable, can_start_trial, mcdonalds]
Added new fields: Subscription.end, Status[skips_per_hour, station_exists, premium_region], Track..preview_duration_ms
Fixed downloading the cover of the track
2019-06-03 22:16:24 +09:00
|
|
|
|
|
|
|
class AdParams(YandexMusicObject):
|
2020-02-01 20:52:14 +09:00
|
|
|
"""Класс, представляющий параметры рекламного объявления.
|
|
|
|
|
|
|
|
Note:
|
|
|
|
Известные дополнительные параметры(`other_params`): `user:{ID}`.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
|
|
Attributes:
|
2020-02-01 20:52:14 +09:00
|
|
|
partner_id (:obj:`str` | :obj:`int`): Уникальный идентификатор заказчика рекламы.
|
|
|
|
category_id (:obj:`str` | :obj:`int`): Уникальный идентификатор категории рекламы.
|
|
|
|
page_ref (:obj:`str`): Ссылка на ссылающуюся страницу.
|
|
|
|
target_ref (:obj:`str`): Ссылка на целевую страницу.
|
|
|
|
other_params (:obj:`str`): Другие параметры.
|
|
|
|
ad_volume (:obj:`int`): Громкость воспроизводимой рекламы.
|
|
|
|
genre_id (:obj:`str`): Уникальный идентификатор жанра.
|
|
|
|
genre_name (:obj:`str`): Название жанра.
|
2020-03-22 08:04:39 +09:00
|
|
|
client (:obj:`yandex_music.Client`): Клиент Yandex Music.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
|
|
Args:
|
2020-02-01 20:52:14 +09:00
|
|
|
partner_id (:obj:`str` | :obj:`int`): Уникальный идентификатор заказчика рекламы.
|
|
|
|
category_id (:obj:`str` | :obj:`int`): Уникальный идентификатор категории рекламы.
|
|
|
|
page_ref (:obj:`str`): Ссылка на ссылающуюся страницу.
|
|
|
|
target_ref (:obj:`str`): Ссылка на целевую страницу.
|
|
|
|
other_params (:obj:`str`): Другие параметры.
|
|
|
|
ad_volume (:obj:`int`): Громкость воспроизводимой рекламы.
|
|
|
|
genre_id (:obj:`str`, optional): Уникальный идентификатор жанра.
|
|
|
|
genre_name (:obj:`str`, optional): Название жанра.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
client (:obj:`yandex_music.Client`, optional): Клиент Yandex Music.
|
2020-01-26 23:50:54 +09:00
|
|
|
**kwargs: Произвольные ключевые аргументы полученные от API.
|
|
|
|
"""
|
|
|
|
|
New supported objects: Station, StationResult, StationTrackResult, Value, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, DashBoard, AdParams
The following methods are wrapped:
- /rotor/account/status
- /rotor/stations/dashboard
- /rotor/stations/list
- /rotor/station/genre:{genre}/feedback
- /rotor/station/genre:{genre}/info
- /rotor/station/genre:{genre}/tracks
The following fields are now optional: Account[region, passport_phones], Status[cache_limit, subeditor, subeditor_level, plus], Subscription[auto_renewable, can_start_trial, mcdonalds]
Added new fields: Subscription.end, Status[skips_per_hour, station_exists, premium_region], Track..preview_duration_ms
Fixed downloading the cover of the track
2019-06-03 22:16:24 +09:00
|
|
|
def __init__(self,
|
2019-12-28 22:25:09 +09:00
|
|
|
partner_id: Union[str, int],
|
|
|
|
category_id: Union[str, int],
|
|
|
|
page_ref: str,
|
|
|
|
target_ref: str,
|
|
|
|
other_params: str,
|
|
|
|
ad_volume: int,
|
2020-02-01 20:52:14 +09:00
|
|
|
genre_id: Optional[str] = None,
|
|
|
|
genre_name: Optional[str] = None,
|
2019-12-27 18:14:51 +09:00
|
|
|
client: Optional['Client'] = None,
|
|
|
|
**kwargs) -> None:
|
New supported objects: Station, StationResult, StationTrackResult, Value, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, DashBoard, AdParams
The following methods are wrapped:
- /rotor/account/status
- /rotor/stations/dashboard
- /rotor/stations/list
- /rotor/station/genre:{genre}/feedback
- /rotor/station/genre:{genre}/info
- /rotor/station/genre:{genre}/tracks
The following fields are now optional: Account[region, passport_phones], Status[cache_limit, subeditor, subeditor_level, plus], Subscription[auto_renewable, can_start_trial, mcdonalds]
Added new fields: Subscription.end, Status[skips_per_hour, station_exists, premium_region], Track..preview_duration_ms
Fixed downloading the cover of the track
2019-06-03 22:16:24 +09:00
|
|
|
self.partner_id = partner_id
|
|
|
|
self.category_id = category_id
|
|
|
|
self.page_ref = page_ref
|
|
|
|
self.target_ref = target_ref
|
|
|
|
self.other_params = other_params
|
|
|
|
self.ad_volume = ad_volume
|
|
|
|
|
|
|
|
self.genre_id = genre_id
|
|
|
|
self.genre_name = genre_name
|
|
|
|
|
|
|
|
self.client = client
|
2019-11-08 06:37:53 +09:00
|
|
|
self._id_attrs = (self.partner_id, self.category_id, self.page_ref,
|
|
|
|
self.target_ref, self.other_params, self.ad_volume)
|
New supported objects: Station, StationResult, StationTrackResult, Value, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, DashBoard, AdParams
The following methods are wrapped:
- /rotor/account/status
- /rotor/stations/dashboard
- /rotor/stations/list
- /rotor/station/genre:{genre}/feedback
- /rotor/station/genre:{genre}/info
- /rotor/station/genre:{genre}/tracks
The following fields are now optional: Account[region, passport_phones], Status[cache_limit, subeditor, subeditor_level, plus], Subscription[auto_renewable, can_start_trial, mcdonalds]
Added new fields: Subscription.end, Status[skips_per_hour, station_exists, premium_region], Track..preview_duration_ms
Fixed downloading the cover of the track
2019-06-03 22:16:24 +09:00
|
|
|
|
|
|
|
@classmethod
|
Добавлены тайп хинты для Suggestions, SearchResult, Search, Best, Value, StationResult, Station, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, Dashboard, AdParams
2019-12-27 22:06:24 +09:00
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['AdParams']:
|
2020-01-26 22:17:09 +09:00
|
|
|
"""Десериализация объекта.
|
|
|
|
|
|
|
|
Args:
|
|
|
|
data (:obj:`dict`): Поля и значения десериализуемого объекта.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
client (:obj:`yandex_music.Client`, optional): Клиент Yandex Music.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
|
|
|
Returns:
|
2020-03-22 06:29:34 +09:00
|
|
|
:obj:`yandex_music.AdParams`: Параметры рекламного объявления.
|
2020-01-26 22:17:09 +09:00
|
|
|
"""
|
New supported objects: Station, StationResult, StationTrackResult, Value, Sequence, RotorSettings, Restrictions, Id, Enum, DiscreteScale, DashBoard, AdParams
The following methods are wrapped:
- /rotor/account/status
- /rotor/stations/dashboard
- /rotor/stations/list
- /rotor/station/genre:{genre}/feedback
- /rotor/station/genre:{genre}/info
- /rotor/station/genre:{genre}/tracks
The following fields are now optional: Account[region, passport_phones], Status[cache_limit, subeditor, subeditor_level, plus], Subscription[auto_renewable, can_start_trial, mcdonalds]
Added new fields: Subscription.end, Status[skips_per_hour, station_exists, premium_region], Track..preview_duration_ms
Fixed downloading the cover of the track
2019-06-03 22:16:24 +09:00
|
|
|
if not data:
|
|
|
|
return None
|
|
|
|
|
|
|
|
data = super(AdParams, cls).de_json(data, client)
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|