get
Возвращает справочные данные: регионы, часовые пояса, курсы валют, список станций метрополитена, ограничения на значения параметров, внешние сети (SSP), сегменты Крипты для нацеливания по профилю пользователя и др.
Запрос
Структура запроса в формате JSON:
{
"method": "get",
"params": { /* params */
"DictionaryNames": [( "Currencies"
| "MetroStations"
| "GeoRegions"
| "GeoRegionNames"
| "TimeZones"
| "Constants"
| "AdCategories"
| "OperationSystemVersions"
| "ProductivityAssertions"
| "SupplySidePlatforms"
| "Interests"
| "AudienceCriteriaTypes"
| "AudienceDemographicProfiles"
| "AudienceInterests"
| "FilterSchemas"), ... ] /* required */
}
}
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / GetRequest (для SOAP) | |||
---|---|---|---|
DictionaryNames | array of DictionaryNameEnum | Имена справочников, которые требуется получить. | Да |
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / GetRequest (для SOAP) | |||
---|---|---|---|
DictionaryNames | array of DictionaryNameEnum | Имена справочников, которые требуется получить. | Да |
Ответ
Структура ответа в формате JSON:
{
"result": {
"Currencies": [{ /* CurrenciesItem */
"Currency": (string), /* required */
"Properties": [{ /* ConstantsItem */
"Name": (string), /* required */
"Value": (string) /* required */
}, ... ] /* required */
}, ... ],
"MetroStations": [{ /* MetroStationsItem */
"GeoRegionId": (long), /* required */
"MetroStationId": (long), /* required */
"MetroStationName": (string) /* required */
}, ... ],
"GeoRegions": [{ /* GeoRegionsItem */
"GeoRegionId": (long), /* required */
"GeoRegionName": (string), /* required */
"GeoRegionType": (string), /* required */
"ParentId": (long) /* nillable */
}, ... ],
"GeoRegionNames": [{ /* GeoRegionNamesItem */
"GeoRegionId": (long), /* required */
"GeoRegionName": (string), /* required */
"GeoRegionType": (string), /* required */
}, ... ],
"TimeZones": [{ /* TimeZonesItem */
"TimeZone": (string), /* required */
"TimeZoneName": (string), /* required */
"UtcOffset": (int) /* required */
}, ... ],
"Constants": [{ /* ConstantsItem */
"Name": (string), /* required */
"Value": (string) /* required */
}, ... ],
"AdCategories": [{ /* AdCategoriesItem */
"AdCategory": (string), /* required */
"Description": (string), /* required */
"Message": (string) /* required */
}, ... ],
"OperationSystemVersions": [{ /* OperationSystemVersionsItem */
"OsName": (string), /* required */
"OsVersion": (string) /* required */
}, ... ],
"SupplySidePlatforms": [{ /* SupplySidePlatformsItem */
"Title": (string) /* required */
}, ... ],
"Interests": [{ /* InterestsItem */
"InterestId": (long),
"ParentId": (long), /* nillable */
"Name": (string),
"IsTargetable": ( "YES" | "NO" )
}, ... ],
"AudienceCriteriaTypes": [{ /* AudienceCriteriaTypesItem */
"Type": (string), /* required */
"BlockElement": (string), /* required */
"Name": (string), /* required */
"Description": (string), /* required */
"CanSelect": ( "ALL" | "EXCEPT_ALL" ) /* required */
}, ... ],
"AudienceDemographicProfiles": [{ /* AudienceDemographicProfilesItem */
"Id": (long), /* required */
"Type": (string), /* required */
"Name": (string), /* required */
"Description": (string) /* required */
}, ... ],
"AudienceInterests": [{ /* AudienceInterestsItem */
"InterestKey": (long), /* required */
"Id": (long), /* required */
"ParentId": (long), /* required */
"Name": (string), /* required */
"Description": (string), /* required */
"InterestType": ( "SHORT_TERM" | "LONG_TERM" | "ANY" ) /* required */
}, ... ],
"FilterSchemas": [{ /* FilterSchemasItem */
"Name": (string), /* required */
"Fields": [{ /* required */
"Name": (string), /* required */
"Type": ("Enum", "Number", "String"), /* required */
"EnumProps": {
"Values": { /* required */
"Items": [(string)] /* required */
},
},
"NumberProps": {
"Min": (decimal), /* required */
"Max": (decimal), /* required */
"Precision": (integer) /* required */
},
"StringProps": {
"MaxLength": (integer), /* required */
"MinLength": (integer) /* required */
},
"Operators": [{ /* required */
"MaxItems": (integer), /* required */
"Type": ("CONTAINS_ANY" | "EQUALS_ANY" | "EXISTS" | "GREATER_THAN" | "IN_RANGE" | "LESS_THAN" | "NOT_CONTAINS_ALL") /* required */
}, ...]
}, ... ]
}
}
Параметр | Тип | Описание |
Структура result (для JSON) / GetResponse (для SOAP) | ||
---|---|---|
AdCategories | array of AdCategoriesItem | Особые категории рекламируемых товаров и услуг. См. раздел Особая категория. |
Constants | array of ConstantsItem | Ограничения на значения параметров. |
Currencies | array of CurrenciesItem | Курсы валют, валютные параметры и ограничения. |
GeoRegions | array of GeoRegionsItem | Регионы, доступные для таргетинга. |
GeoRegionNames | array of GeoRegionNamesItem | Справочник названий регионов. |
MetroStations | array of MetroStationsItem | Станции метрополитена (только для Москвы, Санкт-Петербурга и Киева). |
OperationSystemVersions | array of OperationSystemVersionsItem | Версии операционных систем для рекламы мобильных приложений. |
ProductivityAssertions | array of ProductivityAssertionsItem | Параметр утратил актуальность и не возвращается. |
TimeZones | array of TimeZonesItem | Часовые пояса. |
SupplySidePlatforms | array of SupplySidePlatformsItem | Внешние сети (SSP). |
Interests | array of InterestsItem | Интересы к категориям мобильных приложений. |
AudienceCriteriaTypes | array of AudienceCriteriaTypesItem | Социально-демографические характеристики и поведенческие признаки. |
AudienceDemographicProfiles | array of AudienceDemographicProfilesItem | Сегменты по социально-демографическим характеристикам и поведенческим признакам для таргетинга по профилю пользователя. |
AudienceInterests | array of AudienceInterestsItem | Сегменты по интересам пользователя для таргетинга по профилю пользователя. |
FilterSchemas | array of FilterSchemasItem | Названия схем для создания фильтров. |
Структура AdCategoriesItem | ||
AdCategory | string | Обозначение особой категории (параметр объявления AdCategories). |
Description | string | Краткое описание особой категории на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Message | string | Текст предупреждения, автоматически добавляемого в объявление, на языке, указанном в запросе в HTTP-заголовке Accept-Language (см. раздел Предупреждения и возрастные ограничения в объявлениях помощи Директа). |
Структура ConstantsItem (для ограничений на значения параметров) | ||
Name | string | Наименование ограничения:
|
Value | string | Значение ограничения. |
Структура CurrenciesItem | ||
Currency | string | Обозначение валюты (параметр кампании Currency). |
Properties | array of ConstantsItem | Наименование и значение валютного параметра. |
Структура ConstantsItem (для валютных параметров) | ||
Name | string | Наименование валютного параметра:
См. примеры ниже. |
Value | string | Значение валютного параметра. Внимание. Все возвращаемые денежные значения представляют собой целые числа — результат умножения ставки или цены на 1 000 000. |
Структура GeoRegionsItem | ||
GeoRegionId | long | Идентификатор региона. |
GeoRegionName | string | Название региона на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
GeoRegionType | string | Тип региона: World, Continent, Region, Country, Administrative area, District, City, City district, Village. |
ParentId | long, nillable | Идентификатор вышестоящего региона. |
Структура GeoRegionNamesItem | ||
GeoRegionId | long | Идентификатор региона. |
GeoRegionName | string | Название региона на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
GeoRegionType | string | Тип региона: World, Continent, Region, Country, Administrative area, District, City, City district, Village. |
Структура MetroStationsItem | ||
GeoRegionId | long | Идентификатор региона. |
MetroStationId | long | Идентификатор станции метрополитена (параметр виртуальной визитки MetroStationId). |
MetroStationName | string | Название станции (на русском языке). |
Структура OperationSystemVersionsItem | ||
OsName | string | Название операционной системы. |
OsVersion | string | Версия операционной системы. |
Структура TimeZonesItem | ||
TimeZone | string | Обозначение часового пояса (параметр кампании TimeZone). |
TimeZoneName | string | Описание часового пояса на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
UtcOffset | int | Смещение от UTC в секундах. |
Структура SupplySidePlatformsItem | ||
Title | string | Наименование внешней сети. |
Структура InterestsItem | ||
InterestId | long | Идентификатор интереса к категории мобильных приложений. |
ParentId | long, nillable | Идентификатор вышестоящего интереса. |
Name | string | Название интереса на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
IsTargetable | YesNoEnum | Признак того, что идентификатор интереса можно указывать в условии нацеливания на аудиторию. |
Структура AudienceCriteriaTypesItem | ||
Type | string | Идентификатор социально-демографической характеристики или поведенческого признака. |
BlockElement | string | Группа характеристик, к которой относится характеристика:
|
Name | string | Название характеристики или признака на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание характеристики или признака на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
CanSelect | CanSelectEnum | Допустимо ли указать в правиле отбора пользователей все сегменты по данной характеристике или признаку (например, указать все возрастные группы нельзя, а все профессии можно). |
Структура AudienceDemographicProfilesItem | ||
Id | long | Идентификатор сегмента по социально-демографической характеристике или поведенческому признаку. |
Type | string | Идентификатор социально-демографической характеристики или поведенческого признака (параметр Type структуры AudienceCriteriaTypes). |
Name | string | Название сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Структура AudienceInterestsItem | ||
InterestKey | long | Идентификатор интереса пользователя. |
Id | long | Идентификатор сегмента по интересам пользователя. Идентификатор сегмента состоит из префикса, обозначающего тип интереса, и идентификатора интереса. Например, InterestKey равен 2499001182 (авиабилеты), а Id равен 102499001182 (краткосрочный интерес к авиабилетам). |
ParentId | long | Идентификатор вышестоящего сегмента. |
Name | string | Название сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language |
InterestType | InterestTypeEnum | Тип интереса: краткосрочный, долгосрочный или за любой период. |
Структура FilterSchemasItem | ||
Name | string | Название схемы для создания фильтров. |
Fields | array of FilterSchemaItemFields | Параметры схемы. |
Структура FilterSchemasItemFields (для параметров схемы создания фильтров) | ||
Name | string | Название параметра. |
Type | FieldTypeEnum | Тип параметра: Enum, Number, String. |
EnumProps | EnumFieldStructure | Структура параметра типа Enum. |
NumberProps | NumberFieldStructure | Структура параметра типа Number. |
StringProps | StringFieldStructure | Структура параметра типа String. |
Operators | array of OperatorStructure | Операторы. |
Структура EnumFieldStructure (для структуры параметра типа Enum) | ||
Values | EnumFieldStructureItem | Структура значений параметра типа Enum. |
Структура EnumFieldStructureItem (для значений параметра типа Enum) | ||
Items | array of strings | Массив значений. |
Структура NumberFieldStructure (для структуры параметра типа Number) | ||
Min | decimal | Минимальное значение. |
Max | decimal | Максимальное значение. |
Precision | integer | Точность. |
Структура StringFieldStructure (для структуры параметра типа String) | ||
MaxLength | integer | Максимальная длина возвращаемой строки. |
MinLength | integer | Минимальная длина возвращаемой строки. |
Структура OperatorStructure (для структуры оператора) | ||
MaxItems | integer | Максимальное число элементов. |
Type | OperatorEnum | Оператор: CONTAINS_ANY, EQUALS_ANY, EXISTS, GREATER_THAN, IN_RANGE, LESS_THAN, NOT_CONTAINS_ALL. |
Параметр | Тип | Описание |
Структура result (для JSON) / GetResponse (для SOAP) | ||
---|---|---|
AdCategories | array of AdCategoriesItem | Особые категории рекламируемых товаров и услуг. См. раздел Особая категория. |
Constants | array of ConstantsItem | Ограничения на значения параметров. |
Currencies | array of CurrenciesItem | Курсы валют, валютные параметры и ограничения. |
GeoRegions | array of GeoRegionsItem | Регионы, доступные для таргетинга. |
GeoRegionNames | array of GeoRegionNamesItem | Справочник названий регионов. |
MetroStations | array of MetroStationsItem | Станции метрополитена (только для Москвы, Санкт-Петербурга и Киева). |
OperationSystemVersions | array of OperationSystemVersionsItem | Версии операционных систем для рекламы мобильных приложений. |
ProductivityAssertions | array of ProductivityAssertionsItem | Параметр утратил актуальность и не возвращается. |
TimeZones | array of TimeZonesItem | Часовые пояса. |
SupplySidePlatforms | array of SupplySidePlatformsItem | Внешние сети (SSP). |
Interests | array of InterestsItem | Интересы к категориям мобильных приложений. |
AudienceCriteriaTypes | array of AudienceCriteriaTypesItem | Социально-демографические характеристики и поведенческие признаки. |
AudienceDemographicProfiles | array of AudienceDemographicProfilesItem | Сегменты по социально-демографическим характеристикам и поведенческим признакам для таргетинга по профилю пользователя. |
AudienceInterests | array of AudienceInterestsItem | Сегменты по интересам пользователя для таргетинга по профилю пользователя. |
FilterSchemas | array of FilterSchemasItem | Названия схем для создания фильтров. |
Структура AdCategoriesItem | ||
AdCategory | string | Обозначение особой категории (параметр объявления AdCategories). |
Description | string | Краткое описание особой категории на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Message | string | Текст предупреждения, автоматически добавляемого в объявление, на языке, указанном в запросе в HTTP-заголовке Accept-Language (см. раздел Предупреждения и возрастные ограничения в объявлениях помощи Директа). |
Структура ConstantsItem (для ограничений на значения параметров) | ||
Name | string | Наименование ограничения:
|
Value | string | Значение ограничения. |
Структура CurrenciesItem | ||
Currency | string | Обозначение валюты (параметр кампании Currency). |
Properties | array of ConstantsItem | Наименование и значение валютного параметра. |
Структура ConstantsItem (для валютных параметров) | ||
Name | string | Наименование валютного параметра:
См. примеры ниже. |
Value | string | Значение валютного параметра. Внимание. Все возвращаемые денежные значения представляют собой целые числа — результат умножения ставки или цены на 1 000 000. |
Структура GeoRegionsItem | ||
GeoRegionId | long | Идентификатор региона. |
GeoRegionName | string | Название региона на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
GeoRegionType | string | Тип региона: World, Continent, Region, Country, Administrative area, District, City, City district, Village. |
ParentId | long, nillable | Идентификатор вышестоящего региона. |
Структура GeoRegionNamesItem | ||
GeoRegionId | long | Идентификатор региона. |
GeoRegionName | string | Название региона на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
GeoRegionType | string | Тип региона: World, Continent, Region, Country, Administrative area, District, City, City district, Village. |
Структура MetroStationsItem | ||
GeoRegionId | long | Идентификатор региона. |
MetroStationId | long | Идентификатор станции метрополитена (параметр виртуальной визитки MetroStationId). |
MetroStationName | string | Название станции (на русском языке). |
Структура OperationSystemVersionsItem | ||
OsName | string | Название операционной системы. |
OsVersion | string | Версия операционной системы. |
Структура TimeZonesItem | ||
TimeZone | string | Обозначение часового пояса (параметр кампании TimeZone). |
TimeZoneName | string | Описание часового пояса на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
UtcOffset | int | Смещение от UTC в секундах. |
Структура SupplySidePlatformsItem | ||
Title | string | Наименование внешней сети. |
Структура InterestsItem | ||
InterestId | long | Идентификатор интереса к категории мобильных приложений. |
ParentId | long, nillable | Идентификатор вышестоящего интереса. |
Name | string | Название интереса на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
IsTargetable | YesNoEnum | Признак того, что идентификатор интереса можно указывать в условии нацеливания на аудиторию. |
Структура AudienceCriteriaTypesItem | ||
Type | string | Идентификатор социально-демографической характеристики или поведенческого признака. |
BlockElement | string | Группа характеристик, к которой относится характеристика:
|
Name | string | Название характеристики или признака на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание характеристики или признака на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
CanSelect | CanSelectEnum | Допустимо ли указать в правиле отбора пользователей все сегменты по данной характеристике или признаку (например, указать все возрастные группы нельзя, а все профессии можно). |
Структура AudienceDemographicProfilesItem | ||
Id | long | Идентификатор сегмента по социально-демографической характеристике или поведенческому признаку. |
Type | string | Идентификатор социально-демографической характеристики или поведенческого признака (параметр Type структуры AudienceCriteriaTypes). |
Name | string | Название сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Структура AudienceInterestsItem | ||
InterestKey | long | Идентификатор интереса пользователя. |
Id | long | Идентификатор сегмента по интересам пользователя. Идентификатор сегмента состоит из префикса, обозначающего тип интереса, и идентификатора интереса. Например, InterestKey равен 2499001182 (авиабилеты), а Id равен 102499001182 (краткосрочный интерес к авиабилетам). |
ParentId | long | Идентификатор вышестоящего сегмента. |
Name | string | Название сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language. |
Description | string | Описание сегмента на языке, указанном в запросе в HTTP-заголовке Accept-Language |
InterestType | InterestTypeEnum | Тип интереса: краткосрочный, долгосрочный или за любой период. |
Структура FilterSchemasItem | ||
Name | string | Название схемы для создания фильтров. |
Fields | array of FilterSchemaItemFields | Параметры схемы. |
Структура FilterSchemasItemFields (для параметров схемы создания фильтров) | ||
Name | string | Название параметра. |
Type | FieldTypeEnum | Тип параметра: Enum, Number, String. |
EnumProps | EnumFieldStructure | Структура параметра типа Enum. |
NumberProps | NumberFieldStructure | Структура параметра типа Number. |
StringProps | StringFieldStructure | Структура параметра типа String. |
Operators | array of OperatorStructure | Операторы. |
Структура EnumFieldStructure (для структуры параметра типа Enum) | ||
Values | EnumFieldStructureItem | Структура значений параметра типа Enum. |
Структура EnumFieldStructureItem (для значений параметра типа Enum) | ||
Items | array of strings | Массив значений. |
Структура NumberFieldStructure (для структуры параметра типа Number) | ||
Min | decimal | Минимальное значение. |
Max | decimal | Максимальное значение. |
Precision | integer | Точность. |
Структура StringFieldStructure (для структуры параметра типа String) | ||
MaxLength | integer | Максимальная длина возвращаемой строки. |
MinLength | integer | Минимальная длина возвращаемой строки. |
Структура OperatorStructure (для структуры оператора) | ||
MaxItems | integer | Максимальное число элементов. |
Type | OperatorEnum | Оператор: CONTAINS_ANY, EQUALS_ANY, EXISTS, GREATER_THAN, IN_RANGE, LESS_THAN, NOT_CONTAINS_ALL. |
Примеры
- Пример запроса: получение справочника валют
-
{ "method": "get", "params": { "DictionaryNames": [ "Currencies" ] } }
- Пример ответа
-
{ "result": { "Currencies": [ { "Currency":"RUB", "Properties": [ { "Name": "FullName", "Value": "российские рубли" }, { "Name": "AutobudgetAvgCpaWarning", "Value": "XXXX" }, { "Name": "BidIncrement", "Value": "100000" }, { "Name": "MaxAutobudget", "Value": "XXXX" }, { "Name": "MaximumBid", "Value": "25000000000" }, { "Name": "MaximumCPM", "Value": "3000000000" }, { "Name": "MaxDailyBudgetForPeriod", "Value": "XXXX" }, { "Name": "MaximumPayForConversionCPA", "Value": "5000000000" }, { "Name": "MinimumAverageCPA", "Value": "900000" }, { "Name": "MinimumAverageCPC", "Value": "900000" }, { "Name": "MinimumBid", "Value": "300000" }, { "Name": "MinCpcCpaPerformance", "Value": "XXXX" }, { "Name": "MinimumCPM", "Value": "5000000" }, { "Name": "MinimumDailyBudget", "Value": "300000000" }, { "Name": "MinDailyBudgetForPeriod", "Value": "XXXX" }, { "Name": "MinimumPayment", "Value": "300000000" }, { "Name": "MinimumPayForConversionCPA", "Value": "900000" }, { "Name": "MinimumTransferAmount", "Value": "1000000000" }, { "Name": "MinimumWeeklySpendLimit", "Value": "300000000" } ] }, ... { "Currency": "EUR", "Properties": [ { "Name": "FullName", "Value": "евро" }, { "Name": "AutobudgetAvgCpaWarning", "Value": "XXXX" }, { "Name": "BidIncrement", "Value": "10000" }, { "Name": "MaxAutobudget", "Value": "XXXX" }, { "Name": "MaximumBid", "Value": "500000000" }, { "Name": "MaximumCPM", "Value": "44000000" }, { "Name": "MaxDailyBudgetForPeriod", "Value": "XXXX" }, { "Name": "MaximumPayForConversionCPA", "Value": "170000000" }, { "Name": "MinimumAverageCPA", "Value": "30000" }, { "Name": "MinimumAverageCPC", "Value": "30000" }, { "Name": "MinimumBid", "Value": "10000" }, { "Name": "MinCpcCpaPerformance", "Value": "XXXX" }, { "Name": "MinimumCPM", "Value": "70000" }, { "Name": "MinimumDailyBudget", "Value": "10000000" }, { "Name": "MinDailyBudgetForPeriod", "Value": "XXXX" }, { "Name": "MinimumPayment", "Value": "15000000" }, { "Name": "MinimumPayForConversionCPA", "Value": "30000" }, { "Name": "MinimumTransferAmount", "Value": "15000000" }, { "Name": "MinimumWeeklySpendLimit", "Value": "10000000" } ] } ] } }