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

Вот как создать или удалить ресурс 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 идентификатор партнерского аккаунта.

Как создать запрос

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

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

   accountTypes/{account_type}/accounts/{account}
   

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

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

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

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

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

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

{
    "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 установленным на название ресурса. При необходимости настройте заголовки.