modify

Edit site section parameters.

Request format

https://adfox.yandex.com/api/v1
  ? object=zone
  & action=modify
  & objectID=<integer>
  & [name=<string>]
  & [categoryID=<integer>]
  & [isAutoReferer=<integer>]
  & [templateTypeID=<integer>]
  & [template=<string>]
  & [templateExcluded=<string>]

`objectID`*	ID of the object that the action is performed on.
`name`	Object name. An entry can contain Russian and Latin letters, numbers, and any special characters.
`categoryID`	Category ID. Read also: Add a category. Get a list of categories.
`isAutoReferer`	Dynamic definition of a site section by referer. Each banner request contains information about the page address (referer) that the request comes from. If you enable this option, you can use the ad tag from the site level. The system will use the "referer" field in the request to automatically determine the site section that the request applies to. If you disable this option, you must use ad tags from the placement level. Acceptable values: `0`: Disable. `1`: Enable. Default value: `1`.
`templateTypeID`	Template type ID. To learn more about template types, see Referer templates. Acceptable values: `0`: Standard. `1`: POSIX.2. Default value: `0`.
`template`	Specify the page templates that will be used to check the received address in the banner request. Sample For the standard template: `٭site.com/index.php` For POSIX.2: `homer-simpson-tv\.blog4ever\.com\|forum\.rojadirecta\.org\|^hidan\.eklablog\.com.٭\|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$` An entry can contain Russian and Latin letters, numbers, and any special characters.
`templateExcluded`	Page templates that must not belong to this site section. Sample For the standard template: `http://٭site.com` Addresses that use this template: `http://site.com`, `http://example.site.com`. For POSIX.2: `homer-simpson-tv\.blog4ever\.com\|forum\.rojadirecta\.org\|^hidan\.eklablog\.com.٭\|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$` Addresses that use this template: `homer-simpson-tv.blog4ever.com` `http://homer-simpson-tv.blog4ever.com/?a=1212` `forum.rojadirecta.org` `https://www.forum.rojadirecta.org/?b=123` `hidan.eklablog.com/?b=123` `aniworld.spb.ru/123/adfox/s` An entry can contain Russian and Latin letters, numbers, and any special characters.

Response format

<response>
  <status>
    <code>{integer}</code>
  </status>
</response>

Response parameters

code

Request processing status. If the value is 0, the request was completed successfully. For the key, see Error handling.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=zone&action=modify&objectID=543&name=site.ru/news

Response:

<response>
  <status>
    <code>0</code>
  </status>
</response>

Other actions with the object

See more actions with the zone object:

Specify the page templates that will be used to check the received address in the banner request.

Sample

For the standard template:
```
٭site.com/index.php
```

For POSIX.2:

homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$

An entry can contain Russian and Latin letters, numbers, and any special characters.

Page templates that must not belong to this site section.

Sample

For the standard template:
```
http://٭site.com
```
Addresses that use this template: http://site.com, http://example.site.com.
For POSIX.2:
```
homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$
```
Addresses that use this template:
- homer-simpson-tv.blog4ever.com
- http://homer-simpson-tv.blog4ever.com/?a=1212
- forum.rojadirecta.org
- https://www.forum.rojadirecta.org/?b=123
- hidan.eklablog.com/?b=123
- aniworld.spb.ru/123/adfox/s

An entry can contain Russian and Latin letters, numbers, and any special characters.

Was the article helpful?

zone

Error handling