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

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

• Аккаунты Google Ads
• Партнерские аккаунты Display & Video 360 или рекламные аккаунты Display & Video 360

Создать ссылку

Создайте 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 Ads или партнерской учетной записи Display & Video 360, установите заголовок login-account как описано в разделе «Настройка целевых объектов и заголовков» .

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

Google Реклама

Открыть в API Explorer

{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

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

Открыть в API Explorer

{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Партнер DV360

Открыть в API Explorer

{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Отправить запрос

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

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

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

Удалить ссылку

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