Эта страница переведена с помощью Cloud Translation API.

REST Resource: sellers.adUnits

Ресурс: АдЮнит
- JSON-представление
Адюнитаттрибуте
АдЮнитстате
ВнеДомаМесто проведения
Методы

Ресурс: АдЮнит

Один рекламный блок.

JSON-представление

JSON-представление
{ "name": string, "externalId": string, "displayName": string, "description": string, "labels": { string: string, ... }, "attributes": [ enum (`AdUnitAttribute`) ], "creatives": [ { object (`CreativeSpecification`) } ], "createTime": string, "updateTime": string, "state": enum (`AdUnitState`), "rejectedReason": string, "location": { object (`LatLng`) }, "directionSet": boolean, "direction": integer, "elevationMetersSet": boolean, "elevationMeters": number, "physicalWidthMetersSet": boolean, "physicalWidthMeters": number, "physicalHeightMetersSet": boolean, "physicalHeightMeters": number, "venue": enum (`OutOfHomeVenue`), "fixedLocation": boolean, "indoors": boolean, "photoUris": [ string ], "products": [ string ] }

{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "photoUris": [
    string
  ],
  "products": [
    string
  ]
}

Поля
`name`	`string` Имя ресурса рекламного блока в формате: `sellers/{seller}/adUnits/{adUnit}` . Например, `sellers/seller321/adUnits/adUnit123` .
`externalId`	`string` Идентификатор, управляемый продавцом, предположительно в его собственной системе. Однажды установленный вряд ли изменится.
`displayName`	`string` Необходимый. Отображаемое название рекламного блока. Должен быть в кодировке UTF-8 с максимальным размером 240 байт.
`description`	`string` Дополнительное поле произвольной формы для описания рекламного блока.
`labels`	`map (key: string, value: string)` Набор ярлыков произвольной формы для описания этого рекламного блока. Объект, содержащий список пар `"key": value` . Пример: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`attributes[]`	`enum ( AdUnitAttribute )` Атрибуты для дальнейшего определения этого рекламного блока.
`creatives[]`	`object ( CreativeSpecification )` Список разрешенных креативов, которые можно показывать в этом рекламном блоке. Это также можно определить на уровне продукта.
`createTime`	`string ( Timestamp format)` Только вывод. Временная метка создания рекламного блока. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: `"2014-10-02T15:01:23Z"` и `"2014-10-02T15:01:23.045123456Z"` .
`updateTime`	`string ( Timestamp format)` Только вывод. Временная метка последнего обновления рекламного блока. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: `"2014-10-02T15:01:23Z"` и `"2014-10-02T15:01:23.045123456Z"` .
`state`	`enum ( AdUnitState )` Только вывод. Состояние рекламного блока. Если AD_UNIT_STATE_REJECTED отклоненная причина будет содержать причину.
`rejectedReason`	`string` Только вывод. Если статус утверждения равен AD_UNIT_APPROVAL_STATUS_REJECTED, это поле будет содержать причину.
`location`	`object ( LatLng )` Необходимый. Неизменяемый. Широта и долгота рекламного блока в формате знаковых градусов.
`directionSet`	`boolean` Если это правда, поле направления будет содержать значение направления. Если false, направление должно быть нулевым.
`direction`	`integer` Неизменяемый. Кардинальное направление в градусах, где север соответствует 0. [0–360).
`elevationMetersSet`	`boolean` Если это правда, поле высоты будет содержать высоту в метрах. Если значение false, высота должна быть равна нулю.
`elevationMeters`	`number` Неизменяемый. Расстояние от нижней части рекламного блока до земли в метрах.
`physicalWidthMetersSet`	`boolean` Если это правда, поле PhysicalWidthMeters будет содержать физическую ширину в метрах. Если значение false, PhysicalWidthMeters должен быть равен нулю.
`physicalWidthMeters`	`number` Неизменяемый. Физическая ширина рекламного блока в метрах.
`physicalHeightMetersSet`	`boolean` Если это правда, поле PhysicalHeightMeters будет содержать физическую высоту в метрах. Если значение false, PhysicalHeightMeters должен быть равен нулю.
`physicalHeightMeters`	`number` Неизменяемый. Физическая высота рекламного блока в метрах.
`venue`	`enum ( OutOfHomeVenue )` Тип заведения вне дома, основанный на стандартах DPAA. Это информационное поле, которое может быть представлено рекламодателям, а также использовано для фильтрации рекламных блоков.
`fixedLocation`	`boolean` Независимо от того, находится ли реклама в фиксированном месте (рекламный щит) или в движении (такси).
`indoors`	`boolean` Необходимый. Находится ли рекламный блок в помещении.
`photoUris[]`	`string` URI фотографий рекламного блока.
`products[]`	`string` Необходимый. Названия ресурсов продуктов, связанных с этим рекламным блоком, в формате: `sellers/{seller}/products/{product}` . Например, `sellers/seller111/products/product123` .

