Extension (AdExtension)

Only one type of extension is currently supported, the callout.

A callout contains additional text for the ad. For more information, see Callouts in the Help for Yandex.Direct.

You can assign up to 50 callouts to an ad. When the ad is displayed, it shows all the callouts that fit in a single line (66 characters). You can assign the same callout to multiple ads.

Servicing

Use the AdExtensions service for creating extensions.

Extensions can't be edited. If you need to change an extension for an ad, create a new extension and assign it to the ad, then unassign the previous extension.

To assign an extension to an ad or unassign one from an ad, use the Ads service. See Ad extensions.

You can delete an extension only if it is not assigned to any ads. To get a list of ads that a particular extension is assigned to, use the Ads service.

Status of an extension

The Status parameter reflects the result of reviewing the extension.

Status

Description

DRAFT

The extension has been created but has not yet been submitted for review.

MODERATION

The extension is under review.

ACCEPTED

The extension was accepted after review.

REJECTED

The extension was rejected after review.

UNKNOWN

The status is unknown. This value is used for backward compatibility and for displaying statuses that are not supported in this version of the API.

State of an extension

The State parameter reflects the current state of the extension.

Status

Description

ON

The extension can be displayed.

DELETED

The owner deleted the extension.

Note

The get method returns an extension in the DELETED state only if the States parameter is set to DELETED or the ID of this extension is specified in the Ids parameter. If the Ids and States parameters are both omitted, the method doesn't return extensions in the DELETED state.

UNKNOWN

The status is unknown. Used for providing backward compatibility and displaying states that are not supported in this version of the API.