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

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

Аутентификация

Для Data Manager API требуются учетные данные с другой областью действия, чем для Google Ads API. Вам нужно создать новые учетные данные, включающие область действия Data Manager API для управления связями с партнерами.

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

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

ProductLink (Google Ads API) PartnerLink (Data Manager API) Примечания
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
partner_account В Data Manager API нет отдельных полей для каждого типа связанного аккаунта. Для всех типов аккаунтов задайте в поле 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.

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

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

type owning_account.account_type

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

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

Google Ads API

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

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

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

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

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

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

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

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

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

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

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

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

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

Способ получения партнерских ссылок зависит от того, какой API вы используете – Google Ads API или Data Manager API.

Google Ads API

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

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

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

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

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

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