В пакете «Стандартный» собраны правила конкретного специалиста. Откройте документы и прочитайте их до подтверждения ознакомления.
Рамка ответственности psiho-zakon.ru и материалов специалистаОткрыть и прочитать
Рамка ответственности psiho-zakon.ru и материалов специалиста
Редакция: базовая системная версия
Статус: бесплатный системный документ платформы
1. Роль платформы psiho-zakon.ru
psiho-zakon.ru является цифровой платформой и технической средой для работы специалиста: хранения документов, клиентских материалов, форм, страниц специалиста, ссылок и связанных рабочих инструментов. psiho-zakon.ru не является стороной договора об оказании психологических, консультационных, образовательных, медицинских или иных профессиональных услуг между специалистом и клиентом, если иное прямо не указано в отдельном письменном соглашении.
psiho-zakon.ru не проводит консультации вместо специалиста, не выбирает методы работы с клиентом, не оценивает профессиональную пригодность конкретного специалиста для конкретного клиента и не обещает клиенту или специалисту определённого результата: улучшения состояния, изменения поведения, решения семейной, учебной, карьерной, медицинской, юридической или иной жизненной ситуации.
2. Ответственность специалиста
Специалист самостоятельно определяет свой статус, квалификацию, формат работы, стоимость услуг, порядок записи, правила отмен и переносов, границы конфиденциальности, условия обработки персональных данных, содержание документов, публичной страницы и материалов, которые он показывает клиенту.
Специалист отвечает за то, что его документы, описания услуг, фотографии, дипломы, сертификаты, тексты, отзывы, изображения, аудио, видео и иные материалы:
- являются достоверными и актуальными;
- размещаются с законным основанием;
- не нарушают права третьих лиц;
- не раскрывают конфиденциальную информацию клиентов;
- не содержат неправомерных обещаний результата;
- соответствуют реальному формату работы специалиста.
psiho-zakon.ru может предоставлять шаблоны, подсказки, AI-инструменты и технические формы, но такие материалы являются информационной и организационной поддержкой. Они не заменяют профессиональную, юридическую, медицинскую, налоговую или иную индивидуальную консультацию. Перед использованием специалист самостоятельно проверяет и адаптирует документы под свою практику.
3. Документы специалиста и согласие клиента
Если клиент знакомится с пакетом документов специалиста на странице записи, в кабинете, по ссылке или в иной форме, он знакомится именно с документами и правилами конкретного специалиста. Подтверждение согласия означает согласие клиента с условиями взаимодействия со специалистом в той части, в которой такие условия применимы к выбранному формату работы.
psiho-zakon.ru в этом процессе выполняет техническую функцию: помогает показать документы, зафиксировать факт ознакомления, передать информацию специалисту и хранить её в рабочем пространстве. Такое подтверждение само по себе не означает, что psiho-zakon.ru становится исполнителем услуг специалиста или гарантом результата работы.
Если специалист меняет состав пакета, текст документов, публичное описание услуг или материалы страницы, ответственность за содержание и применимость таких изменений несёт специалист.
4. Публичная страница специалиста и материалы на ней
Публичная страница специалиста может содержать тексты, фотографии, сведения об образовании, подходах, опыте, стоимости, формате работы, документах и иных материалах. Даже если часть текста или структуры страницы создаётся автоматически с помощью psiho-zakon.ru или AI-инструментов, специалист обязан проверить страницу перед публикацией и несёт ответственность за её содержание.
Размещая материалы на странице, специалист подтверждает, что имеет право использовать такие материалы. Это касается, в том числе, фото, дипломов, сертификатов, логотипов, текстов, изображений, отзывов, скриншотов, методических материалов и иных объектов, которые могут охраняться авторским правом, законодательством о персональных данных, правилами конфиденциальности или иными ограничениями.
Материалы специалиста, размещённые на публичной странице или переданные клиенту через psiho-zakon.ru, не предназначены для копирования, переработки, публикации или коммерческого использования третьими лицами без согласия правообладателя. Клиент и посетитель страницы могут использовать такие материалы только для ознакомления, записи и взаимодействия со специалистом.
5. Ограничения платформы
psiho-zakon.ru не подтверждает автоматически квалификацию специалиста, достоверность всех сведений, законность каждого размещённого материала и применимость каждого документа к конкретной ситуации клиента. psiho-zakon.ru вправе ограничить доступ к материалам или странице, если есть признаки нарушения закона, прав третьих лиц, конфиденциальности, безопасности клиентов или правил платформы.
psiho-zakon.ru не несёт ответственности за решения, действия, бездействие, профессиональные выводы, рекомендации, обещания, коммуникацию, качество услуг и результаты работы специалиста с клиентом, если такие действия совершает специалист самостоятельно и вне прямых обязательств psiho-zakon.ru как платформы.
6. Важное уточнение
Этот документ является системной рамкой платформы и не является юридической консультацией. Он помогает разделить роли psiho-zakon.ru, специалиста и клиента внутри цифрового процесса. Для окончательной настройки договоров, согласий, политики персональных данных, публичной страницы и правил работы специалисту может потребоваться индивидуальная проверка у профильного юриста.
Договор с клиентомОткрыть и прочитать
ДОГОВОР
возмездного оказания психологических консультационных услуг
Шаблон для частной практики психолога в РФ
Как пользоваться шаблоном перед выдачей клиенту
• Замените все поля в квадратных скобках на свои данные.
• Выберите подходящие варианты условий и удалите лишние подсказки.
• Если вы оказываете медицинские, образовательные или иные лицензируемые услуги, адаптируйте договор под свой правовой статус.
• Для работы с несовершеннолетними используйте отдельное согласие законного представителя.
Место заключения
[город]
Дата
[дд.мм.гггг]
Исполнитель
[ФИО психолога / ИП / самозанятый], ИНН [номер]
Заказчик / Клиент
[ФИО клиента], дата рождения [при необходимости], контакт [email/телефон]
1. Стороны договора
1.1. Исполнитель: [ФИО], применяющий специальный налоговый режим «Налог на профессиональный доход» / индивидуальный предприниматель / организация, ИНН [номер], адрес для корреспонденции [адрес], email [email], телефон [телефон].
1.2. Заказчик: дееспособное физическое лицо, обратившееся за психологическими консультационными услугами для себя. Если услуги оказываются несовершеннолетнему, договор и согласия оформляются с участием законного представителя.
1.3. Стороны подтверждают, что до заключения договора Заказчику предоставлена информация об Исполнителе, формате услуг, стоимости, порядке оплаты, отмены, ограничениях психологической помощи и способах связи.
2. Предмет договора
2.1. Исполнитель оказывает Заказчику психологические консультационные услуги в формате индивидуальных консультаций / онлайн-консультаций / очных консультаций / смешанного формата.
2.2. Цель услуг — профессиональная психологическая поддержка, прояснение запроса, совместное исследование ситуации, поиск способов саморегуляции, коммуникации, принятия решений и иных психологических задач в пределах компетенции Исполнителя.
2.3. Услуги по настоящему договору не являются медицинской помощью, психиатрическим лечением, постановкой диагноза, назначением лекарственных средств, экстренной или круглосуточной помощью, если иное прямо не следует из статуса Исполнителя и отдельного договора.
2.4. Исполнитель не гарантирует конкретный жизненный, медицинский, семейный, финансовый, карьерный или иной внешний результат, поскольку результат психологической работы зависит от множества обстоятельств, включая участие Заказчика и его жизненный контекст.
3. Формат, длительность и порядок оказания услуг
3.1. Одна консультация длится [50/55/60/90] минут, если Стороны письменно не согласовали иное.
3.2. Консультации проводятся по предварительной записи. Дата, время, формат и канал связи согласуются в переписке, личном кабинете, мессенджере, email или иным способом, позволяющим подтвердить договорённость.
3.3. При онлайн-формате Заказчик самостоятельно обеспечивает тихое место, стабильный интернет, исправное устройство, конфиденциальность со своей стороны и отсутствие посторонних лиц без согласования с Исполнителем.
3.4. Аудио-, видео- и текстовая запись консультации допускается только по предварительному явному согласию обеих Сторон.
3.5. Если Заказчик опоздал, консультация завершается в ранее согласованное время, если Стороны не договорились о продлении.
3.6. Переписка между консультациями используется только для организационных вопросов, если Стороны отдельно не согласовали иной формат поддержки.
4. Стоимость, оплата и подтверждение услуг
4.1. Стоимость одной консультации составляет [сумма] рублей. Стоимость пакета / абонемента при наличии: [условия].
4.2. Оплата производится [предоплатой / после консультации / по ссылке оплаты / переводом / через платёжный сервис] не позднее [срок].
4.3. Обязанность Заказчика по оплате считается исполненной после поступления денежных средств Исполнителю или получения подтверждения платёжного сервиса.
4.4. Исполнитель формирует чек / подтверждение оплаты в порядке, применимом к его налоговому статусу.
4.5. Услуга считается оказанной после завершения консультации, если в течение [24/48] часов Заказчик не направил мотивированное письменное замечание о факте неоказания услуги.
5. Отмены, переносы и возвраты
5.1. Заказчик вправе отказаться от договора и от конкретной консультации в порядке, предусмотренном законодательством РФ и настоящим договором.
5.2. Рекомендуемый срок для отмены или переноса консультации без организационных потерь — не позднее чем за [24/48] часов до назначенного времени.
5.3. Если консультация отменена заранее, предоплата по выбору Заказчика переносится на другую дату или возвращается за вычетом фактически понесённых Исполнителем расходов, если такие расходы есть и могут быть подтверждены.
5.4. Если Заказчик не вышел на связь в согласованное время или отменил консультацию позднее установленного срока, Стороны могут согласовать перенос, частичный зачёт оплаты с учётом фактически оказанной части услуги и подтверждаемых расходов либо иной порядок с учётом обстоятельств и обязательных норм закона. Это условие не является штрафом или абсолютным невозвратом.
5.5. Если консультация не состоялась по вине Исполнителя, Исполнитель предлагает перенос на удобное время либо возвращает оплату за неоказанную услугу.
5.6. Возврат денежных средств производится тем же способом, которым была произведена оплата, либо иным согласованным способом в срок до [10] календарных дней, если иной срок не установлен законом или платёжным сервисом.
6. Права и обязанности Исполнителя
6.1. Исполнитель обязуется оказывать услуги лично / с привлечением согласованных специалистов, добросовестно, конфиденциально, в пределах своей компетенции и профессиональной этики.
6.2. Исполнитель вправе отказать в оказании услуги или рекомендовать другого специалиста, врача, кризисную службу, экстренную помощь или иной маршрут, если запрос выходит за пределы компетенции Исполнителя или требует другого вида помощи.
6.3. Исполнитель вправе переносить консультацию по уважительным причинам, своевременно уведомив Заказчика и предложив альтернативное время.
6.4. Исполнитель вправе завершить работу, если Заказчик нарушает границы взаимодействия, систематически не оплачивает услуги, приходит в состоянии выраженного опьянения, угрожает себе, Исполнителю или третьим лицам, либо использует консультации не по назначению.
7. Права и обязанности Заказчика
7.1. Заказчик самостоятельно принимает решения в своей жизни и несёт ответственность за их последствия, даже если они обсуждались в ходе консультации.
7.2. Заказчик обязуется предоставлять достоверную информацию в объёме, необходимом для работы, своевременно оплачивать услуги, соблюдать согласованные правила связи, отмен и конфиденциальности.
7.3. Заказчик вправе задавать вопросы о формате работы, квалификации Исполнителя, границах метода, стоимости, обработке персональных данных и порядке прекращения консультаций.
7.4. Заказчик вправе в любой момент отказаться от дальнейшей работы, оплатив фактически оказанные услуги и согласованные расходы в пределах, допустимых законодательством РФ.
8. Конфиденциальность
8.1. Информация, сообщённая Заказчиком в ходе консультаций, является конфиденциальной и не раскрывается третьим лицам без согласия Заказчика, за исключением случаев, предусмотренных законом или настоящим договором.
8.2. Исполнитель может обсуждать обезличенный случай на супервизии, интервизии или профессиональном разборе без указания имени, контактов, точных дат, мест, уникальных обстоятельств и иных данных, позволяющих идентифицировать Заказчика.
8.3. Конфиденциальность может быть ограничена, если есть достаточные основания полагать, что существует непосредственная угроза жизни или здоровью Заказчика, ребёнка, Исполнителя или третьих лиц, либо если раскрытие информации требуется по закону.
8.4. Заказчик обязуется не публиковать записи, переписку и материалы консультаций, содержащие персональные данные Исполнителя или третьих лиц, без согласия соответствующих лиц.
9. Персональные данные
9.1. Исполнитель обрабатывает персональные данные Заказчика в объёме, необходимом для заключения и исполнения договора, связи, оплаты, налогового учёта, соблюдения требований закона и защиты прав Сторон.
9.2. К персональным данным могут относиться: ФИО, контакты, сведения об оплате, сведения о записи на консультации, организационные заметки, а также иная информация, добровольно предоставленная Заказчиком.
9.3. Если для работы требуется обработка специальных категорий персональных данных или данных о состоянии здоровья, Исполнитель получает отдельное согласие, если такое согласие необходимо по закону.
9.4. Подробный порядок обработки персональных данных определяется Политикой обработки персональных данных Исполнителя и отдельным согласием Заказчика, если оно оформляется.
9.5. Заказчик вправе запросить информацию об обработке своих персональных данных, уточнение, ограничение или прекращение обработки в случаях и порядке, предусмотренных законодательством РФ.
10. Безопасность и кризисные ситуации
10.1. Настоящий договор не заменяет экстренную, медицинскую, психиатрическую, юридическую, социальную или иную специализированную помощь.
10.2. При угрозе жизни или здоровью, насилии, риске причинения вреда себе или другим, резком ухудшении состояния Заказчику рекомендуется незамедлительно обращаться в экстренные службы, медицинскую организацию, к врачу, в кризисную службу или к доверенным людям рядом.
10.3. Исполнитель не обязан быть доступным круглосуточно, если Стороны письменно не согласовали отдельный формат кризисного сопровождения.
11. Материалы, задания и интеллектуальные права
11.1. Исполнитель может предоставлять Заказчику памятки, упражнения, рабочие листы, анкеты и иные материалы для личного использования в рамках консультационного процесса.
11.2. Переданные материалы нельзя публиковать, продавать, передавать третьим лицам, использовать в коммерческих целях или выдавать за собственные без письменного согласия Исполнителя, если иное не указано в самих материалах.
11.3. Выполнение домашних заданий, упражнений и рекомендаций является добровольным. Заказчик вправе обсуждать сложности, отказываться от неподходящих заданий и согласовывать альтернативы.
12. Ответственность сторон
12.1. Стороны несут ответственность за нарушение договора в соответствии с законодательством РФ.
12.2. Исполнитель отвечает за добросовестное оказание услуг, соблюдение согласованного формата, конфиденциальности и профессиональных границ, но не отвечает за самостоятельные решения Заказчика, действия третьих лиц и обстоятельства, находящиеся вне контроля Исполнителя.
12.3. Заказчик отвечает за достоверность предоставляемой информации, своевременную оплату, соблюдение правил связи, отмен, конфиденциальности и безопасного поведения на консультации.
12.4. Стороны освобождаются от ответственности за полное или частичное неисполнение обязательств, если оно вызвано обстоятельствами непреодолимой силы, техническими сбоями, действиями органов власти, авариями связи или иными обстоятельствами вне разумного контроля Сторон.
13. Срок действия, изменение и прекращение договора
13.1. Договор вступает в силу с момента подписания Сторонами / акцепта оферты / оплаты первой консультации и действует до полного исполнения обязательств.
13.2. Условия договора могут быть изменены по соглашению Сторон в письменной форме, включая обмен сообщениями по email, в личном кабинете или мессенджере, если можно установить отправителя и содержание договорённости.
13.3. Каждая Сторона вправе прекратить договор, уведомив другую Сторону. При прекращении договора Стороны производят взаиморасчёты за фактически оказанные услуги и согласованные расходы.
13.4. Информированное согласие, согласие на обработку персональных данных, политика обработки персональных данных, правила отмен и переносов, а при работе с несовершеннолетним — согласие законного представителя применяются вместе с договором. Если отдельный документ уточняет специальный вопрос, он действует в этой части; при расхождении с обязательными нормами законодательства РФ применяются обязательные нормы закона.
14. Разрешение споров
14.1. Стороны стремятся решать вопросы и претензии путём переговоров и письменного обмена позициями.
14.2. Претензия направляется по email или адресу, указанному в разделе реквизитов. Срок ответа на претензию — [10] календарных дней, если иной срок не установлен законом.
14.3. Если спор не урегулирован переговорами, он рассматривается в порядке, предусмотренном законодательством РФ.
15. Реквизиты и подписи сторон
Исполнитель
ФИО: [ФИО]
Статус: [самозанятый / ИП / организация]
ИНН: [номер]
Адрес: [адрес]
Email: [email]
Телефон: [телефон]
Подпись: ____________________ /[ФИО]/
Заказчик
ФИО: [ФИО]
Дата рождения: [при необходимости]
Email: [email]
Телефон: [телефон]
Подпись: ____________________ /[ФИО]/
Приложение 1. Краткие правила работы для клиента
Этот блок можно выдать клиенту вместе с договором или перенести в отдельную памятку.
приходить на консультацию вовремя и предупреждать о переносе заранее;
не записывать встречу без согласия психолога;
не передавать третьим лицам материалы консультации без согласования;
понимать, что психологическая консультация не заменяет врача, экстренную помощь или юридическую консультацию;
обсуждать с психологом любые сомнения по формату, темпу, границам и оплате;
при угрозе жизни или здоровью обращаться в экстренные службы и к людям рядом, а не ждать следующей консультации.
Приложение 2. Переменные для заполнения
Переменная
Что указать
[ФИО психолога]
полное имя исполнителя
[ИНН]
ИНН самозанятого / ИП / организации
[адрес]
почтовый адрес для юридически значимых сообщений
[email]
рабочая электронная почта
[телефон]
рабочий телефон или иной канал связи
[стоимость]
стоимость консультации или пакета
[длительность]
длительность консультации
[срок отмены]
например, 24 или 48 часов
[платформа]
сервис для онлайн-встреч
ai_marketolog_direct_api_specОткрыть и прочитать
Спецификация приложения AI Marketolog для заявки
на доступ к API Яндекс Директа
Приложение предназначено для автоматизации аналитики и управляемой оптимизации собственных
рекламных кампаний проекта Psiho-Zakon. На первом этапе приложение получает статистику и отчеты из
Яндекс Директа, сопоставляет их с Яндекс Метрикой и first-party событиями сайта, сохраняет данные в
локальное хранилище и формирует рекомендации для пользователя.
1. Данные владельца и проекта
Владелец / оператор Ермошин Михаил Сергеевич, ИНН 325003277378
Проект / бренд Psiho-Zakon
Сайт https://psiho-zakon.ru/
Логин в Директе для fokkie
проверки
Тип использования Прямой заказчик, автоматизация управления собственными рекламными
кампаниями
2. Технические данные
Язык программирования Python 3.14.3
Протокол JSON over HTTPS. SOAP не используется.
API Яндекс Директ API v5, Reports API. Формат отчета: TSV, запросы
отправляются JSON.
Библиотеки requests 2.34.2, Flask 3.1.3, DuckDB 1.5.5, openpyxl 3.1.5. Официальный SDK не
используется.
Хранилище Локальная SQLite база для настроек и токенов; DuckDB для аналитических
событий и отчетов.
Безопасность OAuth-токены хранятся локально в зашифрованном виде. Секреты и токены не
отображаются в интерфейсе.
3. Назначение приложения
- Автоматизировать регулярную работу по анализу и управлению собственными кампаниями в Яндекс
Директе.
- Получать отчеты по кампаниям, расходам, показам, кликам и конверсиям.
- Сопоставлять данные Директа с Метрикой, событиями сайта, лидами, покупками и выручкой.
- Находить слабые и сильные сегменты, рассчитывать CPA, CR, ROMI и формировать гипотезы
оптимизации.
- Готовить рекомендации по объявлениям, ставкам, бюджетам и посадочным страницам. Изменения
применяются только после подтверждения пользователя.
4. Основные функции
- Получение статистики и отчетов через Reports API.
- Аналитика кампаний, объявлений, посадочных страниц и конверсий.
- Планируемое управляемое изменение кампаний, объявлений и ставок после ручного подтверждения
пользователя.
- Импорт ручных CSV-отчетов Директа и дедупликация строк.
- Экспорт данных проекта в XLSX и ведение очереди гипотез/изменений.
5. Схема взаимодействия с API Директа
- Пользователь создает проект в локальном приложении и подключает аккаунт Яндекса через OAuth с
правом direct:api.
- Приложение отправляет HTTPS JSON-запросы к https://api.direct.yandex.com/json/v5/reports.
- В заголовках используется OAuth Bearer token и, при необходимости, Client-Login рекламного аккаунта.
- Отчеты запрашиваются вручную пользователем или по расписанию. Штатная частота - не чаще одного
раза в час, обычно один раз в день для свежей аналитики.
- Если API возвращает 201/202, приложение фиксирует статус pending и повторяет сбор позже. Ошибки API
сохраняются в журнале запусков и показываются пользователю.
- Полученные строки сохраняются как raw events и metric snapshots, после чего отдельные Python-процессы
выполняют расчет Direct, Metrika, Site, Attribution и All Project.
- На первом этапе приложение не выполняет автоматические массовые изменения без подтверждения. Все
рекомендации попадают в очередь, где пользователь выбирает: делать, ждать, не делать или
редактировать.
6. Новые возможности для пользователя
Пользователь получает единую CRM-панель маркетолога: в одном проекте видит расходы и клики Директа,
визиты Метрики, события сайта, лиды, покупки и выручку. Приложение помогает быстрее находить
неэффективные кампании, посадочные страницы с проблемами, точки роста и пробелы данных.
Рекомендации сопровождаются расчетами, ожидаемым эффектом, риском и метрикой проверки.
7. Методы API Директа
На текущем этапе приложение использует чтение статистики через Reports API. Методы изменения
объектов будут включены только после одобрения доступа и только в режиме ручного подтверждения
пользователем.
Сервис / метод Назначение Когда вызывается
Reports API: POST Получение статистики по кампаниям: Date, Ручной сбор пользователем или
/json/v5/reports, ReportType CA CampaignId, CampaignName, Impressions, Clicks, плановый сбор по проекту.
MPAIGN_PERFORMANCE_REP Cost, Conversions.
ORT
Campaigns.get Получение списка кампаний, статусов, базовых После сбора статистики, перед
параметров и сопоставление CampaignId с анализом и перед применением
данными отчетов. подтвержденных изменений.
AdGroups.get Получение структуры групп объявлений для Перед построением рекомендаций
кампаний проекта. по группам и посадочным
страницам.
Ads.get Получение объявлений, текстов, ссылок, Перед рекомендациями по
статусов и связки с группами. переписыванию объявлений и перед
подтвержденным изменением.
Keywords.get Получение ключевых фраз и автотаргетингов, Перед рекомендациями по отключен
связанных с группами. ию/возобновлению/изменению фраз.
KeywordBids.get Получение текущих ставок и данных, полезных Перед расчетом предложений по
для подбора ставок. ставкам.
Campaigns.update / suspend / Изменение ограниченных параметров кампаний, Только после ручного
resume остановка или возобновление кампаний. подтверждения в очереди
изменений.
Ads.update / suspend / resume Изменение текстов/ссылок объявлений, Только после ручного
остановка или возобновление объявлений. подтверждения и предварительной
проверки текущего состояния.
Keywords.update / suspend / Изменение, остановка или возобновление Только после ручного
resume ключевых фраз. подтверждения пользователя.
KeywordBids.set / setAuto Назначение ставок или включение Только после ручного
автоматического назначения ставок там, где это подтверждения и проверки
допустимо стратегией. стратегии кампании.
Методы удаления, архивирования, финансовые методы и AgencyClients на текущем этапе не
используются. Для прямого рекламодателя используется Client-Login fokkie.
8. Последовательность вызовов
- Сбор статистики: Reports API CAMPAIGN_PERFORMANCE_REPORT -> сохранение raw events и metric
snapshots -> расчет Direct/Metrika/Site/Attribution.
- Подготовка рекомендаций: Campaigns.get -> AdGroups.get -> Ads.get -> Keywords.get -> KeywordBids.get ->
локальный расчет CPA/CR/ROMI -> создание гипотез в интерфейсе.
- Применение изменения: пользователь выбирает действие в очереди -> приложение повторно читает
текущее состояние через соответствующий get-метод -> выполняет только нужный
update/suspend/resume/set -> сохраняет результат -> делает контрольный get/Reports-запрос.
- Если данных недостаточно или есть конфликт текущего состояния, изменение не отправляется в API, а
остается в статусе 'waiting' с причиной.
9. Частота вызовов
Метод Частота Ограничение в приложении
Reports API Обычно 1 раз в день; вручную не Один отчетный запрос по проекту одновременно;
чаще 1 раза в час на проект. при 201/202 используется retryIn.
Метод Частота Ограничение в приложении
Campaigns.get После сбора или перед Результат кэшируется локально до следующего
изменением; не чаще 1 раза в час. ручного обновления/расчета.
AdGroups.get, Ads.get, Перед анализом структуры; не Запрашиваются только кампании проекта, а не все
Keywords.get чаще 1 раза в час. доступные аккаунту данные.
KeywordBids.get Перед расчетом ставок; не чаще 1 Запрашиваются только ключевые фразы кампаний
раза в час. проекта.
update/suspend/resume/set Только по ручному действию Один пакет изменений за одно подтверждение;
пользователя. после отправки выполняется контрольная
проверка.
10. Обработка ошибок и ограничений API
- Каждый запрос логируется с временем, источником, статусом, текстом ошибки и RequestId при наличии.
- Если Reports API возвращает 201/202, приложение сохраняет статус pending и повторяет запрос только
после интервала из заголовка retryIn.
- Если приходит ошибка авторизации 53, пользователь видит требование обновить OAuth-доступ.
- Если приходит ошибка прав 54, 3000 или 3001, изменение не повторяется автоматически; пользователю
показывается причина и нужные права.
- Если приходит ошибка 58, приложение показывает, что заявка Direct API не завершена или не
подтверждена.
- Если приходит 152 'Недостаточно баллов', сбор/изменения ставятся на паузу до восстановления лимита;
повторные запросы не выполняются в цикле.
- При временных серверных ошибках 1000-1002 используется ограниченное повторение с увеличением
интервала; после нескольких неудач задача переводится в error.
- Приложение учитывает заголовок Units: сохраняет расход/остаток/суточный лимит и снижает частоту
запросов при малом остатке баллов.
- Массовые изменения разбиваются на небольшие пакеты, выполняются только после повторного чтения
текущего состояния и не запускаются параллельно для одного проекта.
11. Скриншоты интерфейса
Раздел данных: подключение источников, статус сборов, Direct warning, сквозная аналитика.
Раздел анализа: запуск анализа, расчетный центр, отдельные блоки Direct/Metrika/Site/Attribution.
Документ подготовлен для заявки на доступ к API Яндекс Директа.