REST Resource: customers.adsDataLinks

• Ресурс: AdsDataLink
  • Представление JSON
• Организация
  • Представление JSON
• Тип объекта
• Платформа
• Метрика
• GmpExportScope
• Методы

Ресурс: AdsDataLink

Представляет рекламную ссылку на данные.

Представление JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

Поля
name	string Имя, которое однозначно идентифицирует ресурс AdsDataLink. Он имеет форму customers/[customerId]/adsDataLinks/[resource_id]. Идентификатор ресурса генерируется сервером.
linkedEntity	object ( Entity ) Объект, связанный через этот AdsDataLink.
parentEntity	object ( Entity ) Связанная родительская сущность, если таковая имеется. Если связанный объект является кампанией Google Ads, это поле будет содержать соответствующего клиента Google Ads, которому принадлежит кампания.
childEntities[]	object ( Entity ) Связанные дочерние объекты, если таковые имеются. Если связанный объект является клиентом Google Рекламы, который соответствует ссылке «клиент-менеджер», то childEntities будет включать полностью расширенный набор клиентов Google Рекламы с данными, импортированными в Ads Data Hub по этой ссылке.
platform	enum ( Platform ) Рекламная платформа, связанная со связанным объектом.
customerLink	object ( CustomerLink ) Ссылка клиента, по которой можно получить доступ к связанным данным. Заполняются только имя, идентификатор клиента и отображаемое имя.
status	enum ( LinkStatus ) Статус канала передачи данных.
createTime	string ( Timestamp format) Время создания ссылки. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .
updateTime	string ( Timestamp format) Время последнего обновления статуса ссылки. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .
vendorClientId	string Идентификатор клиента поставщика, если есть.
metrics[]	enum ( Metric ) Метрики доступны через эту ссылку данных. Если поле пусто, ограничения по метрике не применяются. В настоящее время это поле является единственным и поддерживается только в том случае, если типом объекта ссылки является GOOGLE_ADS_CAMPAIGN или YT_RESERVE_LINE_ITEM .
gmpExportScopes[]	enum ( GmpExportScope ) Типы данных, которые будут экспортироваться для ссылок Дисплея и Видео 360. Заполняется только для платформы GOOGLE_MARKETING_PLATFORM . Если пусто, то не указано, и может быть доступна любая их комбинация.

Организация

Представляет рекламный объект, который можно связать с клиентом Ads Data Hub.

Представление JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Поля
entityId	string ( int64 format) Идентификатор объекта. Указанное здесь значение зависит от типа сущности.
displayName	string Отображаемое имя объекта.
type	enum ( EntityType ) Тип связанного объекта.

Тип объекта

Поддерживаемые рекламные объекты.

перечисления
ENTITY_TYPE_UNSPECIFIED	Неопределенный тип объекта.
GOOGLE_ADS_CUSTOMER	Клиент Google Ads. entityId соответствует Customer.id в Google Ads API.
GOOGLE_ADS_CAMPAIGN	Кампания Google Ads. entityId соответствует Campaign.id в Google Ads API.
GMP_CM_ACCOUNT	Аккаунт Менеджера кампаний 360. entityId соответствует Accounts.id в API Менеджера кампаний 360.
GMP_CM_FLOODLIGHT	Аккаунт Floodlight Менеджера кампаний 360. entityId соответствует FloodlightConfigurations.accountId в API Менеджера кампаний 360.
GMP_DV360_PARTNER	Идентификатор партнера Display & Video 360. entityId — это идентификатор партнера Display & Video 360.
GMP_DV360_ADVERTISER	Идентификатор рекламодателя Display & Video 360. entityId – это идентификатор рекламодателя Display & Video 360.
GMP_DV360_ORDER	Идентификатор заказа в Медийная и видеореклама 360. entityId – это идентификатор заказа Display & Video 360.
GMP_DV360_LINE_ITEM	Идентификатор позиции в Дисплее и Видео 360. entityId – это идентификатор позиции Display & Video 360.
YT_RESERVE_ORDER	Идентификатор заказа YouTube Reserve. entityId соответствует Order.id в Google Ad Manager API.
YT_RESERVE_LINE_ITEM	Позиция резервирования YouTube. entityId соответствует LineItem.id в Google Ad Manager API.
VENDOR_CLIENT_ID_REGISTRATION	Идентификатор клиента поставщика, который вручную регистрируется сторонним поставщиком рекламных технологий для предоставления сторонних измерений.
GOOGLE_AD_MANAGER_ORDER	Идентификатор заказа Google Ad Manager. entityId соответствует Order.id в Google Ad Manager API.
GOOGLE_AD_MANAGER_LINE_ITEM	Позиция Google Ad Manager. entityId соответствует LineItem.id в Google Ad Manager API.

Платформа

Поддерживаемые рекламные площадки.

перечисления
PLATFORM_UNSPECIFIED	Неизвестная платформа.
GOOGLE_ADS	Объект связан с Google Ads.
GOOGLE_MARKETING_PLATFORM	Объект связан с Google Платформа для маркетинга.
YOUTUBE_RESERVE	Объект связан с резервом YouTube.
GOOGLE_AD_MANAGER	Объект связан с Google Ad Manager.
FREEWHEEL	Объект связан с FreeWheel.

Метрика

Метрики, которые могут быть представлены через ссылки на рекламные данные.

перечисления
METRIC_UNSPECIFIED	Неопределенная метрика.
BRAND_LIFT	Метрика, соответствующая Brand Lift.
BRAND_SAFETY	Метрика, соответствующая безопасности бренда.
REACH	Метрика, соответствующая охвату, где клиент является рекламодателем.
VIEWABILITY	Метрика, соответствующая видимости, где клиент является рекламодателем.
PUBLISHER_REACH	Метрика, соответствующая охвату, где заказчик является издателем/поставщиком контента.
PUBLISHER_VIEWABILITY	Метрика, соответствующая видимости, где заказчик является издателем/поставщиком контента.

GmpExportScope

Различные типы данных, которые можно экспортировать по ссылкам GMP.

перечисления
GMP_EXPORT_SCOPE_UNSPECIFIED	Неопределенный объем.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Следует экспортировать данные Display & Video 360 YouTube TrueView.
GMP_EXPORT_SCOPE_DT	Следует экспортировать данные передачи данных.

Методы
batchApprove	Утвердить список ожидающих ссылок на данные объявлений.
batchReject	Отклонить список ожидающих ссылок на данные объявлений.
list	Список связей между указанным клиентом и другими рекламными объектами Google.