Адюнитаттрибуте

Возможные атрибуты, используемые для дальнейшего определения рекламного блока.

Перечисления
`AD_UNIT_ATTRIBUTE_UNSPECIFIED`	Значение по умолчанию, если атрибут рекламного блока не указан или неизвестен в этой версии.
`AD_UNIT_ATTRIBUTE_ILLUMINATED`	Виден ли рекламный блок в темноте, если он находится в физическом мире?
`AD_UNIT_ATTRIBUTE_DIGITAL`	Цифровой рекламный блок, если не включен в него классический физический, подразумевается.
`AD_UNIT_ATTRIBUTE_PHYSICAL`	Рекламный блок существует как объект в физическом мире.

АдЮнитстате

Состояние рекламного блока с точки зрения продавца.

Перечисления
`AD_UNIT_STATE_UNSPECIFIED`	Значение по умолчанию, если состояние рекламного блока не указано или неизвестно в этой версии.
`AD_UNIT_STATE_PENDING`	Рекламный блок ожидает одобрения.
`AD_UNIT_STATE_APPROVED`	Рекламный блок одобрен.
`AD_UNIT_STATE_REJECTED`	Рекламный блок отклонен.
`AD_UNIT_STATE_DELETED`	Рекламный блок удален.

ВнеДомаМесто проведения

Список типов заведений вне дома, основанный на стандартах DPAA.

