Сопоставление полей

Используйте сопоставление полей, чтобы перевести каждый этап рабочих процессов партнерских ссылок с API Google Ads на API Data Manager:

Сопоставление полей объектов

Используйте таблицы соответствия, чтобы сопоставить ссылку на ProductLink в API Google Ads с ее PartnerLink в API Data Manager.

ProductLink (API Google Ads) PartnerLink (API менеджера данных) Примечания
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account В API Data Manager нет отдельных полей для каждого типа связанных учетных записей. Для всех типов учетных записей установите поле partner_account в значение ProductAccount , а поля account_type и account_id — для идентификации связанной учетной записи.
product_link_id partner_link_id
resource_name name

В Google Ads API параметр customer_id в resource_name объекта ProductLink указывает, какому аккаунту принадлежит существующая ссылка. При создании ProductLink вы указываете владельца ссылки, задавая параметр customer_id в запросе CreateProductLinkRequest .

В API Data Manager комбинация accountType и accountId объекта owning_account указывает, какой учетной записи принадлежит существующая ссылка. При создании PartnerLink вы указываете владельца ссылки, задавая name равным имени ресурса владельца.

Подробную информацию см. в разделах «Названия ресурсов» и «Создать запрос» .

type owning_account.account_type

Названия ресурсов

API Data Manager использует другой формат именования ресурсов, чем API Google Ads.

API Google Ads

В API Google Ads имя ресурса ProductLink имеет следующий формат:

customers/{customer_id}/productLinks/{product_link_id}

API менеджера данных

В API Data Manager имя ресурса PartnerLink имеет следующий формат:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

Сопоставление запросов на управление ссылками

Используйте сопоставление запросов в этом разделе для преобразования запросов на создание, удаление и получение партнерских ссылок.

Создать запрос

Ниже приведено сопоставление полей для преобразования запроса CreateProductLinkRequest в API Google Ads в его эквивалентный CreatePartnerLinkRequest в API Data Manager.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (API менеджера данных) Примечания
customer_id parent Установите значение, равное имени ресурса учетной записи рекламодателя, которому принадлежит данный ресурс.
product_link partner_link Установите значение для ресурса PartnerLink . См. сопоставление полей объекта .

Удалить запрос

Ниже приведено сопоставление полей для преобразования запроса RemoveProductLinkRequest в API Google Ads в его эквивалентный DeletePartnerLinkRequest в API Data Manager.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (API менеджера данных) Примечания
customer_id Аналогов нет. Поле name содержит информацию о владельце и партнере, поэтому это дополнительное поле не требуется.
resource_name name Укажите имя ресурса PartnerLink , который вы хотите удалить.
validate_only Аналогов нет.

сопоставление запросов на получение ссылок

Способ получения партнерских ссылок различается между API Google Ads и API Data Manager.

API Google Ads

Отправьте запрос SearchGoogleAdsRequest содержащий следующий query . Необязательное условие WHERE в запросе определяет, какие ресурсы следует вернуть. Условие SELECT в запросе определяет, какие поля следует заполнить в возвращаемых частичных ресурсах.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
API менеджера данных

Отправьте запрос SearchPartnerLinkRequest . Поле запроса filter (необязательное) определяет, какие ресурсы следует вернуть. Ответ содержит полные ресурсы со всеми заполненными полями.

Ниже приведено сопоставление полей для преобразования запроса SearchGoogleAdsRequest в API Google Ads в его эквивалентный SearchPartnerLinksRequest в API Data Manager.

SearchGoogleAdsRequest (API Google Ads) SearchPartnerLinksRequest (API менеджера данных) Примечания
customer_id parent Укажите имя ресурса учетной записи, для которой необходимо выполнить поиск.
page_size page_size
page_token page_token
query filter Установите filter , чтобы определить, какие ресурсы следует возвращать. API Data Manager возвращает полные ресурсы, поэтому эквивалента предложению SELECT нет.
search_settings Аналогов нет.
validate_only Аналогов нет.

Для получения дополнительной информации, включая инструкции по созданию filter запроса SearchPartnerLinksRequest и настройке заголовков запроса для различных сценариев, ознакомьтесь с разделом «Получение партнерских ссылок» .

Назад
Шаги по обновлению