Как создать или удалить ссылку на партнера

Ниже описано, как создать или удалить ресурс PartnerLink. Data Manager API поддерживает создание связей с партнерами для следующих типов аккаунтов:

• Аккаунты Google Рекламы
• Аккаунты партнеров или рекламодателей Дисплея и Видео 360
• Аккаунты Google Менеджера рекламы

Как добавить связь

Создайте объект PartnerLink, отправив запрос CreatePartnerLinkRequest.

Создайте тело запроса

Создайте ресурс PartnerLink. Ниже перечислены поля, которые можно задать.

owning_account

Идентификатор аккаунта рекламодателя, которому принадлежит связь. Задайте объект ProductAccount.

Задайте для параметра account_type значение AccountType аккаунта рекламодателя.

В качестве значения account_id укажите идентификатор аккаунта рекламодателя.

Инструкции по выбору идентификатора для каждого типа рекламодателя приведены в руководстве по целевым страницам и заголовкам.

partner_account

Идентификатор аккаунта партнера. Задайте объект ProductAccount.

Задайте для параметра account_type значение AccountType партнерского аккаунта. Например, если связь установлена между аккаунтом рекламодателя и аккаунтом партнера по обработке данных, укажите в этом поле значение DATA_PARTNER.

В качестве значения account_id укажите идентификатор партнерского аккаунта.

Создание запроса

Чтобы создать ссылку на партнера, создайте CreatePartnerLinkRequest.

1. Задайте для parent название ресурса аккаунта рекламодателя. Используйте следующий формат:

   accountTypes/{account_type}/accounts/{account}
   

2. Задайте для partner_link созданный вами ресурс PartnerLink.

3. Если ваши учетные данные относятся к аккаунту Google с доступом к родительскому аккаунту рекламодателя, например к управляющему аккаунту Google Рекламы или партнерскому аккаунту Дисплея и Видео 360, настройте заголовок login-account, как описано в разделе Настройка целевых аккаунтов и заголовков.

Ниже приведены примеры запросов в формате JSON для создания связи с аккаунтом партнера по обработке данных в разных типах аккаунтов рекламодателей.

Google Реклама

Открыть в API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

рекламодатель DV360

Открыть в API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Партнер DV360

Открыть в API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Google Менеджер рекламы;

Открыть в API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Отправка запроса

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

Если запрос выполнен успешно, ответ содержит созданный объект PartnerLink с заполненными полями id и name.

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

Как удалить связь

Чтобы удалить PartnerLink, отправьте запрос DeletePartnerLinkRequest, в котором для параметра name задано название ресурса. При необходимости задайте заголовки.