Перечисления
`OOH_VENUE_UNSPECIFIED`	Значение по умолчанию, если место проведения наружной рекламы не указано или неизвестно в этой версии.
`OOH_VENUE_AIRBORNE`	Выездное мероприятие отнесено к категории воздушных.
`OOH_VENUE_AIRPORTS_GENERAL`	Вне дома место проведения относится к категории общих для аэропортов.
`OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM`	Заведение вне дома относится к категории выдачи багажа в аэропортах.
`OOH_VENUE_AIRPORTS_TERMINAL`	Выездное заведение отнесено к категории терминалов аэропортов.
`OOH_VENUE_AIRPORTS_LOUNGES`	Заведения вне дома, отнесенные к категории залов ожидания в аэропортах.
`OOH_VENUE_ATMS`	Выездные заведения, отнесенные к категории банкоматов.
`OOH_VENUE_BACKLIGHTS`	Вне дома место проведения классифицируется как подсветка.
`OOH_VENUE_BARS`	Выездные заведения, отнесенные к категории бары.
`OOH_VENUE_BENCHES`	Места вне дома, отнесенные к категории скамейки.
`OOH_VENUE_BIKE_RACKS`	Заведения на открытом воздухе, отнесенные к категории велосипедных стоянок.
`OOH_VENUE_BULLETINS`	Мероприятия вне дома относятся к категории бюллетеней.
`OOH_VENUE_BUSES`	Выездные заведения отнесены к категории Автобусы.
`OOH_VENUE_CAFES`	Выездные заведения, отнесенные к категории кафе.
`OOH_VENUE_CASUAL_DINING_RESTAURANTS`	Заведение, отнесенное к категории ресторанов с непринужденной атмосферой.
`OOH_VENUE_CHILD_CARE`	Выездное мероприятие, отнесенное к категории присмотра за детьми.
`OOH_VENUE_CINEMA`	Выездное заведение отнесено к категории кинотеатр.
`OOH_VENUE_CITY_INFORMATION_PANELS`	Выездное мероприятие отнесено к категории городских информационных панелей.
`OOH_VENUE_CONVENIENCE_STORES`	Выездные магазины отнесены к категории магазины повседневного спроса.
`OOH_VENUE_DEDICATED_WILD_POSTING`	Выездное мероприятие отнесено к категории специализированных диких публикаций.
`OOH_VENUE_DOCTORS_OFFICES_GENERAL`	Заведение вне дома отнесено к категории общих врачебных кабинетов.
`OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS`	Выездные учреждения отнесены к категории врачебных кабинетов акушерства.
`OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS`	Выездные учреждения отнесены к категории врачей педиатрии.
`OOH_VENUE_FAMILY_ENTERTAINMENT`	Выездное заведение относится к категории семейных развлечений.
`OOH_VENUE_FERRIES`	Выездные заведения отнесены к категориипаромы.
`OOH_VENUE_FINANCIAL_SERVICES`	Выездное мероприятие отнесено к категории финансовых услуг.
`OOH_VENUE_GAS_STATIONS`	Выездные заведения, отнесенные к категории заправочных станций.
`OOH_VENUE_GOLF_COURSES`	Заведение на открытом воздухе, отнесенное к категории полей для гольфа.
`OOH_VENUE_GYMS`	Выездные заведения, отнесенные к категории тренажерные залы.
`OOH_VENUE_HOSPITALS`	Места вне дома, отнесенные к категории больниц.
`OOH_VENUE_HOTELS`	Выездные заведения, отнесенные к категории отелей.
`OOH_VENUE_JUNIOR_POSTERS`	Выездное мероприятие отнесено к категории детских плакатов.
`OOH_VENUE_KIOSKS`	Выездные заведения, отнесенные к категории киосков.
`OOH_VENUE_MALLS_GENERAL`	Выездные заведения относятся к категории торговых центров.
`OOH_VENUE_MALLS_FOOD_COURTS`	Выездные заведения, отнесенные к категории фуд-кортов в торговых центрах.
`OOH_VENUE_MARINE`	Выездное заведение отнесено к категории морских.
`OOH_VENUE_MOBILE_BILLBOARDS`	Выездное мероприятие отнесено к категории мобильных рекламных щитов.
`OOH_VENUE_MOVIE_THEATER_LOBBIES`	Выездные заведения, отнесенные к категории вестибюлей кинотеатров.
`OOH_VENUE_NEWSSTANDS`	Выездные заведения, отнесенные к категории газетных киосков.
`OOH_VENUE_OFFICE_BUILDINGS`	Выездные объекты, отнесенные к категории офисных зданий.
`OOH_VENUE_PHONE_KIOSKS`	Выездные заведения, отнесенные к категории "телефонные киоски".
`OOH_VENUE_POSTERS`	Выездное мероприятие отнесено к категории плакатов.
`OOH_VENUE_QSR`	Выездное заведение отнесено к категории qsr.
`OOH_VENUE_RAIL`	Выездное заведение отнесено к категории железнодорожных.
`OOH_VENUE_RECEPTACLES`	Места вне дома, отнесенные к категории розеток.
`OOH_VENUE_RESORTS`	Выездные заведения, отнесенные к категории курортов.
`OOH_VENUE_RETAIL`	Выездное заведение отнесено к категории розничных.
`OOH_VENUE_SALONS`	Выездные заведения, отнесенные к категории салонов.
`OOH_VENUE_SHELTERS`	Места вне дома, отнесенные к категории приютов.
`OOH_VENUE_SPORTS_ARENAS`	Выездные площадки, отнесенные к категории спортивных арен.
`OOH_VENUE_SUBWAY`	Выездное заведение отнесено к категории метро.
`OOH_VENUE_TAXIS`	Выездные заведения, отнесенные к категории такси.
`OOH_VENUE_TRUCKSIDE`	Выездное заведение отнесено к категории «пригород».
`OOH_VENUE_UNIVERSITIES`	Выездные заведения, отнесенные к категории университетов.
`OOH_VENUE_URBAN_PANELS`	Выездные площадки отнесены к категории городских групп.
`OOH_VENUE_VETERINARIAN_OFFICES`	Выездные учреждения, отнесенные к категории ветеринарных кабинетов.
`OOH_VENUE_WALLS`	Вне дома место проведения классифицируется как стены.
`OOH_VENUE_OTHER`	Выездное заведение отнесено к категории «прочие».

Методы
`create`	Создает новый рекламный блок.
`delete`	Удаляет существующий рекламный блок.
`get`	Получает отдельный рекламный блок.
`list`	Перечисляет рекламные блоки.
`patch`	Обновляет существующий рекламный блок.

REST Resource: sellers.adUnits

Ресурс: АдЮнит

Адюнитаттрибуте

АдЮнитстате

ВнеДомаМесто проведения

Методы

`create`

`delete`

`get`

`list`

`patch`

REST Resource: sellers.adUnits Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Ресурс: АдЮнит

Адюнитаттрибуте

АдЮнитстате

ВнеДомаМесто проведения

Методы

create

delete

get

list

patch

REST Resource: sellers.adUnits

`create`

`delete`

`get`

`list`

`patch`