Используйте сопоставление полей, чтобы перевести каждый шаг рабочих процессов, связанных с партнерами, с 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) |
Примечания |
|---|---|---|
|
partner_account |
В Data Manager API нет отдельных полей для каждого типа связанного аккаунта.
Для всех типов аккаунтов задайте в поле partner_account значение ProductAccount, а в полях account_type и account_id укажите идентификатор связанного аккаунта.
|
product_link_id |
partner_link_id |
|
resource_name |
name |
В Google Ads API поле
В Data Manager API сочетание Подробную информацию вы найдете в разделах Названия ресурсов и Создание запроса. |
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 и настроить заголовки запросов для разных сценариев, можно найти в статье Как получить ссылки на партнеров.