VK ORD API News
الذهاب إلى القناة على Telegram
Здесь публикуются изменения в API ВК ОРД. Актуальная документация всегда (ок, почти всегда) в https://ord.vk.com/help/api и https://ord.vk.com/help/api/swagger/. Поддержка по почте support@ord.vk.com.
إظهار المزيد215
المشتركون
لا توجد بيانات24 ساعات
لا توجد بيانات7 أيام
لا توجد بيانات30 أيام
جاري تحميل البيانات...
القنوات المماثلة
لا توجد بيانات
هل تواجه مشاكل؟ يرجى تحديث الصفحة أو الاتصال بمدير الدعم الخاص بنا.
سحابة العلامات
لا توجد بيانات
هل تواجه مشاكل؟ يرجى تحديث الصفحة أو الاتصال بمدير الدعم الخاص بنا.
الإشارات الواردة والصادرة
---
---
---
---
---
---
جذب المشتركين
ديسمبر '24
ديسمبر '24
+26
في 0 قنوات
نوفمبر '24
+79
في 0 قنوات
Get PRO
أكتوبر '24
+34
في 0 قنوات
Get PRO
سبتمبر '24
+278
في 0 قنوات
Get PRO
أغسطس '240
في 0 قنوات
Get PRO
يوليو '240
في 0 قنوات
Get PRO
يونيو '240
في 0 قنوات
Get PRO
مايو '240
في 1 قنوات
Get PRO
أبريل '240
في 0 قنوات
Get PRO
مارس '240
في 0 قنوات
Get PRO
فبراير '240
في 0 قنوات
Get PRO
يناير '24
+8
في 0 قنوات
Get PRO
ديسمبر '23
+208
في 0 قنوات
| التاريخ | نمو المشتركين | الإشارات | القنوات | |
| 21 ديسمبر | 0 | |||
| 20 ديسمبر | 0 | |||
| 19 ديسمبر | 0 | |||
| 18 ديسمبر | +1 | |||
| 17 ديسمبر | +3 | |||
| 16 ديسمبر | +3 | |||
| 15 ديسمبر | +1 | |||
| 14 ديسمبر | 0 | |||
| 13 ديسمبر | +1 | |||
| 12 ديسمبر | +2 | |||
| 11 ديسمبر | +1 | |||
| 10 ديسمبر | +4 | |||
| 09 ديسمبر | 0 | |||
| 08 ديسمبر | 0 | |||
| 07 ديسمبر | +3 | |||
| 06 ديسمبر | +1 | |||
| 05 ديسمبر | +1 | |||
| 04 ديسمبر | +3 | |||
| 03 ديسمبر | +2 | |||
| 02 ديسمبر | 0 | |||
| 01 ديسمبر | 0 |
منشورات القناة
Добрый вечер!
Мы открыли-таки API свободных статистик. Но о нем надо знать кое-что важное.
По своей структуре оно несколько отличается от других методов: у объекта статистики нет внешнего идентификатора
external_id, и каждый объект адресуется тройкой из внешнего id креатива, внешнего id площадки и месяца, за который подается статистика. Это связано с тем, что такой уникальный ключ статистики используется в ЕРИРе, и нам пришлось бы тщательно следить за тем, чтобы по разным external_id не принесли, по сути, одну и ту же статистику, а следить за этим было бы довольно сложно, да и не хотелось.
Раз нет внешнего идентификатора, то по-другому выглядит и все API:
* вместо привычного PUT с external_id в пути - безликий POST метод /v1/statistics, все данные которого находятся в теле запроса.
* есть удаление, но тоже через POST - /v1/statistics/delete.
* есть листинг сразу объектов целиком, GET-метод /v1/statistics/list, в котором перечисляются параметры искомой статистики. В отличии от листинг-методов других типов сущностей этот отдает найденные сущности целиком, а не их айдишки, поэтому и путь его устроен по-другому.
Также API сразу рассчитано на массивы передаваемых данных, т.е. одним запросом можно передать сразу несколько статистик, как было и есть в актах.
У каждой статистики есть свой отдельный статус отправки в ЕРИР, и чтобы его получить - пока придется использовать фейковый external_id, чтобы запрос вида /v1/statistics/external_id/erir_status работал как обычно. Где же взять этот фейковый external_id? Есть три способа:
1. В ответ на POST запрос по добавлению/изменению данных /v1/statistics.
2. В методе /v1/statistics/list среди других полей объекта.
3. Составить самостоятельно по формуле creative_external_id + __ + pad_external_id + __ + YYYY-MM-01.
Ну и что еще очень важно понимать: пока нет никакой возможности прицепить заведенные таким образом статистики к акту. Их назначение - использовать их в отрыве от актов там, где акты в принципе не нужны. Например, для саморекламы.
Описание в Swagger: https://ord.vk.com/help/api/swagger/#/statistics
Описание в доке: https://ord.vk.com/help/api/ref/statistics.html
Особенности API: https://ord.vk.com/help/api/peculiarity/statistics.html| 2 | Читать документацию API можно не только через наш Swagger UI, но и через альтернативные внешние просмотрщики, например, через красивый Redoc.
Работа внешних просмотрщиков не гарантируется. | 181 |
| 3 | Здравствуйте.
Чуть улучшили API запроса за статусами объектов: помимо GET-запроса /v1/erir_statuses, в который можно передать набор external_id, сделали POST-запрос, в который можно передать все то же самое, но в формате JSON и в большем количестве.
https://ord.vk.com/help/api/swagger/#/erir_status/v1-post-ad-object-processing-status | 307 |
| 4 | Здравствуйте.
Открыли API для получения списков объектов. API такие:
* /v1/person
* /v1/contract
* /v1/pad
* /v1/creative
Отдается список external_id и общее число элементов в БД. Поддерживают параметры limit и offset. Порядок сортировки объектов считается неопределенным (но скоро это будет сортировка по возрастанию external_id).
Ручку для выдачи списка актов готовим. Также готовим ручку для получения данных креатива по erid и по выдаче списка зарегистрированных erid'ов. | 497 |
| 5 | Добрый вечер.
Открыли API словаря ОКВЭДов. Пример в документации. | 540 |
| 6 | Здравствуйте.
В ответы API получения креатива (GET /v1/creative/{external_id} и GET /v2/creative/{external_id}) добавили поле erid, в котором содержится маркировка креатива. Ранее маркировка отображалась только при создании креатива.
Также в ответах методов создания/редактирования креатива (PUT /v1/creative/{external_id} и PUT /v2/creative/{external_id}) продублировали поле marker с маркировкой полем erid, т.к. название erid является более общепринятым для обозначения маркировки. | 606 |
| 7 | Добрый день.
Открыли API проверки состояния объектов в ЕРИР.
Методы /v1/{data_type}/{external_id}/erir_status и /v1/erir_statuses.
Можно получать как списки объектов, выбирая по параметрам ("только креативы", "только плохие" и т.п.), так и получить статус каждого конкретного объекта.
Подробности о возможных значениях статусов и процессе их смены смотрите в документации. | 838 |
| 8 | Новости за 2 недели: 21.08-01.09
Документация
Методы Swagger-документации содержат специальные пометки:
🔘 Параметр или поле обязательно, если у его названия находится красная звезда.
🔘 Параметр или поле необязательно, если красная звезда отсутствует.
Из-за особенностей ОРД VK описания параметров или полей могут иметь текст с условиями их применения. Swagger-документация содержит примеры всех параметров и полей: с пометками обязательных и необязательных, а также с условиями в тексте описаний. Если вы хотите выполнить запрос с таким примером, запрос может быть неправильным.
Чтобы вы могли использовать правильные примеры, подготовили раздел с примерами вызовов всех методов API:
1️⃣ API контрагентов.
2️⃣ API договоров.
3️⃣ API рекламных площадок.
4️⃣ API кpеативов.
5️⃣ API медиафайлов.
6️⃣ API актов. | 779 |
| 9 | Новости за неделю: 24.07-28.07
⬆️ Версия v2 креативов
Опубликовали методы версии v2 по работе с креативами. Поддержали возможность указать несколько URL-адресов, при нажатии на которые пользователь перейдет на рекламируемые товары и услуги. Версии v1 и v2 полностью совместимы.
🗒 Пример. Вы можете создать креатив методом PUT /v2/creative/{external_id} и позже добавить к нему тексты методом POST /v1/creative/{external_id}/add_text.
Изменения в документации
1️⃣ Документация группы методов креативов (creative).
2️⃣ Документация группы методов актов (invoice). | 679 |
| 10 | Новости за неделю: 17.07-2107
Обновлена документация группы методов медиафайлов (media). | 610 |
| 11 | Новости за неделю: 10.07-14.07
📖 Добавили раздел Глоссарий, который поможет вам разобраться в теме рекламы и оператора рекламных данных. Мы будем ссылаться на этот раздел из всей документации API.
ℹ️ Опубликовали Политику конфиденциальности. Она распространяется на любое взаимодействие с ОРД VK. | 576 |
| 12 | Новости за неделю: 03.07-07.07
Ограничения суммы разаллокации по договорам
Касается методов:
🔘 Создание/редактирование акта /v1/invoice/ {external_id}.
🔘 Обновление содержимого акта /v2/invoice/{external_id}/items.
Объект items
Сумма разаллокаций по договорам может превышать значение первого параметра amount только на 0.01 * <LENGTH>, где LENGTH — количество объектов в массиве items.
Объект platforms
Сумма разаллокации по договорам, потраченная на показ креативов на площадках, может превышать значение первого параметра amount только на 0.00001 * <LENGTH>, где LENGTH — количество объектов в массиве platforms конкретного договора.
Изменения в документации
☑️ Раздел Получение доступа переписан на разделы Авторизация и Использование.
☑️ Документация группы методов контрагентов (person).
☑️ Документация группы методов договоров (contract).
☑️ Документация группы методов рекламных площадок (pad). | 498 |
| 13 | Новости за неделю: 26.06–30.06
🔵 Ограничения символов имени контрагента
Добавили ограничения ЕРИР к написанию наименований контрагентов. Ознакомиться с ограничениями можно в документации.
🔵 Ограничения на количество символов в текстах креатива (параметр texts)
Ввели понятие «общая максимальная длина всех текстов креатива», которое равняется 65 000 символов. На общую максимальную длину всех текстов креатива будут влиять как текущие запросы, так и будущие.
🗒 Пример. Вы создали креатив с текстами, которые занимают 64 900 символов. В следующий раз вы можете добавить текстов только на 100 символов. На этом этапе вы достигли общую максимальную длину всех текстов креатива и больше не сможете добавлять тексты к креативу. | 388 |
| 14 | Изменения в API и документации
Напоминаем вам, что с 15 июня 2023 года прекращен приём запросов:
📍Обновление креатива в акте /v1/invoice/{external_id}/{contract_external_id}/{creative_external_id}
📍Обновление разаллокации по контракту в акте /v1/invoice/{external_id}/{contract_external_id}
Документация этих методов удалена.
Чтобы обновить информацию о креативе и разаллокации по контракту в акте, используйте метод Обновление содержимого акта. | 358 |
| 15 | Добрый день. Добавили возможность задать больше одного урла для креатива. Появилась пара методов - PUT и GET - по пути /v2/creative/{external_id}, которые отличаются от соответствующих методов v1 только тем, что вместо поля "url": string используется поле "target_urls": [ string ] (массив урлов). Методы v1 и v2 могут использоваться совместно даже для одного и того же объекта, но если по PUT v2 завели несколько урлов для креатива, то GET v1 вернет только один из них.
Описание методов есть только в swagger (PUT, GET), позже добавим в текстовую документацию. | 350 |
| 16 | Здравствуйте. Отключим вышеуказанный deprecated API 15-го июня. | 305 |
| 17 | Здравствуйте!
Еще одна чудесная новость: в API создания креативов разбили поле description на три разных поля: brand, category и description. Соответственно, обязательное ранее поле description становится необязательным, но как минимум одно из этих полей должно быть заполнено. Каждое поле может занимать до 255 символов, но суммарная их длина не должна превышать 240 символов, если заполнено два поля, и 225 символов, если заполнено три поля.
Ссылки по теме:
1. https://ord.vk.com/help/api/swagger/#/creative/put_v1_creative__external_id_
2. https://ord.vk.com/help/api/ref/creative.html#создание-креатива | 354 |
| 18 | Добрый день.
Перевели методы PATCH /v1/invoice/...
в разряд deprecated. Ориентировочно через месяц отключим их совсем. За неделю до часа X дополнительно объявим. А пока постепенно переходите на методы
/v2/invoice/... с аналогичной функциональностью.
Эти нововведения связаны с новыми проверками при приеме актов, которые затруднительно было реализовать в старой схеме API без метода /v2/invoice/{external_id}/ready, который необходимо вызывать после правок в акте (т.е вызова методов POST и PATCH, но не PUT) и который теперь будет проводить финальные сверки и сможет возвращать ошибки, если таковые выявлены в акте.
P.S. Методы /v1/invoice/... PUT, GET, и DELETE продолжают работать как ни в чем не бывало. | 332 |
| 19 | При создании договора типа "посреднический" можно использовать новый флаг - agent_acting_for_publisher. Он означает, что деньги в акте будут указаны в обратном направлении - от исполнителя к клиенту. | 327 |
| 20 | Доброго дня. Обновили сваггер - добавили описание формата ошибок для некоторых кодов ответа. Никакой магии, это просто JSON с одним текстовым полем error. Более структурированные ошибки могут появиться в будущем. | 311 |
