---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_Upload.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/AdImage_Upload.md
  - href: ru/live/AdImage_Upload.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Upload
Выполняет асинхронную загрузку изображений по списку URL. Синхронный ответ содержит номера заданий на загрузку.
## Входные данные

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "AdImage",
   "param": {
      /* AdImageRequest */
      "Action": (string),
      "AdImageURLData": [
         {  /* AdImageURL */
            "Login": (string),
            "URL": (string),
            "Name": (string)
         }
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
|
**Требуется**
||

||
**Объект AdImageRequest**
||
||
`Action`
|
Выполняемая операция: Upload.
|
Да
||
||
`AdImageURLData`
|
Массив объектов `AdImageURL` (не более 10 000), содержащих информацию о загружаемых изображениях.
|
Да
||

||
**Объект AdImageURL**
||
||
`Login`
|
Логин клиента — владельца изображения.

Для рекламодателей параметр игнорируется.
|
Для агентств
||
||
`URL`
|
Ссылка на изображение.
|
Да
||
||
`Name`
|
Произвольное наименование (описание) изображения.
|
Да
||
|#

## Результирующие данные


{% note alert %}

Ошибка при создании задания на загрузку (постановке в очередь) одного из изображений не влечет отмену всей операции и не влияет на успешность создания заданий на загрузку остальных изображений.

{% endnote %}


Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": {
      /* AdImageResponse */
      "ActionsResult": [
         {  /* AdImageActionResult */
            "AdImageUploadTaskID": (int),
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ],
         }
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
||

||
**Объект AdImageResponse**
||
||
`ActionsResult`
|
Массив объектов `AdImageActionResult`. Каждый объект соответствует элементу входного массива `AdImageURLData` и содержит:

- в случае успешной постановки изображения в очередь — номер задания на загрузку;
- в случае ошибки — массив `Errors`.

Элементы массива следуют в том же порядке, что и объекты входного массива `AdImageURL`.
||

||
**Объект AdImageActionResult**
||
||
`AdImageUploadTaskID`
|
Номер созданного задания на загрузку. Номер можно использовать для проверки статуса загрузки с помощью операции [CheckUploadStatus](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AdImage_CheckUploadStatus.md).
||
||
`Errors`
|
Массив объектов `Error` — ошибок, возникших при постановке изображений в очередь на загрузку.
||

||
**Объект Error**
||
||
`FaultCode`
|
Код ошибки.
||
||
`FaultString`
|
Текст сообщения об ошибке.
||
||
`FaultDetail`
|
Подробное описание причины ошибки.
||
|#

## Примеры входных данных

# Python

```python
{
   'Action': 'Upload',
   'AdImageURLData': [
      {
         'Login': 'agrom',
         'URL': 'http://site.ru/files/image001.png',
         'Name': u'Слоны: новая коллекция'
      },
      {
         'Login': 'agrom',
         'URL': 'http://site.ru/files/image002.png',
         'Name': u'Слоны: сертификация и обслуживание'
      },
      {
         'Login': 'larry',
         'URL': 'http://example.net/files/pic.png',
         'Name': u'Сухари впрок'
      }
   ]
}
```

# PHP

```php
array(
   'Action' => 'Upload',
   'AdImageURLData' => array(
      array(
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image001.png',
         'Name' ='Слоны: новая коллекция'
      ),
      array(
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image002.png',
         'Name' ='Слоны: сертификация и обслуживание'
      ),
      array(
         'Login' => 'larry',
         'URL' => 'http://example.net/files/pic.png',
         'Name' ='Сухари впрок'
      )
   )
)
```

# Perl

```perl
{
   'Action' => 'Upload',
   'AdImageURLData' => [
      {
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image001.png',
         'Name' ='Слоны: новая коллекция'
      },
      {
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image002.png',
         'Name' ='Слоны: сертификация и обслуживание'
      },
      {
         'Login' => 'larry',
         'URL' => 'http://example.net/files/pic.png',
         'Name' ='Сухари впрок'
      },
   ]
}
```