Avito icon

Avito

Взаимодействие с API Авито для бизнеса

Actions29

Overview

This node integrates with the Avito API to manage autoload profiles, specifically allowing users to create or update autoload profile settings. Autoload profiles automate the process of uploading listings (ads) to Avito according to a defined schedule and feed data.

Typical use cases include:

  • Automating regular uploads of product or service listings to Avito.
  • Managing multiple feeds with different schedules and upload limits.
  • Receiving email reports about the status of these uploads.
  • Enforcing compliance by requiring agreement to Avito's autoload terms when creating new profiles.

For example, a user can set up an autoload profile that uploads up to 100 ads every weekday morning between 9 AM and 11 AM Moscow time, using a specified XML or CSV feed URL, and receive reports via email.

Properties

Name Meaning
Статус автозагрузки (включена/выключена) Whether to enable autoload (on/off). Enables or disables the autoload functionality for the profile.
Email Для Отчетов Email address where reports about the uploads will be sent. Example: user@example.com.
Данные Фидов JSON array of feed data objects, each containing:
- feed_name: name of the feed for reporting
- feed_url: URL to the XML or CSV file (http/https)
Can be set to null to clear existing feed settings.
Расписание Выгрузок JSON array defining the upload schedule. Each object includes:
- rate: number of ads per period
- weekdays: array of weekdays (0=Monday, 6=Sunday)
- time_slots: array of hours (0-23) in Moscow time when uploads run.
Согласие с Правилами Автозагрузки Boolean indicating acceptance of Avito autoload terms. Mandatory when creating a new profile. Link to rules: https://support.avito.ru/articles/203867776

Output

The node outputs JSON data representing the result of the create or update operation on the autoload profile. This typically includes confirmation of the updated settings or error information if the operation failed.

No binary data output is indicated.

Dependencies

  • Requires an API authentication token or OAuth2 credential configured in n8n to access the Avito API.
  • The node depends on Avito's API endpoints for managing autoload profiles.
  • Network access to Avito services and URLs specified in feed data is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing required fields such as email or feed data may cause errors.
    • Not agreeing to the autoload terms (agreement property) when creating a new profile will likely result in rejection.
    • Incorrectly formatted JSON for feeds or schedule can cause parsing errors.
    • Timezone misunderstandings: schedule times are in Moscow time; incorrect assumptions may lead to unexpected upload times.

  • Error messages:

    • "Unknown resource": indicates the resource parameter is not recognized; ensure "autoload" is selected.
    • Validation errors related to required properties or JSON structure.
    • API authentication failures if credentials are missing or invalid.

  • Resolutions:

    • Double-check all required inputs are provided and correctly formatted.
    • Confirm acceptance of autoload terms when creating new profiles.
    • Verify API credentials and network connectivity.
    • Use the provided examples for feed and schedule JSON structures.

Links and References

  • Avito Autoload Rules — official documentation on autoload terms and conditions.
  • Examples of schedule JSON:
    [
  {"rate": 100, "weekdays": [0,1,2,3,4], "time_slots": [9,10,11]},
  {"rate": 50, "weekdays": [0,1,2,3,4,5,6], "time_slots": [0]},
  {"rate": 200, "weekdays": [5,6], "time_slots": [12,13,14,15,16]}
]
  • Feed data example:
    [
  {"feed_name": "Основной фид", "feed_url": "https://example.com/feed.xml"}
]

Discussion